src/shared/utf8.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #pragma once
   4
   5 /***
   6   This file is part of systemd.
   7
   8   Copyright 2012 Lennart Poettering
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 ***/
  23
  24 #include <stdbool.h>
  25
  26 #include "macro.h"
  27
  28 #define UTF8_REPLACEMENT_CHARACTER "\xef\xbf\xbd"
  29
  30 const char *utf8_is_valid(const char *s) _pure_;
  31 char *ascii_is_valid(const char *s) _pure_;
  32
  33 bool utf8_is_printable_newline(const char* str, size_t length, bool newline) _pure_;
  34 #define utf8_is_printable(str, length) utf8_is_printable_newline(str, length, true)
  35
  36 char *utf8_escape_invalid(const char *s);
  37 char *utf8_escape_non_printable(const char *str);
  38
  39 size_t utf8_encode_unichar(char *out_utf8, uint32_t g);
  40 char *utf16_to_utf8(const void *s, size_t length);
  41
  42 int utf8_encoded_valid_unichar(const char *str);
  43 int utf8_encoded_to_unichar(const char *str);
  44
  45 static inline bool utf16_is_surrogate(uint16_t c) {
  46         return (0xd800 <= c && c <= 0xdfff);
  47 }
  48
  49 static inline bool utf16_is_trailing_surrogate(uint16_t c) {
  50         return (0xdc00 <= c && c <= 0xdfff);
  51 }
  52
  53 static inline uint32_t utf16_surrogate_pair_to_unichar(uint16_t lead, uint16_t trail) {
  54                 return ((lead - 0xd800) << 10) + (trail - 0xdc00) + 0x10000;
  55 }