1// Protocol Buffers - Google's data interchange format
2// Copyright 2008 Google Inc. All rights reserved.
3// https://developers.google.com/protocol-buffers/
4//
5// Redistribution and use in source and binary forms, with or without
6// modification, are permitted provided that the following conditions are
7// met:
8//
9// * Redistributions of source code must retain the above copyright
10// notice, this list of conditions and the following disclaimer.
11// * Redistributions in binary form must reproduce the above
12// copyright notice, this list of conditions and the following disclaimer
13// in the documentation and/or other materials provided with the
14// distribution.
15// * Neither the name of Google Inc. nor the names of its
16// contributors may be used to endorse or promote products derived from
17// this software without specific prior written permission.
18//
19// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
31#ifndef GOOGLE_PROTOBUF_UTIL_INTERNAL_JSON_ESCAPING_H__
32#define GOOGLE_PROTOBUF_UTIL_INTERNAL_JSON_ESCAPING_H__
33
34#include <cstdint>
35
36#include <google/protobuf/stubs/common.h>
37#include <google/protobuf/stubs/bytestream.h>
38
39namespace google {
40namespace protobuf {
41namespace util {
42namespace converter {
43
44class JsonEscaping {
45 public:
46 // The minimum value of a unicode high-surrogate code unit in the utf-16
47 // encoding. A high-surrogate is also known as a leading-surrogate.
48 // See http://www.unicode.org/glossary/#high_surrogate_code_unit
49 static constexpr uint16_t kMinHighSurrogate = 0xd800;
50
51 // The maximum value of a unicide high-surrogate code unit in the utf-16
52 // encoding. A high-surrogate is also known as a leading-surrogate.
53 // See http://www.unicode.org/glossary/#high_surrogate_code_unit
54 static constexpr uint16_t kMaxHighSurrogate = 0xdbff;
55
56 // The minimum value of a unicode low-surrogate code unit in the utf-16
57 // encoding. A low-surrogate is also known as a trailing-surrogate.
58 // See http://www.unicode.org/glossary/#low_surrogate_code_unit
59 static constexpr uint16_t kMinLowSurrogate = 0xdc00;
60
61 // The maximum value of a unicode low-surrogate code unit in the utf-16
62 // encoding. A low-surrogate is also known as a trailing surrogate.
63 // See http://www.unicode.org/glossary/#low_surrogate_code_unit
64 static constexpr uint16_t kMaxLowSurrogate = 0xdfff;
65
66 // The minimum value of a unicode supplementary code point.
67 // See http://www.unicode.org/glossary/#supplementary_code_point
68 static constexpr uint32_t kMinSupplementaryCodePoint = 0x010000;
69
70 // The minimum value of a unicode code point.
71 // See http://www.unicode.org/glossary/#code_point
72 static constexpr uint32_t kMinCodePoint = 0x000000;
73
74 // The maximum value of a unicode code point.
75 // See http://www.unicode.org/glossary/#code_point
76 static constexpr uint32_t kMaxCodePoint = 0x10ffff;
77
78 JsonEscaping() {}
79 virtual ~JsonEscaping() {}
80
81 // Escape the given ByteSource to the given ByteSink.
82 static void Escape(strings::ByteSource* input, strings::ByteSink* output);
83
84 // Escape the given ByteSource to the given ByteSink.
85 // This is optimized for the case where the string is all printable 7-bit
86 // ASCII and does not contain a few other characters (such as quotes).
87 static void Escape(StringPiece input, strings::ByteSink* output);
88
89 private:
90 GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(JsonEscaping);
91};
92
93} // namespace converter
94} // namespace util
95} // namespace protobuf
96} // namespace google
97
98#endif // GOOGLE_PROTOBUF_UTIL_INTERNAL_JSON_ESCAPING_H__
99