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 <google/protobuf/stubs/common.h>
35 #include <google/protobuf/stubs/bytestream.h>
36 
37 namespace google {
38 namespace protobuf {
39 namespace util {
40 namespace converter {
41 
42 class JsonEscaping {
43  public:
44   // The minimum value of a unicode high-surrogate code unit in the utf-16
45   // encoding. A high-surrogate is also known as a leading-surrogate.
46   // See http://www.unicode.org/glossary/#high_surrogate_code_unit
47   static const uint16 kMinHighSurrogate = 0xd800;
48 
49   // The maximum value of a unicide high-surrogate code unit in the utf-16
50   // encoding. A high-surrogate is also known as a leading-surrogate.
51   // See http://www.unicode.org/glossary/#high_surrogate_code_unit
52   static const uint16 kMaxHighSurrogate = 0xdbff;
53 
54   // The minimum value of a unicode low-surrogate code unit in the utf-16
55   // encoding. A low-surrogate is also known as a trailing-surrogate.
56   // See http://www.unicode.org/glossary/#low_surrogate_code_unit
57   static const uint16 kMinLowSurrogate = 0xdc00;
58 
59   // The maximum value of a unicode low-surrogate code unit in the utf-16
60   // encoding. A low-surrogate is also known as a trailing surrogate.
61   // See http://www.unicode.org/glossary/#low_surrogate_code_unit
62   static const uint16 kMaxLowSurrogate = 0xdfff;
63 
64   // The minimum value of a unicode supplementary code point.
65   // See http://www.unicode.org/glossary/#supplementary_code_point
66   static const uint32 kMinSupplementaryCodePoint = 0x010000;
67 
68   // The minimum value of a unicode code point.
69   // See http://www.unicode.org/glossary/#code_point
70   static const uint32 kMinCodePoint = 0x000000;
71 
72   // The maximum value of a unicode code point.
73   // See http://www.unicode.org/glossary/#code_point
74   static const uint32 kMaxCodePoint = 0x10ffff;
75 
JsonEscaping()76   JsonEscaping() {}
~JsonEscaping()77   virtual ~JsonEscaping() {}
78 
79   // Escape the given ByteSource to the given ByteSink.
80   static void Escape(strings::ByteSource* input, strings::ByteSink* output);
81 
82   // Escape the given ByteSource to the given ByteSink.
83   // This is optimized for the case where the string is all printable 7-bit
84   // ASCII and does not contain a few other characters (such as quotes).
85   static void Escape(StringPiece input, strings::ByteSink* output);
86 
87  private:
88   GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(JsonEscaping);
89 };
90 
91 }  // namespace converter
92 }  // namespace util
93 }  // namespace protobuf
94 }  // namespace google
95 
96 #endif  // GOOGLE_PROTOBUF_UTIL_INTERNAL__JSON_ESCAPING_H__
97