protobuf 2.8.0.beta9 → 2.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (204) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +0 -1
  3. data/{UPGRADING.md → CHANGES.md} +20 -12
  4. data/LICENSE.txt +14 -0
  5. data/README.md +60 -74
  6. data/bin/protoc-gen-ruby +26 -0
  7. data/bin/rprotoc +4 -58
  8. data/lib/protobuf.rb +15 -13
  9. data/lib/protobuf/code_generator.rb +41 -0
  10. data/lib/protobuf/descriptors/google/protobuf/compiler/plugin.pb.rb +51 -0
  11. data/lib/protobuf/descriptors/google/protobuf/descriptor.pb.rb +248 -0
  12. data/lib/protobuf/field/base_field.rb +0 -1
  13. data/lib/protobuf/field/bytes_field.rb +1 -1
  14. data/lib/protobuf/field/message_field.rb +2 -4
  15. data/lib/protobuf/field/varint_field.rb +4 -7
  16. data/lib/protobuf/generators/base.rb +71 -0
  17. data/lib/protobuf/generators/enum_generator.rb +31 -0
  18. data/lib/protobuf/generators/extension_generator.rb +28 -0
  19. data/lib/protobuf/generators/field_generator.rb +132 -0
  20. data/lib/protobuf/generators/file_generator.rb +140 -0
  21. data/lib/protobuf/generators/group_generator.rb +113 -0
  22. data/lib/protobuf/generators/message_generator.rb +99 -0
  23. data/lib/protobuf/generators/printable.rb +161 -0
  24. data/lib/protobuf/generators/service_generator.rb +27 -0
  25. data/lib/protobuf/lifecycle.rb +7 -3
  26. data/lib/protobuf/message.rb +51 -34
  27. data/lib/protobuf/rpc/connectors/common.rb +4 -6
  28. data/lib/protobuf/rpc/server.rb +1 -1
  29. data/lib/protobuf/rpc/servers/zmq/server.rb +2 -2
  30. data/lib/protobuf/rpc/servers/zmq/worker.rb +2 -2
  31. data/lib/protobuf/rpc/service.rb +3 -3
  32. data/lib/protobuf/rpc/service_directory.rb +24 -12
  33. data/lib/protobuf/version.rb +1 -1
  34. data/proto/google/protobuf/compiler/plugin.proto +147 -0
  35. data/proto/google/protobuf/descriptor.proto +620 -0
  36. data/protobuf.gemspec +12 -21
  37. data/spec/bin/protoc-gen-ruby_spec.rb +18 -0
  38. data/spec/data/data.bin +3 -0
  39. data/{test/data/unk.png → spec/data/types.bin} +0 -0
  40. data/spec/encoding/all_types_spec.rb +91 -0
  41. data/spec/encoding/extreme_values_spec.rb +0 -0
  42. data/spec/lib/protobuf/code_generator_spec.rb +60 -0
  43. data/spec/lib/protobuf/generators/base_spec.rb +87 -0
  44. data/spec/lib/protobuf/generators/enum_generator_spec.rb +45 -0
  45. data/spec/lib/protobuf/generators/extension_generator_spec.rb +43 -0
  46. data/spec/lib/protobuf/generators/field_generator_spec.rb +99 -0
  47. data/spec/lib/protobuf/generators/file_generator_spec.rb +29 -0
  48. data/spec/lib/protobuf/generators/message_generator_spec.rb +0 -0
  49. data/spec/lib/protobuf/generators/service_generator_spec.rb +43 -0
  50. data/spec/lib/protobuf/lifecycle_spec.rb +31 -1
  51. data/spec/lib/protobuf/logger_spec.rb +5 -0
  52. data/spec/lib/protobuf/message_spec.rb +22 -8
  53. data/spec/lib/protobuf/rpc/connectors/common_spec.rb +1 -1
  54. data/spec/lib/protobuf/rpc/service_directory_spec.rb +45 -7
  55. data/spec/lib/protobuf/rpc/service_spec.rb +3 -3
  56. data/spec/spec_helper.rb +15 -16
  57. data/spec/support/test/all_types.data.bin +0 -0
  58. data/spec/support/test/all_types.data.txt +119 -0
  59. data/spec/support/test/defaults.pb.rb +25 -0
  60. data/spec/support/test/defaults.proto +9 -0
  61. data/spec/support/test/enum.pb.rb +10 -8
  62. data/spec/support/test/extended.pb.rb +5 -3
  63. data/spec/support/test/extreme_values.data.bin +0 -0
  64. data/spec/support/test/google_unittest.pb.rb +543 -0
  65. data/spec/support/test/google_unittest.proto +713 -0
  66. data/spec/support/test/google_unittest_import.pb.rb +37 -0
  67. data/{ext/protobuf-2.4.1/src/google/protobuf/io/package_info.h → spec/support/test/google_unittest_import.proto} +27 -17
  68. data/spec/support/test/google_unittest_import_public.pb.rb +8 -0
  69. data/{ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream_inl.h → spec/support/test/google_unittest_import_public.proto} +5 -31
  70. data/spec/support/test/multi_field_extensions.pb.rb +29 -7
  71. data/spec/support/test/multi_field_extensions.proto +12 -2
  72. data/spec/support/test/resource.pb.rb +20 -16
  73. metadata +149 -236
  74. data/examples/addressbook.pb.rb +0 -55
  75. data/examples/addressbook.proto +0 -24
  76. data/examples/reading_a_message.rb +0 -32
  77. data/examples/writing_a_message.rb +0 -46
  78. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/code_generator.h +0 -142
  79. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/command_line_interface.h +0 -318
  80. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum.h +0 -99
  81. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum_field.h +0 -103
  82. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_extension.h +0 -85
  83. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_field.h +0 -167
  84. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_file.h +0 -98
  85. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_generator.h +0 -72
  86. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_helpers.h +0 -159
  87. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message.h +0 -170
  88. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message_field.h +0 -102
  89. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_primitive_field.h +0 -103
  90. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_service.h +0 -118
  91. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_string_field.h +0 -104
  92. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_test_bad_identifiers.pb.h +0 -2721
  93. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/importer.h +0 -303
  94. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum.h +0 -84
  95. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum_field.h +0 -121
  96. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_extension.h +0 -77
  97. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_field.h +0 -108
  98. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_file.h +0 -101
  99. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_generator.h +0 -72
  100. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_helpers.h +0 -213
  101. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message.h +0 -109
  102. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message_field.h +0 -134
  103. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_primitive_field.h +0 -121
  104. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_service.h +0 -113
  105. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_string_field.h +0 -120
  106. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/mock_code_generator.h +0 -113
  107. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/package_info.h +0 -64
  108. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/parser.h +0 -434
  109. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.h +0 -73
  110. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.pb.h +0 -790
  111. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/python/python_generator.h +0 -156
  112. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/subprocess.h +0 -108
  113. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/zip_writer.h +0 -93
  114. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.h +0 -1367
  115. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.pb.h +0 -5223
  116. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor_database.h +0 -366
  117. data/ext/protobuf-2.4.1/src/google/protobuf/dynamic_message.h +0 -136
  118. data/ext/protobuf-2.4.1/src/google/protobuf/extension_set.h +0 -904
  119. data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_reflection.h +0 -424
  120. data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_util.h +0 -82
  121. data/ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream.h +0 -1102
  122. data/ext/protobuf-2.4.1/src/google/protobuf/io/gzip_stream.h +0 -207
  123. data/ext/protobuf-2.4.1/src/google/protobuf/io/printer.h +0 -136
  124. data/ext/protobuf-2.4.1/src/google/protobuf/io/tokenizer.h +0 -313
  125. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream.h +0 -238
  126. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl.h +0 -357
  127. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl_lite.h +0 -340
  128. data/ext/protobuf-2.4.1/src/google/protobuf/message.h +0 -692
  129. data/ext/protobuf-2.4.1/src/google/protobuf/message_lite.h +0 -239
  130. data/ext/protobuf-2.4.1/src/google/protobuf/package_info.h +0 -64
  131. data/ext/protobuf-2.4.1/src/google/protobuf/reflection_ops.h +0 -80
  132. data/ext/protobuf-2.4.1/src/google/protobuf/repeated_field.h +0 -1295
  133. data/ext/protobuf-2.4.1/src/google/protobuf/service.h +0 -291
  134. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/common.h +0 -1211
  135. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/hash.h +0 -220
  136. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/map-util.h +0 -119
  137. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/once.h +0 -123
  138. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/stl_util-inl.h +0 -121
  139. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/strutil.h +0 -457
  140. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/substitute.h +0 -170
  141. data/ext/protobuf-2.4.1/src/google/protobuf/test_util.h +0 -174
  142. data/ext/protobuf-2.4.1/src/google/protobuf/test_util_lite.h +0 -101
  143. data/ext/protobuf-2.4.1/src/google/protobuf/testing/file.h +0 -83
  144. data/ext/protobuf-2.4.1/src/google/protobuf/testing/googletest.h +0 -98
  145. data/ext/protobuf-2.4.1/src/google/protobuf/text_format.h +0 -285
  146. data/ext/protobuf-2.4.1/src/google/protobuf/unittest.pb.h +0 -11915
  147. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_custom_options.pb.h +0 -2895
  148. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_embed_optimize_for.pb.h +0 -211
  149. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_empty.pb.h +0 -56
  150. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import.pb.h +0 -188
  151. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import_lite.pb.h +0 -151
  152. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite.pb.h +0 -4752
  153. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite_imports_nonlite.pb.h +0 -150
  154. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_mset.pb.h +0 -816
  155. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_no_generic_services.pb.h +0 -197
  156. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_optimize_for.pb.h +0 -403
  157. data/ext/protobuf-2.4.1/src/google/protobuf/unknown_field_set.h +0 -268
  158. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format.h +0 -304
  159. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite.h +0 -620
  160. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite_inl.h +0 -774
  161. data/ext/ruby_generator/Makefile +0 -10
  162. data/ext/ruby_generator/RubyGenerator.cpp +0 -544
  163. data/ext/ruby_generator/RubyGenerator.h +0 -206
  164. data/ext/ruby_generator/extconf.rb +0 -35
  165. data/test/data/data_source.py +0 -14
  166. data/test/data/types_source.py +0 -22
  167. data/test/proto/addressbook.pb.rb +0 -66
  168. data/test/proto/addressbook.proto +0 -33
  169. data/test/proto/addressbook_base.pb.rb +0 -58
  170. data/test/proto/addressbook_base.proto +0 -26
  171. data/test/proto/addressbook_ext.pb.rb +0 -20
  172. data/test/proto/addressbook_ext.proto +0 -6
  173. data/test/proto/collision.pb.rb +0 -17
  174. data/test/proto/collision.proto +0 -5
  175. data/test/proto/ext_collision.pb.rb +0 -24
  176. data/test/proto/ext_collision.proto +0 -8
  177. data/test/proto/ext_range.pb.rb +0 -22
  178. data/test/proto/ext_range.proto +0 -7
  179. data/test/proto/float_default.proto +0 -10
  180. data/test/proto/lowercase.pb.rb +0 -30
  181. data/test/proto/lowercase.proto +0 -9
  182. data/test/proto/merge.pb.rb +0 -39
  183. data/test/proto/merge.proto +0 -15
  184. data/test/proto/nested.pb.rb +0 -30
  185. data/test/proto/nested.proto +0 -9
  186. data/test/proto/optional_field.pb.rb +0 -35
  187. data/test/proto/optional_field.proto +0 -12
  188. data/test/proto/packed.pb.rb +0 -22
  189. data/test/proto/packed.proto +0 -6
  190. data/test/proto/rpc.proto +0 -6
  191. data/test/proto/types.pb.rb +0 -84
  192. data/test/proto/types.proto +0 -37
  193. data/test/test_addressbook.rb +0 -56
  194. data/test/test_enum_value.rb +0 -41
  195. data/test/test_extension.rb +0 -36
  196. data/test/test_lowercase.rb +0 -11
  197. data/test/test_message.rb +0 -128
  198. data/test/test_optional_field.rb +0 -103
  199. data/test/test_packed_field.rb +0 -40
  200. data/test/test_parse.rb +0 -15
  201. data/test/test_repeated_types.rb +0 -132
  202. data/test/test_serialize.rb +0 -61
  203. data/test/test_standard_message.rb +0 -96
  204. data/test/test_types.rb +0 -226
@@ -1,239 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // http://code.google.com/p/protobuf/
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
- // Authors: wink@google.com (Wink Saville),
32
- // kenton@google.com (Kenton Varda)
33
- // Based on original Protocol Buffers design by
34
- // Sanjay Ghemawat, Jeff Dean, and others.
35
- //
36
- // Defines MessageLite, the abstract interface implemented by all (lite
37
- // and non-lite) protocol message objects.
38
-
39
- #ifndef GOOGLE_PROTOBUF_MESSAGE_LITE_H__
40
- #define GOOGLE_PROTOBUF_MESSAGE_LITE_H__
41
-
42
- #include <google/protobuf/stubs/common.h>
43
- #include <google/protobuf/io/coded_stream.h>
44
-
45
- namespace google {
46
- namespace protobuf {
47
-
48
- // Interface to light weight protocol messages.
49
- //
50
- // This interface is implemented by all protocol message objects. Non-lite
51
- // messages additionally implement the Message interface, which is a
52
- // subclass of MessageLite. Use MessageLite instead when you only need
53
- // the subset of features which it supports -- namely, nothing that uses
54
- // descriptors or reflection. You can instruct the protocol compiler
55
- // to generate classes which implement only MessageLite, not the full
56
- // Message interface, by adding the following line to the .proto file:
57
- //
58
- // option optimize_for = LITE_RUNTIME;
59
- //
60
- // This is particularly useful on resource-constrained systems where
61
- // the full protocol buffers runtime library is too big.
62
- //
63
- // Note that on non-constrained systems (e.g. servers) when you need
64
- // to link in lots of protocol definitions, a better way to reduce
65
- // total code footprint is to use optimize_for = CODE_SIZE. This
66
- // will make the generated code smaller while still supporting all the
67
- // same features (at the expense of speed). optimize_for = LITE_RUNTIME
68
- // is best when you only have a small number of message types linked
69
- // into your binary, in which case the size of the protocol buffers
70
- // runtime itself is the biggest problem.
71
- class LIBPROTOBUF_EXPORT MessageLite {
72
- public:
73
- inline MessageLite() {}
74
- virtual ~MessageLite();
75
-
76
- // Basic Operations ------------------------------------------------
77
-
78
- // Get the name of this message type, e.g. "foo.bar.BazProto".
79
- virtual string GetTypeName() const = 0;
80
-
81
- // Construct a new instance of the same type. Ownership is passed to the
82
- // caller.
83
- virtual MessageLite* New() const = 0;
84
-
85
- // Clear all fields of the message and set them to their default values.
86
- // Clear() avoids freeing memory, assuming that any memory allocated
87
- // to hold parts of the message will be needed again to hold the next
88
- // message. If you actually want to free the memory used by a Message,
89
- // you must delete it.
90
- virtual void Clear() = 0;
91
-
92
- // Quickly check if all required fields have values set.
93
- virtual bool IsInitialized() const = 0;
94
-
95
- // This is not implemented for Lite messages -- it just returns "(cannot
96
- // determine missing fields for lite message)". However, it is implemented
97
- // for full messages. See message.h.
98
- virtual string InitializationErrorString() const;
99
-
100
- // If |other| is the exact same class as this, calls MergeFrom(). Otherwise,
101
- // results are undefined (probably crash).
102
- virtual void CheckTypeAndMergeFrom(const MessageLite& other) = 0;
103
-
104
- // Parsing ---------------------------------------------------------
105
- // Methods for parsing in protocol buffer format. Most of these are
106
- // just simple wrappers around MergeFromCodedStream().
107
-
108
- // Fill the message with a protocol buffer parsed from the given input
109
- // stream. Returns false on a read error or if the input is in the
110
- // wrong format.
111
- bool ParseFromCodedStream(io::CodedInputStream* input);
112
- // Like ParseFromCodedStream(), but accepts messages that are missing
113
- // required fields.
114
- bool ParsePartialFromCodedStream(io::CodedInputStream* input);
115
- // Read a protocol buffer from the given zero-copy input stream. If
116
- // successful, the entire input will be consumed.
117
- bool ParseFromZeroCopyStream(io::ZeroCopyInputStream* input);
118
- // Like ParseFromZeroCopyStream(), but accepts messages that are missing
119
- // required fields.
120
- bool ParsePartialFromZeroCopyStream(io::ZeroCopyInputStream* input);
121
- // Read a protocol buffer from the given zero-copy input stream, expecting
122
- // the message to be exactly "size" bytes long. If successful, exactly
123
- // this many bytes will have been consumed from the input.
124
- bool ParseFromBoundedZeroCopyStream(io::ZeroCopyInputStream* input, int size);
125
- // Like ParseFromBoundedZeroCopyStream(), but accepts messages that are
126
- // missing required fields.
127
- bool ParsePartialFromBoundedZeroCopyStream(io::ZeroCopyInputStream* input,
128
- int size);
129
- // Parse a protocol buffer contained in a string.
130
- bool ParseFromString(const string& data);
131
- // Like ParseFromString(), but accepts messages that are missing
132
- // required fields.
133
- bool ParsePartialFromString(const string& data);
134
- // Parse a protocol buffer contained in an array of bytes.
135
- bool ParseFromArray(const void* data, int size);
136
- // Like ParseFromArray(), but accepts messages that are missing
137
- // required fields.
138
- bool ParsePartialFromArray(const void* data, int size);
139
-
140
-
141
- // Reads a protocol buffer from the stream and merges it into this
142
- // Message. Singular fields read from the input overwrite what is
143
- // already in the Message and repeated fields are appended to those
144
- // already present.
145
- //
146
- // It is the responsibility of the caller to call input->LastTagWas()
147
- // (for groups) or input->ConsumedEntireMessage() (for non-groups) after
148
- // this returns to verify that the message's end was delimited correctly.
149
- //
150
- // ParsefromCodedStream() is implemented as Clear() followed by
151
- // MergeFromCodedStream().
152
- bool MergeFromCodedStream(io::CodedInputStream* input);
153
-
154
- // Like MergeFromCodedStream(), but succeeds even if required fields are
155
- // missing in the input.
156
- //
157
- // MergeFromCodedStream() is just implemented as MergePartialFromCodedStream()
158
- // followed by IsInitialized().
159
- virtual bool MergePartialFromCodedStream(io::CodedInputStream* input) = 0;
160
-
161
- // Serialization ---------------------------------------------------
162
- // Methods for serializing in protocol buffer format. Most of these
163
- // are just simple wrappers around ByteSize() and SerializeWithCachedSizes().
164
-
165
- // Write a protocol buffer of this message to the given output. Returns
166
- // false on a write error. If the message is missing required fields,
167
- // this may GOOGLE_CHECK-fail.
168
- bool SerializeToCodedStream(io::CodedOutputStream* output) const;
169
- // Like SerializeToCodedStream(), but allows missing required fields.
170
- bool SerializePartialToCodedStream(io::CodedOutputStream* output) const;
171
- // Write the message to the given zero-copy output stream. All required
172
- // fields must be set.
173
- bool SerializeToZeroCopyStream(io::ZeroCopyOutputStream* output) const;
174
- // Like SerializeToZeroCopyStream(), but allows missing required fields.
175
- bool SerializePartialToZeroCopyStream(io::ZeroCopyOutputStream* output) const;
176
- // Serialize the message and store it in the given string. All required
177
- // fields must be set.
178
- bool SerializeToString(string* output) const;
179
- // Like SerializeToString(), but allows missing required fields.
180
- bool SerializePartialToString(string* output) const;
181
- // Serialize the message and store it in the given byte array. All required
182
- // fields must be set.
183
- bool SerializeToArray(void* data, int size) const;
184
- // Like SerializeToArray(), but allows missing required fields.
185
- bool SerializePartialToArray(void* data, int size) const;
186
-
187
- // Make a string encoding the message. Is equivalent to calling
188
- // SerializeToString() on a string and using that. Returns the empty
189
- // string if SerializeToString() would have returned an error.
190
- // Note: If you intend to generate many such strings, you may
191
- // reduce heap fragmentation by instead re-using the same string
192
- // object with calls to SerializeToString().
193
- string SerializeAsString() const;
194
- // Like SerializeAsString(), but allows missing required fields.
195
- string SerializePartialAsString() const;
196
-
197
- // Like SerializeToString(), but appends to the data to the string's existing
198
- // contents. All required fields must be set.
199
- bool AppendToString(string* output) const;
200
- // Like AppendToString(), but allows missing required fields.
201
- bool AppendPartialToString(string* output) const;
202
-
203
- // Computes the serialized size of the message. This recursively calls
204
- // ByteSize() on all embedded messages. If a subclass does not override
205
- // this, it MUST override SetCachedSize().
206
- virtual int ByteSize() const = 0;
207
-
208
- // Serializes the message without recomputing the size. The message must
209
- // not have changed since the last call to ByteSize(); if it has, the results
210
- // are undefined.
211
- virtual void SerializeWithCachedSizes(
212
- io::CodedOutputStream* output) const = 0;
213
-
214
- // Like SerializeWithCachedSizes, but writes directly to *target, returning
215
- // a pointer to the byte immediately after the last byte written. "target"
216
- // must point at a byte array of at least ByteSize() bytes.
217
- virtual uint8* SerializeWithCachedSizesToArray(uint8* target) const;
218
-
219
- // Returns the result of the last call to ByteSize(). An embedded message's
220
- // size is needed both to serialize it (because embedded messages are
221
- // length-delimited) and to compute the outer message's size. Caching
222
- // the size avoids computing it multiple times.
223
- //
224
- // ByteSize() does not automatically use the cached size when available
225
- // because this would require invalidating it every time the message was
226
- // modified, which would be too hard and expensive. (E.g. if a deeply-nested
227
- // sub-message is changed, all of its parents' cached sizes would need to be
228
- // invalidated, which is too much work for an otherwise inlined setter
229
- // method.)
230
- virtual int GetCachedSize() const = 0;
231
-
232
- private:
233
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(MessageLite);
234
- };
235
-
236
- } // namespace protobuf
237
-
238
- } // namespace google
239
- #endif // GOOGLE_PROTOBUF_MESSAGE_LITE_H__
@@ -1,64 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // http://code.google.com/p/protobuf/
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
- // Author: kenton@google.com (Kenton Varda)
32
- // Based on original Protocol Buffers design by
33
- // Sanjay Ghemawat, Jeff Dean, and others.
34
- //
35
- // This file exists solely to document the google::protobuf namespace.
36
- // It is not compiled into anything, but it may be read by an automated
37
- // documentation generator.
38
-
39
- namespace google {
40
-
41
- // Core components of the Protocol Buffers runtime library.
42
- //
43
- // The files in this package represent the core of the Protocol Buffer
44
- // system. All of them are part of the libprotobuf library.
45
- //
46
- // A note on thread-safety:
47
- //
48
- // Thread-safety in the Protocol Buffer library follows a simple rule:
49
- // unless explicitly noted otherwise, it is always safe to use an object
50
- // from multiple threads simultaneously as long as the object is declared
51
- // const in all threads (or, it is only used in ways that would be allowed
52
- // if it were declared const). However, if an object is accessed in one
53
- // thread in a way that would not be allowed if it were const, then it is
54
- // not safe to access that object in any other thread simultaneously.
55
- //
56
- // Put simply, read-only access to an object can happen in multiple threads
57
- // simultaneously, but write access can only happen in a single thread at
58
- // a time.
59
- //
60
- // The implementation does contain some "const" methods which actually modify
61
- // the object behind the scenes -- e.g., to cache results -- but in these cases
62
- // mutex locking is used to make the access thread-safe.
63
- namespace protobuf {}
64
- } // namespace google
@@ -1,80 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // http://code.google.com/p/protobuf/
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
- // Author: kenton@google.com (Kenton Varda)
32
- // Based on original Protocol Buffers design by
33
- // Sanjay Ghemawat, Jeff Dean, and others.
34
- //
35
- // This header is logically internal, but is made public because it is used
36
- // from protocol-compiler-generated code, which may reside in other components.
37
-
38
- #ifndef GOOGLE_PROTOBUF_REFLECTION_OPS_H__
39
- #define GOOGLE_PROTOBUF_REFLECTION_OPS_H__
40
-
41
- #include <google/protobuf/message.h>
42
-
43
- namespace google {
44
- namespace protobuf {
45
- namespace internal {
46
-
47
- // Basic operations that can be performed using reflection.
48
- // These can be used as a cheap way to implement the corresponding
49
- // methods of the Message interface, though they are likely to be
50
- // slower than implementations tailored for the specific message type.
51
- //
52
- // This class should stay limited to operations needed to implement
53
- // the Message interface.
54
- //
55
- // This class is really a namespace that contains only static methods.
56
- class LIBPROTOBUF_EXPORT ReflectionOps {
57
- public:
58
- static void Copy(const Message& from, Message* to);
59
- static void Merge(const Message& from, Message* to);
60
- static void Clear(Message* message);
61
- static bool IsInitialized(const Message& message);
62
- static void DiscardUnknownFields(Message* message);
63
-
64
- // Finds all unset required fields in the message and adds their full
65
- // paths (e.g. "foo.bar[5].baz") to *names. "prefix" will be attached to
66
- // the front of each name.
67
- static void FindInitializationErrors(const Message& message,
68
- const string& prefix,
69
- vector<string>* errors);
70
-
71
- private:
72
- // All methods are static. No need to construct.
73
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(ReflectionOps);
74
- };
75
-
76
- } // namespace internal
77
- } // namespace protobuf
78
-
79
- } // namespace google
80
- #endif // GOOGLE_PROTOBUF_REFLECTION_OPS_H__
@@ -1,1295 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // http://code.google.com/p/protobuf/
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
- // Author: kenton@google.com (Kenton Varda)
32
- // Based on original Protocol Buffers design by
33
- // Sanjay Ghemawat, Jeff Dean, and others.
34
- //
35
- // RepeatedField and RepeatedPtrField are used by generated protocol message
36
- // classes to manipulate repeated fields. These classes are very similar to
37
- // STL's vector, but include a number of optimizations found to be useful
38
- // specifically in the case of Protocol Buffers. RepeatedPtrField is
39
- // particularly different from STL vector as it manages ownership of the
40
- // pointers that it contains.
41
- //
42
- // Typically, clients should not need to access RepeatedField objects directly,
43
- // but should instead use the accessor functions generated automatically by the
44
- // protocol compiler.
45
-
46
- #ifndef GOOGLE_PROTOBUF_REPEATED_FIELD_H__
47
- #define GOOGLE_PROTOBUF_REPEATED_FIELD_H__
48
-
49
- #include <string>
50
- #include <iterator>
51
- #include <google/protobuf/stubs/common.h>
52
- #include <google/protobuf/message_lite.h>
53
-
54
- namespace google {
55
-
56
- namespace protobuf {
57
-
58
- class Message;
59
-
60
- namespace internal {
61
-
62
- // We need this (from generated_message_reflection.cc).
63
- LIBPROTOBUF_EXPORT int StringSpaceUsedExcludingSelf(const string& str);
64
-
65
- } // namespace internal
66
-
67
- // RepeatedField is used to represent repeated fields of a primitive type (in
68
- // other words, everything except strings and nested Messages). Most users will
69
- // not ever use a RepeatedField directly; they will use the get-by-index,
70
- // set-by-index, and add accessors that are generated for all repeated fields.
71
- template <typename Element>
72
- class RepeatedField {
73
- public:
74
- RepeatedField();
75
- RepeatedField(const RepeatedField& other);
76
- ~RepeatedField();
77
-
78
- RepeatedField& operator=(const RepeatedField& other);
79
-
80
- int size() const;
81
-
82
- const Element& Get(int index) const;
83
- Element* Mutable(int index);
84
- void Set(int index, const Element& value);
85
- void Add(const Element& value);
86
- Element* Add();
87
- // Remove the last element in the array.
88
- // We don't provide a way to remove any element other than the last
89
- // because it invites inefficient use, such as O(n^2) filtering loops
90
- // that should have been O(n). If you want to remove an element other
91
- // than the last, the best way to do it is to re-arrange the elements
92
- // so that the one you want removed is at the end, then call RemoveLast().
93
- void RemoveLast();
94
- void Clear();
95
- void MergeFrom(const RepeatedField& other);
96
- void CopyFrom(const RepeatedField& other);
97
-
98
- // Reserve space to expand the field to at least the given size. If the
99
- // array is grown, it will always be at least doubled in size.
100
- void Reserve(int new_size);
101
-
102
- // Resize the RepeatedField to a new, smaller size. This is O(1).
103
- void Truncate(int new_size);
104
-
105
- void AddAlreadyReserved(const Element& value);
106
- Element* AddAlreadyReserved();
107
- int Capacity() const;
108
-
109
- // Gets the underlying array. This pointer is possibly invalidated by
110
- // any add or remove operation.
111
- Element* mutable_data();
112
- const Element* data() const;
113
-
114
- // Swap entire contents with "other".
115
- void Swap(RepeatedField* other);
116
-
117
- // Swap two elements.
118
- void SwapElements(int index1, int index2);
119
-
120
- // STL-like iterator support
121
- typedef Element* iterator;
122
- typedef const Element* const_iterator;
123
- typedef Element value_type;
124
-
125
- iterator begin();
126
- const_iterator begin() const;
127
- iterator end();
128
- const_iterator end() const;
129
-
130
- // Returns the number of bytes used by the repeated field, excluding
131
- // sizeof(*this)
132
- int SpaceUsedExcludingSelf() const;
133
-
134
- private:
135
- static const int kInitialSize = 4;
136
-
137
- Element* elements_;
138
- int current_size_;
139
- int total_size_;
140
-
141
- Element initial_space_[kInitialSize];
142
-
143
- // Move the contents of |from| into |to|, possibly clobbering |from| in the
144
- // process. For primitive types this is just a memcpy(), but it could be
145
- // specialized for non-primitive types to, say, swap each element instead.
146
- void MoveArray(Element to[], Element from[], int size);
147
-
148
- // Copy the elements of |from| into |to|.
149
- void CopyArray(Element to[], const Element from[], int size);
150
- };
151
-
152
- namespace internal {
153
- template <typename It> class RepeatedPtrIterator;
154
- template <typename It> class RepeatedPtrOverPtrsIterator;
155
- } // namespace internal
156
-
157
- namespace internal {
158
-
159
- // This is the common base class for RepeatedPtrFields. It deals only in void*
160
- // pointers. Users should not use this interface directly.
161
- //
162
- // The methods of this interface correspond to the methods of RepeatedPtrField,
163
- // but may have a template argument called TypeHandler. Its signature is:
164
- // class TypeHandler {
165
- // public:
166
- // typedef MyType Type;
167
- // static Type* New();
168
- // static void Delete(Type*);
169
- // static void Clear(Type*);
170
- // static void Merge(const Type& from, Type* to);
171
- //
172
- // // Only needs to be implemented if SpaceUsedExcludingSelf() is called.
173
- // static int SpaceUsed(const Type&);
174
- // };
175
- class LIBPROTOBUF_EXPORT RepeatedPtrFieldBase {
176
- protected:
177
- // The reflection implementation needs to call protected methods directly,
178
- // reinterpreting pointers as being to Message instead of a specific Message
179
- // subclass.
180
- friend class GeneratedMessageReflection;
181
-
182
- // ExtensionSet stores repeated message extensions as
183
- // RepeatedPtrField<MessageLite>, but non-lite ExtensionSets need to
184
- // implement SpaceUsed(), and thus need to call SpaceUsedExcludingSelf()
185
- // reinterpreting MessageLite as Message. ExtensionSet also needs to make
186
- // use of AddFromCleared(), which is not part of the public interface.
187
- friend class ExtensionSet;
188
-
189
- RepeatedPtrFieldBase();
190
-
191
- // Must be called from destructor.
192
- template <typename TypeHandler>
193
- void Destroy();
194
-
195
- int size() const;
196
-
197
- template <typename TypeHandler>
198
- const typename TypeHandler::Type& Get(int index) const;
199
- template <typename TypeHandler>
200
- typename TypeHandler::Type* Mutable(int index);
201
- template <typename TypeHandler>
202
- typename TypeHandler::Type* Add();
203
- template <typename TypeHandler>
204
- void RemoveLast();
205
- template <typename TypeHandler>
206
- void Clear();
207
- template <typename TypeHandler>
208
- void MergeFrom(const RepeatedPtrFieldBase& other);
209
- template <typename TypeHandler>
210
- void CopyFrom(const RepeatedPtrFieldBase& other);
211
-
212
- void Reserve(int new_size);
213
-
214
- int Capacity() const;
215
-
216
- // Used for constructing iterators.
217
- void* const* raw_data() const;
218
- void** raw_mutable_data() const;
219
-
220
- template <typename TypeHandler>
221
- typename TypeHandler::Type** mutable_data();
222
- template <typename TypeHandler>
223
- const typename TypeHandler::Type* const* data() const;
224
-
225
- void Swap(RepeatedPtrFieldBase* other);
226
-
227
- void SwapElements(int index1, int index2);
228
-
229
- template <typename TypeHandler>
230
- int SpaceUsedExcludingSelf() const;
231
-
232
-
233
- // Advanced memory management --------------------------------------
234
-
235
- // Like Add(), but if there are no cleared objects to use, returns NULL.
236
- template <typename TypeHandler>
237
- typename TypeHandler::Type* AddFromCleared();
238
-
239
- template <typename TypeHandler>
240
- void AddAllocated(typename TypeHandler::Type* value);
241
- template <typename TypeHandler>
242
- typename TypeHandler::Type* ReleaseLast();
243
-
244
- int ClearedCount() const;
245
- template <typename TypeHandler>
246
- void AddCleared(typename TypeHandler::Type* value);
247
- template <typename TypeHandler>
248
- typename TypeHandler::Type* ReleaseCleared();
249
-
250
- private:
251
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(RepeatedPtrFieldBase);
252
-
253
- static const int kInitialSize = 4;
254
-
255
- void** elements_;
256
- int current_size_;
257
- int allocated_size_;
258
- int total_size_;
259
-
260
- void* initial_space_[kInitialSize];
261
-
262
- template <typename TypeHandler>
263
- static inline typename TypeHandler::Type* cast(void* element) {
264
- return reinterpret_cast<typename TypeHandler::Type*>(element);
265
- }
266
- template <typename TypeHandler>
267
- static inline const typename TypeHandler::Type* cast(const void* element) {
268
- return reinterpret_cast<const typename TypeHandler::Type*>(element);
269
- }
270
- };
271
-
272
- template <typename GenericType>
273
- class GenericTypeHandler {
274
- public:
275
- typedef GenericType Type;
276
- static GenericType* New() { return new GenericType; }
277
- static void Delete(GenericType* value) { delete value; }
278
- static void Clear(GenericType* value) { value->Clear(); }
279
- static void Merge(const GenericType& from, GenericType* to) {
280
- to->MergeFrom(from);
281
- }
282
- static int SpaceUsed(const GenericType& value) { return value.SpaceUsed(); }
283
- };
284
-
285
- template <>
286
- inline void GenericTypeHandler<MessageLite>::Merge(
287
- const MessageLite& from, MessageLite* to) {
288
- to->CheckTypeAndMergeFrom(from);
289
- }
290
-
291
- // HACK: If a class is declared as DLL-exported in MSVC, it insists on
292
- // generating copies of all its methods -- even inline ones -- to include
293
- // in the DLL. But SpaceUsed() calls StringSpaceUsedExcludingSelf() which
294
- // isn't in the lite library, therefore the lite library cannot link if
295
- // StringTypeHandler is exported. So, we factor out StringTypeHandlerBase,
296
- // export that, then make StringTypeHandler be a subclass which is NOT
297
- // exported.
298
- // TODO(kenton): There has to be a better way.
299
- class LIBPROTOBUF_EXPORT StringTypeHandlerBase {
300
- public:
301
- typedef string Type;
302
- static string* New();
303
- static void Delete(string* value);
304
- static void Clear(string* value) { value->clear(); }
305
- static void Merge(const string& from, string* to) { *to = from; }
306
- };
307
-
308
- class LIBPROTOBUF_EXPORT StringTypeHandler : public StringTypeHandlerBase {
309
- public:
310
- static int SpaceUsed(const string& value) {
311
- return sizeof(value) + StringSpaceUsedExcludingSelf(value);
312
- }
313
- };
314
-
315
-
316
- } // namespace internal
317
-
318
- // RepeatedPtrField is like RepeatedField, but used for repeated strings or
319
- // Messages.
320
- template <typename Element>
321
- class RepeatedPtrField : public internal::RepeatedPtrFieldBase {
322
- public:
323
- RepeatedPtrField();
324
- RepeatedPtrField(const RepeatedPtrField& other);
325
- ~RepeatedPtrField();
326
-
327
- RepeatedPtrField& operator=(const RepeatedPtrField& other);
328
-
329
- int size() const;
330
-
331
- const Element& Get(int index) const;
332
- Element* Mutable(int index);
333
- Element* Add();
334
- void RemoveLast(); // Remove the last element in the array.
335
- void Clear();
336
- void MergeFrom(const RepeatedPtrField& other);
337
- void CopyFrom(const RepeatedPtrField& other);
338
-
339
- // Reserve space to expand the field to at least the given size. This only
340
- // resizes the pointer array; it doesn't allocate any objects. If the
341
- // array is grown, it will always be at least doubled in size.
342
- void Reserve(int new_size);
343
-
344
- int Capacity() const;
345
-
346
- // Gets the underlying array. This pointer is possibly invalidated by
347
- // any add or remove operation.
348
- Element** mutable_data();
349
- const Element* const* data() const;
350
-
351
- // Swap entire contents with "other".
352
- void Swap(RepeatedPtrField* other);
353
-
354
- // Swap two elements.
355
- void SwapElements(int index1, int index2);
356
-
357
- // STL-like iterator support
358
- typedef internal::RepeatedPtrIterator<Element> iterator;
359
- typedef internal::RepeatedPtrIterator<const Element> const_iterator;
360
- typedef Element value_type;
361
-
362
- iterator begin();
363
- const_iterator begin() const;
364
- iterator end();
365
- const_iterator end() const;
366
-
367
- // Custom STL-like iterator that iterates over and returns the underlying
368
- // pointers to Element rather than Element itself.
369
- typedef internal::RepeatedPtrOverPtrsIterator<Element> pointer_iterator;
370
- pointer_iterator pointer_begin();
371
- pointer_iterator pointer_end();
372
-
373
- // Returns (an estimate of) the number of bytes used by the repeated field,
374
- // excluding sizeof(*this).
375
- int SpaceUsedExcludingSelf() const;
376
-
377
- // Advanced memory management --------------------------------------
378
- // When hardcore memory management becomes necessary -- as it often
379
- // does here at Google -- the following methods may be useful.
380
-
381
- // Add an already-allocated object, passing ownership to the
382
- // RepeatedPtrField.
383
- void AddAllocated(Element* value);
384
- // Remove the last element and return it, passing ownership to the
385
- // caller.
386
- // Requires: size() > 0
387
- Element* ReleaseLast();
388
-
389
- // When elements are removed by calls to RemoveLast() or Clear(), they
390
- // are not actually freed. Instead, they are cleared and kept so that
391
- // they can be reused later. This can save lots of CPU time when
392
- // repeatedly reusing a protocol message for similar purposes.
393
- //
394
- // Really, extremely hardcore programs may actually want to manipulate
395
- // these objects to better-optimize memory management. These methods
396
- // allow that.
397
-
398
- // Get the number of cleared objects that are currently being kept
399
- // around for reuse.
400
- int ClearedCount() const;
401
- // Add an element to the pool of cleared objects, passing ownership to
402
- // the RepeatedPtrField. The element must be cleared prior to calling
403
- // this method.
404
- void AddCleared(Element* value);
405
- // Remove a single element from the cleared pool and return it, passing
406
- // ownership to the caller. The element is guaranteed to be cleared.
407
- // Requires: ClearedCount() > 0
408
- Element* ReleaseCleared();
409
-
410
- protected:
411
- // Note: RepeatedPtrField SHOULD NOT be subclassed by users. We only
412
- // subclass it in one place as a hack for compatibility with proto1. The
413
- // subclass needs to know about TypeHandler in order to call protected
414
- // methods on RepeatedPtrFieldBase.
415
- class TypeHandler;
416
-
417
- };
418
-
419
- // implementation ====================================================
420
-
421
- template <typename Element>
422
- inline RepeatedField<Element>::RepeatedField()
423
- : elements_(initial_space_),
424
- current_size_(0),
425
- total_size_(kInitialSize) {
426
- }
427
-
428
- template <typename Element>
429
- inline RepeatedField<Element>::RepeatedField(const RepeatedField& other)
430
- : elements_(initial_space_),
431
- current_size_(0),
432
- total_size_(kInitialSize) {
433
- CopyFrom(other);
434
- }
435
-
436
- template <typename Element>
437
- RepeatedField<Element>::~RepeatedField() {
438
- if (elements_ != initial_space_) {
439
- delete [] elements_;
440
- }
441
- }
442
-
443
- template <typename Element>
444
- inline RepeatedField<Element>&
445
- RepeatedField<Element>::operator=(const RepeatedField& other) {
446
- CopyFrom(other);
447
- return *this;
448
- }
449
-
450
- template <typename Element>
451
- inline int RepeatedField<Element>::size() const {
452
- return current_size_;
453
- }
454
-
455
- template <typename Element>
456
- inline int RepeatedField<Element>::Capacity() const {
457
- return total_size_;
458
- }
459
-
460
- template<typename Element>
461
- inline void RepeatedField<Element>::AddAlreadyReserved(const Element& value) {
462
- GOOGLE_DCHECK_LT(size(), Capacity());
463
- elements_[current_size_++] = value;
464
- }
465
-
466
- template<typename Element>
467
- inline Element* RepeatedField<Element>::AddAlreadyReserved() {
468
- GOOGLE_DCHECK_LT(size(), Capacity());
469
- return &elements_[current_size_++];
470
- }
471
-
472
- template <typename Element>
473
- inline const Element& RepeatedField<Element>::Get(int index) const {
474
- GOOGLE_DCHECK_LT(index, size());
475
- return elements_[index];
476
- }
477
-
478
- template <typename Element>
479
- inline Element* RepeatedField<Element>::Mutable(int index) {
480
- GOOGLE_DCHECK_LT(index, size());
481
- return elements_ + index;
482
- }
483
-
484
- template <typename Element>
485
- inline void RepeatedField<Element>::Set(int index, const Element& value) {
486
- GOOGLE_DCHECK_LT(index, size());
487
- elements_[index] = value;
488
- }
489
-
490
- template <typename Element>
491
- inline void RepeatedField<Element>::Add(const Element& value) {
492
- if (current_size_ == total_size_) Reserve(total_size_ + 1);
493
- elements_[current_size_++] = value;
494
- }
495
-
496
- template <typename Element>
497
- inline Element* RepeatedField<Element>::Add() {
498
- if (current_size_ == total_size_) Reserve(total_size_ + 1);
499
- return &elements_[current_size_++];
500
- }
501
-
502
- template <typename Element>
503
- inline void RepeatedField<Element>::RemoveLast() {
504
- GOOGLE_DCHECK_GT(current_size_, 0);
505
- --current_size_;
506
- }
507
-
508
- template <typename Element>
509
- inline void RepeatedField<Element>::Clear() {
510
- current_size_ = 0;
511
- }
512
-
513
- template <typename Element>
514
- inline void RepeatedField<Element>::MergeFrom(const RepeatedField& other) {
515
- Reserve(current_size_ + other.current_size_);
516
- CopyArray(elements_ + current_size_, other.elements_, other.current_size_);
517
- current_size_ += other.current_size_;
518
- }
519
-
520
- template <typename Element>
521
- inline void RepeatedField<Element>::CopyFrom(const RepeatedField& other) {
522
- Clear();
523
- MergeFrom(other);
524
- }
525
-
526
- template <typename Element>
527
- inline Element* RepeatedField<Element>::mutable_data() {
528
- return elements_;
529
- }
530
-
531
- template <typename Element>
532
- inline const Element* RepeatedField<Element>::data() const {
533
- return elements_;
534
- }
535
-
536
-
537
- template <typename Element>
538
- void RepeatedField<Element>::Swap(RepeatedField* other) {
539
- Element* swap_elements = elements_;
540
- int swap_current_size = current_size_;
541
- int swap_total_size = total_size_;
542
- // We may not be using initial_space_ but it's not worth checking. Just
543
- // copy it anyway.
544
- Element swap_initial_space[kInitialSize];
545
- MoveArray(swap_initial_space, initial_space_, kInitialSize);
546
-
547
- elements_ = other->elements_;
548
- current_size_ = other->current_size_;
549
- total_size_ = other->total_size_;
550
- MoveArray(initial_space_, other->initial_space_, kInitialSize);
551
-
552
- other->elements_ = swap_elements;
553
- other->current_size_ = swap_current_size;
554
- other->total_size_ = swap_total_size;
555
- MoveArray(other->initial_space_, swap_initial_space, kInitialSize);
556
-
557
- if (elements_ == other->initial_space_) {
558
- elements_ = initial_space_;
559
- }
560
- if (other->elements_ == initial_space_) {
561
- other->elements_ = other->initial_space_;
562
- }
563
- }
564
-
565
- template <typename Element>
566
- void RepeatedField<Element>::SwapElements(int index1, int index2) {
567
- std::swap(elements_[index1], elements_[index2]);
568
- }
569
-
570
- template <typename Element>
571
- inline typename RepeatedField<Element>::iterator
572
- RepeatedField<Element>::begin() {
573
- return elements_;
574
- }
575
- template <typename Element>
576
- inline typename RepeatedField<Element>::const_iterator
577
- RepeatedField<Element>::begin() const {
578
- return elements_;
579
- }
580
- template <typename Element>
581
- inline typename RepeatedField<Element>::iterator
582
- RepeatedField<Element>::end() {
583
- return elements_ + current_size_;
584
- }
585
- template <typename Element>
586
- inline typename RepeatedField<Element>::const_iterator
587
- RepeatedField<Element>::end() const {
588
- return elements_ + current_size_;
589
- }
590
-
591
- template <typename Element>
592
- inline int RepeatedField<Element>::SpaceUsedExcludingSelf() const {
593
- return (elements_ != initial_space_) ? total_size_ * sizeof(elements_[0]) : 0;
594
- }
595
-
596
- // Avoid inlining of Reserve(): new, memcpy, and delete[] lead to a significant
597
- // amount of code bloat.
598
- template <typename Element>
599
- void RepeatedField<Element>::Reserve(int new_size) {
600
- if (total_size_ >= new_size) return;
601
-
602
- Element* old_elements = elements_;
603
- total_size_ = max(total_size_ * 2, new_size);
604
- elements_ = new Element[total_size_];
605
- MoveArray(elements_, old_elements, current_size_);
606
- if (old_elements != initial_space_) {
607
- delete [] old_elements;
608
- }
609
- }
610
-
611
- template <typename Element>
612
- inline void RepeatedField<Element>::Truncate(int new_size) {
613
- GOOGLE_DCHECK_LE(new_size, current_size_);
614
- current_size_ = new_size;
615
- }
616
-
617
- template <typename Element>
618
- inline void RepeatedField<Element>::MoveArray(
619
- Element to[], Element from[], int array_size) {
620
- memcpy(to, from, array_size * sizeof(Element));
621
- }
622
-
623
- template <typename Element>
624
- inline void RepeatedField<Element>::CopyArray(
625
- Element to[], const Element from[], int array_size) {
626
- memcpy(to, from, array_size * sizeof(Element));
627
- }
628
-
629
-
630
- // -------------------------------------------------------------------
631
-
632
- namespace internal {
633
-
634
- inline RepeatedPtrFieldBase::RepeatedPtrFieldBase()
635
- : elements_(initial_space_),
636
- current_size_(0),
637
- allocated_size_(0),
638
- total_size_(kInitialSize) {
639
- }
640
-
641
- template <typename TypeHandler>
642
- void RepeatedPtrFieldBase::Destroy() {
643
- for (int i = 0; i < allocated_size_; i++) {
644
- TypeHandler::Delete(cast<TypeHandler>(elements_[i]));
645
- }
646
- if (elements_ != initial_space_) {
647
- delete [] elements_;
648
- }
649
- }
650
-
651
- inline int RepeatedPtrFieldBase::size() const {
652
- return current_size_;
653
- }
654
-
655
-
656
- template <typename TypeHandler>
657
- inline const typename TypeHandler::Type&
658
- RepeatedPtrFieldBase::Get(int index) const {
659
- GOOGLE_DCHECK_LT(index, size());
660
- return *cast<TypeHandler>(elements_[index]);
661
- }
662
-
663
- template <typename TypeHandler>
664
- inline typename TypeHandler::Type*
665
- RepeatedPtrFieldBase::Mutable(int index) {
666
- GOOGLE_DCHECK_LT(index, size());
667
- return cast<TypeHandler>(elements_[index]);
668
- }
669
-
670
- template <typename TypeHandler>
671
- inline typename TypeHandler::Type* RepeatedPtrFieldBase::Add() {
672
- if (current_size_ < allocated_size_) {
673
- return cast<TypeHandler>(elements_[current_size_++]);
674
- }
675
- if (allocated_size_ == total_size_) Reserve(total_size_ + 1);
676
- ++allocated_size_;
677
- typename TypeHandler::Type* result = TypeHandler::New();
678
- elements_[current_size_++] = result;
679
- return result;
680
- }
681
-
682
- template <typename TypeHandler>
683
- inline void RepeatedPtrFieldBase::RemoveLast() {
684
- GOOGLE_DCHECK_GT(current_size_, 0);
685
- TypeHandler::Clear(cast<TypeHandler>(elements_[--current_size_]));
686
- }
687
-
688
- template <typename TypeHandler>
689
- void RepeatedPtrFieldBase::Clear() {
690
- for (int i = 0; i < current_size_; i++) {
691
- TypeHandler::Clear(cast<TypeHandler>(elements_[i]));
692
- }
693
- current_size_ = 0;
694
- }
695
-
696
- template <typename TypeHandler>
697
- inline void RepeatedPtrFieldBase::MergeFrom(const RepeatedPtrFieldBase& other) {
698
- Reserve(current_size_ + other.current_size_);
699
- for (int i = 0; i < other.current_size_; i++) {
700
- TypeHandler::Merge(other.template Get<TypeHandler>(i), Add<TypeHandler>());
701
- }
702
- }
703
-
704
- template <typename TypeHandler>
705
- inline void RepeatedPtrFieldBase::CopyFrom(const RepeatedPtrFieldBase& other) {
706
- RepeatedPtrFieldBase::Clear<TypeHandler>();
707
- RepeatedPtrFieldBase::MergeFrom<TypeHandler>(other);
708
- }
709
-
710
- inline int RepeatedPtrFieldBase::Capacity() const {
711
- return total_size_;
712
- }
713
-
714
- inline void* const* RepeatedPtrFieldBase::raw_data() const {
715
- return elements_;
716
- }
717
-
718
- inline void** RepeatedPtrFieldBase::raw_mutable_data() const {
719
- return elements_;
720
- }
721
-
722
- template <typename TypeHandler>
723
- inline typename TypeHandler::Type** RepeatedPtrFieldBase::mutable_data() {
724
- // TODO(kenton): Breaks C++ aliasing rules. We should probably remove this
725
- // method entirely.
726
- return reinterpret_cast<typename TypeHandler::Type**>(elements_);
727
- }
728
-
729
- template <typename TypeHandler>
730
- inline const typename TypeHandler::Type* const*
731
- RepeatedPtrFieldBase::data() const {
732
- // TODO(kenton): Breaks C++ aliasing rules. We should probably remove this
733
- // method entirely.
734
- return reinterpret_cast<const typename TypeHandler::Type* const*>(elements_);
735
- }
736
-
737
- inline void RepeatedPtrFieldBase::SwapElements(int index1, int index2) {
738
- std::swap(elements_[index1], elements_[index2]);
739
- }
740
-
741
- template <typename TypeHandler>
742
- inline int RepeatedPtrFieldBase::SpaceUsedExcludingSelf() const {
743
- int allocated_bytes =
744
- (elements_ != initial_space_) ? total_size_ * sizeof(elements_[0]) : 0;
745
- for (int i = 0; i < allocated_size_; ++i) {
746
- allocated_bytes += TypeHandler::SpaceUsed(*cast<TypeHandler>(elements_[i]));
747
- }
748
- return allocated_bytes;
749
- }
750
-
751
- template <typename TypeHandler>
752
- inline typename TypeHandler::Type* RepeatedPtrFieldBase::AddFromCleared() {
753
- if (current_size_ < allocated_size_) {
754
- return cast<TypeHandler>(elements_[current_size_++]);
755
- } else {
756
- return NULL;
757
- }
758
- }
759
-
760
- template <typename TypeHandler>
761
- void RepeatedPtrFieldBase::AddAllocated(
762
- typename TypeHandler::Type* value) {
763
- // Make room for the new pointer.
764
- if (current_size_ == total_size_) {
765
- // The array is completely full with no cleared objects, so grow it.
766
- Reserve(total_size_ + 1);
767
- ++allocated_size_;
768
- } else if (allocated_size_ == total_size_) {
769
- // There is no more space in the pointer array because it contains some
770
- // cleared objects awaiting reuse. We don't want to grow the array in this
771
- // case because otherwise a loop calling AddAllocated() followed by Clear()
772
- // would leak memory.
773
- TypeHandler::Delete(cast<TypeHandler>(elements_[current_size_]));
774
- } else if (current_size_ < allocated_size_) {
775
- // We have some cleared objects. We don't care about their order, so we
776
- // can just move the first one to the end to make space.
777
- elements_[allocated_size_] = elements_[current_size_];
778
- ++allocated_size_;
779
- } else {
780
- // There are no cleared objects.
781
- ++allocated_size_;
782
- }
783
-
784
- elements_[current_size_++] = value;
785
- }
786
-
787
- template <typename TypeHandler>
788
- inline typename TypeHandler::Type* RepeatedPtrFieldBase::ReleaseLast() {
789
- GOOGLE_DCHECK_GT(current_size_, 0);
790
- typename TypeHandler::Type* result =
791
- cast<TypeHandler>(elements_[--current_size_]);
792
- --allocated_size_;
793
- if (current_size_ < allocated_size_) {
794
- // There are cleared elements on the end; replace the removed element
795
- // with the last allocated element.
796
- elements_[current_size_] = elements_[allocated_size_];
797
- }
798
- return result;
799
- }
800
-
801
-
802
- inline int RepeatedPtrFieldBase::ClearedCount() const {
803
- return allocated_size_ - current_size_;
804
- }
805
-
806
- template <typename TypeHandler>
807
- inline void RepeatedPtrFieldBase::AddCleared(
808
- typename TypeHandler::Type* value) {
809
- if (allocated_size_ == total_size_) Reserve(total_size_ + 1);
810
- elements_[allocated_size_++] = value;
811
- }
812
-
813
- template <typename TypeHandler>
814
- inline typename TypeHandler::Type* RepeatedPtrFieldBase::ReleaseCleared() {
815
- GOOGLE_DCHECK_GT(allocated_size_, current_size_);
816
- return cast<TypeHandler>(elements_[--allocated_size_]);
817
- }
818
-
819
- } // namespace internal
820
-
821
- // -------------------------------------------------------------------
822
-
823
- template <typename Element>
824
- class RepeatedPtrField<Element>::TypeHandler
825
- : public internal::GenericTypeHandler<Element> {};
826
-
827
- template <>
828
- class RepeatedPtrField<string>::TypeHandler
829
- : public internal::StringTypeHandler {};
830
-
831
-
832
- template <typename Element>
833
- inline RepeatedPtrField<Element>::RepeatedPtrField() {}
834
-
835
- template <typename Element>
836
- inline RepeatedPtrField<Element>::RepeatedPtrField(
837
- const RepeatedPtrField& other) {
838
- CopyFrom(other);
839
- }
840
-
841
- template <typename Element>
842
- RepeatedPtrField<Element>::~RepeatedPtrField() {
843
- Destroy<TypeHandler>();
844
- }
845
-
846
- template <typename Element>
847
- inline RepeatedPtrField<Element>& RepeatedPtrField<Element>::operator=(
848
- const RepeatedPtrField& other) {
849
- CopyFrom(other);
850
- return *this;
851
- }
852
-
853
- template <typename Element>
854
- inline int RepeatedPtrField<Element>::size() const {
855
- return RepeatedPtrFieldBase::size();
856
- }
857
-
858
- template <typename Element>
859
- inline const Element& RepeatedPtrField<Element>::Get(int index) const {
860
- return RepeatedPtrFieldBase::Get<TypeHandler>(index);
861
- }
862
-
863
- template <typename Element>
864
- inline Element* RepeatedPtrField<Element>::Mutable(int index) {
865
- return RepeatedPtrFieldBase::Mutable<TypeHandler>(index);
866
- }
867
-
868
- template <typename Element>
869
- inline Element* RepeatedPtrField<Element>::Add() {
870
- return RepeatedPtrFieldBase::Add<TypeHandler>();
871
- }
872
-
873
- template <typename Element>
874
- inline void RepeatedPtrField<Element>::RemoveLast() {
875
- RepeatedPtrFieldBase::RemoveLast<TypeHandler>();
876
- }
877
-
878
- template <typename Element>
879
- inline void RepeatedPtrField<Element>::Clear() {
880
- RepeatedPtrFieldBase::Clear<TypeHandler>();
881
- }
882
-
883
- template <typename Element>
884
- inline void RepeatedPtrField<Element>::MergeFrom(
885
- const RepeatedPtrField& other) {
886
- RepeatedPtrFieldBase::MergeFrom<TypeHandler>(other);
887
- }
888
-
889
- template <typename Element>
890
- inline void RepeatedPtrField<Element>::CopyFrom(
891
- const RepeatedPtrField& other) {
892
- RepeatedPtrFieldBase::CopyFrom<TypeHandler>(other);
893
- }
894
-
895
- template <typename Element>
896
- inline Element** RepeatedPtrField<Element>::mutable_data() {
897
- return RepeatedPtrFieldBase::mutable_data<TypeHandler>();
898
- }
899
-
900
- template <typename Element>
901
- inline const Element* const* RepeatedPtrField<Element>::data() const {
902
- return RepeatedPtrFieldBase::data<TypeHandler>();
903
- }
904
-
905
- template <typename Element>
906
- void RepeatedPtrField<Element>::Swap(RepeatedPtrField* other) {
907
- RepeatedPtrFieldBase::Swap(other);
908
- }
909
-
910
- template <typename Element>
911
- void RepeatedPtrField<Element>::SwapElements(int index1, int index2) {
912
- RepeatedPtrFieldBase::SwapElements(index1, index2);
913
- }
914
-
915
- template <typename Element>
916
- inline int RepeatedPtrField<Element>::SpaceUsedExcludingSelf() const {
917
- return RepeatedPtrFieldBase::SpaceUsedExcludingSelf<TypeHandler>();
918
- }
919
-
920
- template <typename Element>
921
- inline void RepeatedPtrField<Element>::AddAllocated(Element* value) {
922
- RepeatedPtrFieldBase::AddAllocated<TypeHandler>(value);
923
- }
924
-
925
- template <typename Element>
926
- inline Element* RepeatedPtrField<Element>::ReleaseLast() {
927
- return RepeatedPtrFieldBase::ReleaseLast<TypeHandler>();
928
- }
929
-
930
-
931
- template <typename Element>
932
- inline int RepeatedPtrField<Element>::ClearedCount() const {
933
- return RepeatedPtrFieldBase::ClearedCount();
934
- }
935
-
936
- template <typename Element>
937
- inline void RepeatedPtrField<Element>::AddCleared(Element* value) {
938
- return RepeatedPtrFieldBase::AddCleared<TypeHandler>(value);
939
- }
940
-
941
- template <typename Element>
942
- inline Element* RepeatedPtrField<Element>::ReleaseCleared() {
943
- return RepeatedPtrFieldBase::ReleaseCleared<TypeHandler>();
944
- }
945
-
946
- template <typename Element>
947
- inline void RepeatedPtrField<Element>::Reserve(int new_size) {
948
- return RepeatedPtrFieldBase::Reserve(new_size);
949
- }
950
-
951
- template <typename Element>
952
- inline int RepeatedPtrField<Element>::Capacity() const {
953
- return RepeatedPtrFieldBase::Capacity();
954
- }
955
-
956
- // -------------------------------------------------------------------
957
-
958
- namespace internal {
959
-
960
- // STL-like iterator implementation for RepeatedPtrField. You should not
961
- // refer to this class directly; use RepeatedPtrField<T>::iterator instead.
962
- //
963
- // The iterator for RepeatedPtrField<T>, RepeatedPtrIterator<T>, is
964
- // very similar to iterator_ptr<T**> in util/gtl/iterator_adaptors-inl.h,
965
- // but adds random-access operators and is modified to wrap a void** base
966
- // iterator (since RepeatedPtrField stores its array as a void* array and
967
- // casting void** to T** would violate C++ aliasing rules).
968
- //
969
- // This code based on net/proto/proto-array-internal.h by Jeffrey Yasskin
970
- // (jyasskin@google.com).
971
- template<typename Element>
972
- class RepeatedPtrIterator
973
- : public std::iterator<
974
- std::random_access_iterator_tag, Element> {
975
- public:
976
- typedef RepeatedPtrIterator<Element> iterator;
977
- typedef std::iterator<
978
- std::random_access_iterator_tag, Element> superclass;
979
-
980
- // Let the compiler know that these are type names, so we don't have to
981
- // write "typename" in front of them everywhere.
982
- typedef typename superclass::reference reference;
983
- typedef typename superclass::pointer pointer;
984
- typedef typename superclass::difference_type difference_type;
985
-
986
- RepeatedPtrIterator() : it_(NULL) {}
987
- explicit RepeatedPtrIterator(void* const* it) : it_(it) {}
988
-
989
- // Allow "upcasting" from RepeatedPtrIterator<T**> to
990
- // RepeatedPtrIterator<const T*const*>.
991
- template<typename OtherElement>
992
- RepeatedPtrIterator(const RepeatedPtrIterator<OtherElement>& other)
993
- : it_(other.it_) {
994
- // Force a compiler error if the other type is not convertible to ours.
995
- if (false) {
996
- implicit_cast<Element*, OtherElement*>(0);
997
- }
998
- }
999
-
1000
- // dereferenceable
1001
- reference operator*() const { return *reinterpret_cast<Element*>(*it_); }
1002
- pointer operator->() const { return &(operator*()); }
1003
-
1004
- // {inc,dec}rementable
1005
- iterator& operator++() { ++it_; return *this; }
1006
- iterator operator++(int) { return iterator(it_++); }
1007
- iterator& operator--() { --it_; return *this; }
1008
- iterator operator--(int) { return iterator(it_--); }
1009
-
1010
- // equality_comparable
1011
- bool operator==(const iterator& x) const { return it_ == x.it_; }
1012
- bool operator!=(const iterator& x) const { return it_ != x.it_; }
1013
-
1014
- // less_than_comparable
1015
- bool operator<(const iterator& x) const { return it_ < x.it_; }
1016
- bool operator<=(const iterator& x) const { return it_ <= x.it_; }
1017
- bool operator>(const iterator& x) const { return it_ > x.it_; }
1018
- bool operator>=(const iterator& x) const { return it_ >= x.it_; }
1019
-
1020
- // addable, subtractable
1021
- iterator& operator+=(difference_type d) {
1022
- it_ += d;
1023
- return *this;
1024
- }
1025
- friend iterator operator+(iterator it, difference_type d) {
1026
- it += d;
1027
- return it;
1028
- }
1029
- friend iterator operator+(difference_type d, iterator it) {
1030
- it += d;
1031
- return it;
1032
- }
1033
- iterator& operator-=(difference_type d) {
1034
- it_ -= d;
1035
- return *this;
1036
- }
1037
- friend iterator operator-(iterator it, difference_type d) {
1038
- it -= d;
1039
- return it;
1040
- }
1041
-
1042
- // indexable
1043
- reference operator[](difference_type d) const { return *(*this + d); }
1044
-
1045
- // random access iterator
1046
- difference_type operator-(const iterator& x) const { return it_ - x.it_; }
1047
-
1048
- private:
1049
- template<typename OtherElement>
1050
- friend class RepeatedPtrIterator;
1051
-
1052
- // The internal iterator.
1053
- void* const* it_;
1054
- };
1055
-
1056
- // Provide an iterator that operates on pointers to the underlying objects
1057
- // rather than the objects themselves as RepeatedPtrIterator does.
1058
- // Consider using this when working with stl algorithms that change
1059
- // the array.
1060
- template<typename Element>
1061
- class RepeatedPtrOverPtrsIterator
1062
- : public std::iterator<std::random_access_iterator_tag, Element*> {
1063
- public:
1064
- typedef RepeatedPtrOverPtrsIterator<Element> iterator;
1065
- typedef std::iterator<
1066
- std::random_access_iterator_tag, Element*> superclass;
1067
-
1068
- // Let the compiler know that these are type names, so we don't have to
1069
- // write "typename" in front of them everywhere.
1070
- typedef typename superclass::reference reference;
1071
- typedef typename superclass::pointer pointer;
1072
- typedef typename superclass::difference_type difference_type;
1073
-
1074
- RepeatedPtrOverPtrsIterator() : it_(NULL) {}
1075
- explicit RepeatedPtrOverPtrsIterator(void** it) : it_(it) {}
1076
-
1077
- // dereferenceable
1078
- reference operator*() const { return *reinterpret_cast<Element**>(it_); }
1079
- pointer operator->() const { return &(operator*()); }
1080
-
1081
- // {inc,dec}rementable
1082
- iterator& operator++() { ++it_; return *this; }
1083
- iterator operator++(int) { return iterator(it_++); }
1084
- iterator& operator--() { --it_; return *this; }
1085
- iterator operator--(int) { return iterator(it_--); }
1086
-
1087
- // equality_comparable
1088
- bool operator==(const iterator& x) const { return it_ == x.it_; }
1089
- bool operator!=(const iterator& x) const { return it_ != x.it_; }
1090
-
1091
- // less_than_comparable
1092
- bool operator<(const iterator& x) const { return it_ < x.it_; }
1093
- bool operator<=(const iterator& x) const { return it_ <= x.it_; }
1094
- bool operator>(const iterator& x) const { return it_ > x.it_; }
1095
- bool operator>=(const iterator& x) const { return it_ >= x.it_; }
1096
-
1097
- // addable, subtractable
1098
- iterator& operator+=(difference_type d) {
1099
- it_ += d;
1100
- return *this;
1101
- }
1102
- friend iterator operator+(iterator it, difference_type d) {
1103
- it += d;
1104
- return it;
1105
- }
1106
- friend iterator operator+(difference_type d, iterator it) {
1107
- it += d;
1108
- return it;
1109
- }
1110
- iterator& operator-=(difference_type d) {
1111
- it_ -= d;
1112
- return *this;
1113
- }
1114
- friend iterator operator-(iterator it, difference_type d) {
1115
- it -= d;
1116
- return it;
1117
- }
1118
-
1119
- // indexable
1120
- reference operator[](difference_type d) const { return *(*this + d); }
1121
-
1122
- // random access iterator
1123
- difference_type operator-(const iterator& x) const { return it_ - x.it_; }
1124
-
1125
- private:
1126
- template<typename OtherElement>
1127
- friend class RepeatedPtrIterator;
1128
-
1129
- // The internal iterator.
1130
- void** it_;
1131
- };
1132
-
1133
-
1134
- } // namespace internal
1135
-
1136
- template <typename Element>
1137
- inline typename RepeatedPtrField<Element>::iterator
1138
- RepeatedPtrField<Element>::begin() {
1139
- return iterator(raw_data());
1140
- }
1141
- template <typename Element>
1142
- inline typename RepeatedPtrField<Element>::const_iterator
1143
- RepeatedPtrField<Element>::begin() const {
1144
- return iterator(raw_data());
1145
- }
1146
- template <typename Element>
1147
- inline typename RepeatedPtrField<Element>::iterator
1148
- RepeatedPtrField<Element>::end() {
1149
- return iterator(raw_data() + size());
1150
- }
1151
- template <typename Element>
1152
- inline typename RepeatedPtrField<Element>::const_iterator
1153
- RepeatedPtrField<Element>::end() const {
1154
- return iterator(raw_data() + size());
1155
- }
1156
-
1157
- template <typename Element>
1158
- inline typename RepeatedPtrField<Element>::pointer_iterator
1159
- RepeatedPtrField<Element>::pointer_begin() {
1160
- return pointer_iterator(raw_mutable_data());
1161
- }
1162
- template <typename Element>
1163
- inline typename RepeatedPtrField<Element>::pointer_iterator
1164
- RepeatedPtrField<Element>::pointer_end() {
1165
- return pointer_iterator(raw_mutable_data() + size());
1166
- }
1167
-
1168
-
1169
- // Iterators and helper functions that follow the spirit of the STL
1170
- // std::back_insert_iterator and std::back_inserter but are tailor-made
1171
- // for RepeatedField and RepatedPtrField. Typical usage would be:
1172
- //
1173
- // std::copy(some_sequence.begin(), some_sequence.end(),
1174
- // google::protobuf::RepeatedFieldBackInserter(proto.mutable_sequence()));
1175
- //
1176
- // Ported by johannes from util/gtl/proto-array-iterators-inl.h
1177
-
1178
- namespace internal {
1179
- // A back inserter for RepeatedField objects.
1180
- template<typename T> class RepeatedFieldBackInsertIterator
1181
- : public std::iterator<std::output_iterator_tag, T> {
1182
- public:
1183
- explicit RepeatedFieldBackInsertIterator(
1184
- RepeatedField<T>* const mutable_field)
1185
- : field_(mutable_field) {
1186
- }
1187
- RepeatedFieldBackInsertIterator<T>& operator=(const T& value) {
1188
- field_->Add(value);
1189
- return *this;
1190
- }
1191
- RepeatedFieldBackInsertIterator<T>& operator*() {
1192
- return *this;
1193
- }
1194
- RepeatedFieldBackInsertIterator<T>& operator++() {
1195
- return *this;
1196
- }
1197
- RepeatedFieldBackInsertIterator<T>& operator++(int ignores_parameter) {
1198
- return *this;
1199
- }
1200
-
1201
- private:
1202
- RepeatedField<T>* field_;
1203
- };
1204
-
1205
- // A back inserter for RepeatedPtrField objects.
1206
- template<typename T> class RepeatedPtrFieldBackInsertIterator
1207
- : public std::iterator<std::output_iterator_tag, T> {
1208
- public:
1209
- RepeatedPtrFieldBackInsertIterator(
1210
- RepeatedPtrField<T>* const mutable_field)
1211
- : field_(mutable_field) {
1212
- }
1213
- RepeatedPtrFieldBackInsertIterator<T>& operator=(const T& value) {
1214
- *field_->Add() = value;
1215
- return *this;
1216
- }
1217
- RepeatedPtrFieldBackInsertIterator<T>& operator=(
1218
- const T* const ptr_to_value) {
1219
- *field_->Add() = *ptr_to_value;
1220
- return *this;
1221
- }
1222
- RepeatedPtrFieldBackInsertIterator<T>& operator*() {
1223
- return *this;
1224
- }
1225
- RepeatedPtrFieldBackInsertIterator<T>& operator++() {
1226
- return *this;
1227
- }
1228
- RepeatedPtrFieldBackInsertIterator<T>& operator++(int ignores_parameter) {
1229
- return *this;
1230
- }
1231
-
1232
- private:
1233
- RepeatedPtrField<T>* field_;
1234
- };
1235
-
1236
- // A back inserter for RepeatedPtrFields that inserts by transfering ownership
1237
- // of a pointer.
1238
- template<typename T> class AllocatedRepeatedPtrFieldBackInsertIterator
1239
- : public std::iterator<std::output_iterator_tag, T> {
1240
- public:
1241
- explicit AllocatedRepeatedPtrFieldBackInsertIterator(
1242
- RepeatedPtrField<T>* const mutable_field)
1243
- : field_(mutable_field) {
1244
- }
1245
- AllocatedRepeatedPtrFieldBackInsertIterator<T>& operator=(
1246
- T* const ptr_to_value) {
1247
- field_->AddAllocated(ptr_to_value);
1248
- return *this;
1249
- }
1250
- AllocatedRepeatedPtrFieldBackInsertIterator<T>& operator*() {
1251
- return *this;
1252
- }
1253
- AllocatedRepeatedPtrFieldBackInsertIterator<T>& operator++() {
1254
- return *this;
1255
- }
1256
- AllocatedRepeatedPtrFieldBackInsertIterator<T>& operator++(
1257
- int ignores_parameter) {
1258
- return *this;
1259
- }
1260
-
1261
- private:
1262
- RepeatedPtrField<T>* field_;
1263
- };
1264
- } // namespace internal
1265
-
1266
- // Provides a back insert iterator for RepeatedField instances,
1267
- // similar to std::back_inserter(). Note the identically named
1268
- // function for RepeatedPtrField instances.
1269
- template<typename T> internal::RepeatedFieldBackInsertIterator<T>
1270
- RepeatedFieldBackInserter(RepeatedField<T>* const mutable_field) {
1271
- return internal::RepeatedFieldBackInsertIterator<T>(mutable_field);
1272
- }
1273
-
1274
- // Provides a back insert iterator for RepeatedPtrField instances,
1275
- // similar to std::back_inserter(). Note the identically named
1276
- // function for RepeatedField instances.
1277
- template<typename T> internal::RepeatedPtrFieldBackInsertIterator<T>
1278
- RepeatedFieldBackInserter(RepeatedPtrField<T>* const mutable_field) {
1279
- return internal::RepeatedPtrFieldBackInsertIterator<T>(mutable_field);
1280
- }
1281
-
1282
- // Provides a back insert iterator for RepeatedPtrField instances
1283
- // similar to std::back_inserter() which transfers the ownership while
1284
- // copying elements.
1285
- template<typename T> internal::AllocatedRepeatedPtrFieldBackInsertIterator<T>
1286
- AllocatedRepeatedPtrFieldBackInserter(
1287
- RepeatedPtrField<T>* const mutable_field) {
1288
- return internal::AllocatedRepeatedPtrFieldBackInsertIterator<T>(
1289
- mutable_field);
1290
- }
1291
-
1292
- } // namespace protobuf
1293
-
1294
- } // namespace google
1295
- #endif // GOOGLE_PROTOBUF_REPEATED_FIELD_H__