librime: cpp17.h Source File

| librime 1.2 Rime Input Method Engine, the core library

cpp17.h
Go to the documentation of this file.
1// Copyright 2018 Nemanja Trifunovic
2
3/*
4Permission is hereby granted, free of charge, to any person or organization
5obtaining a copy of the software and accompanying documentation covered by
6this license (the "Software") to use, reproduce, display, distribute,
7execute, and transmit the Software, and to prepare derivative works of the
8Software, and to permit third-parties to whom the Software is furnished to
9do so, all subject to the following:
10
11The copyright notices in the Software and this entire statement, including
12the above license grant, this restriction and the following disclaimer,
13must be included in all copies of the Software, in whole or in part, and
14all derivative works of the Software, unless such copies or derivative
15works are solely in the form of machine-executable object code generated by
16a source language processor.
17
18THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
21SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
22FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
23ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
24DEALINGS IN THE SOFTWARE.
25*/
26
27
28#ifndef UTF8_FOR_CPP_7e906c01_03a3_4daf_b420_ea7ea952b3c9
29#define UTF8_FOR_CPP_7e906c01_03a3_4daf_b420_ea7ea952b3c9
30
31#include "checked.h"
32#include <string>
33
34namespace utf8
35{
36
37 inline void append(char32_t cp, std::string& s)
38 {
39 append(uint32_t(cp), std::back_inserter(s));
40 }
41
42 inline std::string utf16to8(std::u16string_view s)
43 {
44 std::string result;
45 utf16to8(s.begin(), s.end(), std::back_inserter(result));
46 return result;
47 }
48
49 inline std::u16string utf8to16(std::string_view s)
50 {
51 std::u16string result;
52 utf8to16(s.begin(), s.end(), std::back_inserter(result));
53 return result;
54 }
55
56 inline std::string utf32to8(std::u32string_view s)
57 {
58 std::string result;
59 utf32to8(s.begin(), s.end(), std::back_inserter(result));
60 return result;
61 }
62
63 inline std::u32string utf8to32(std::string_view s)
64 {
65 std::u32string result;
66 utf8to32(s.begin(), s.end(), std::back_inserter(result));
67 return result;
68 }
69
70 inline std::size_t find_invalid(std::string_view s)
71 {
72 std::string_view::const_iterator invalid = find_invalid(s.begin(), s.end());
73 return (invalid == s.end()) ? std::string_view::npos : static_cast<std::size_t>(invalid - s.begin());
74 }
75
76 inline bool is_valid(std::string_view s)
77 {
78 return is_valid(s.begin(), s.end());
79 }
80
81 inline std::string replace_invalid(std::string_view s, char32_t replacement)
82 {
83 std::string result;
84 replace_invalid(s.begin(), s.end(), std::back_inserter(result), replacement);
85 return result;
86 }
87
88 inline std::string replace_invalid(std::string_view s)
89 {
90 std::string result;
91 replace_invalid(s.begin(), s.end(), std::back_inserter(result));
92 return result;
93 }
94
95 inline bool starts_with_bom(std::string_view s)
96 {
97 return starts_with_bom(s.begin(), s.end());
98 }
99
100} // namespace utf8
101
102#endif // header guard
103
checked.h
utf8
Definition checked.h:35
utf8::replace_invalid
output_iterator replace_invalid(octet_iterator start, octet_iterator end, output_iterator out, uint32_t replacement)
Definition checked.h:83
utf8::append
octet_iterator append(uint32_t cp, octet_iterator result)
The library API - functions intended to be called by the users.
Definition checked.h:74
utf8::starts_with_bom
bool starts_with_bom(octet_iterator it, octet_iterator end)
Definition core.h:375
utf8::utf32to8
octet_iterator utf32to8(u32bit_iterator start, u32bit_iterator end, octet_iterator result)
Definition checked.h:231
utf8::utf8to16
u16bit_iterator utf8to16(octet_iterator start, octet_iterator end, u16bit_iterator result)
Definition checked.h:216
utf8::utf8to32
u32bit_iterator utf8to32(octet_iterator start, octet_iterator end, u32bit_iterator result)
Definition checked.h:240
utf8::uint32_t
unsigned int uint32_t
Definition core.h:57
utf8::utf16to8
octet_iterator utf16to8(u16bit_iterator start, u16bit_iterator end, octet_iterator result)
Definition checked.h:189
utf8::is_valid
bool is_valid(octet_iterator start, octet_iterator end)
Definition core.h:369
utf8::find_invalid
octet_iterator find_invalid(octet_iterator start, octet_iterator end)
Definition core.h:357