Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(965)

Side by Side Diff: third_party/protobuf/objectivec/GPBExtensionRegistry.h

Issue 2600753002: Reverts third_party/protobuf: Update to HEAD (f52e188fe4) (Closed)
Patch Set: Created 3 years, 12 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 // Protocol Buffers - Google's data interchange format 1 // Protocol Buffers - Google's data interchange format
2 // Copyright 2008 Google Inc. All rights reserved. 2 // Copyright 2008 Google Inc. All rights reserved.
3 // https://developers.google.com/protocol-buffers/ 3 // https://developers.google.com/protocol-buffers/
4 // 4 //
5 // Redistribution and use in source and binary forms, with or without 5 // Redistribution and use in source and binary forms, with or without
6 // modification, are permitted provided that the following conditions are 6 // modification, are permitted provided that the following conditions are
7 // met: 7 // met:
8 // 8 //
9 // * Redistributions of source code must retain the above copyright 9 // * Redistributions of source code must retain the above copyright
10 // notice, this list of conditions and the following disclaimer. 10 // notice, this list of conditions and the following disclaimer.
(...skipping 17 matching lines...) Expand all
28 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 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. 29 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 30
31 #import <Foundation/Foundation.h> 31 #import <Foundation/Foundation.h>
32 32
33 @class GPBDescriptor; 33 @class GPBDescriptor;
34 @class GPBExtensionDescriptor; 34 @class GPBExtensionDescriptor;
35 35
36 NS_ASSUME_NONNULL_BEGIN 36 NS_ASSUME_NONNULL_BEGIN
37 37
38 /** 38 /// A table of known extensions, searchable by name or field number. When
39 * A table of known extensions, searchable by name or field number. When 39 /// parsing a protocol message that might have extensions, you must provide a
40 * parsing a protocol message that might have extensions, you must provide a 40 /// @c GPBExtensionRegistry in which you have registered any extensions that you
41 * GPBExtensionRegistry in which you have registered any extensions that you 41 /// want to be able to parse. Otherwise, those extensions will just be treated
42 * want to be able to parse. Otherwise, those extensions will just be treated 42 /// like unknown fields.
43 * like unknown fields. 43 ///
44 * 44 /// The @c *Root classes provide @c +extensionRegistry for the extensions define d
45 * The *Root classes provide `+extensionRegistry` for the extensions defined 45 /// in a given file *and* all files it imports. You can also create a
46 * in a given file *and* all files it imports. You can also create a 46 /// @c GPBExtensionRegistry, and merge those registries to handle parsing
47 * GPBExtensionRegistry, and merge those registries to handle parsing 47 /// extensions defined from non overlapping files.
48 * extensions defined from non overlapping files. 48 ///
49 * 49 /// @code
50 * ``` 50 /// GPBExtensionRegistry *registry =
51 * GPBExtensionRegistry *registry = [[MyProtoFileRoot extensionRegistry] copy]; 51 /// [[[MyProtoFileRoot extensionRegistry] copy] autorelease];
52 * [registry addExtension:[OtherMessage neededExtension]]; // Not in MyProtoFile 52 /// [registry addExtension:[OtherMessage neededExtension]; // Not in MyProtoFil e
53 * NSError *parseError; 53 /// NSError *parseError = nil;
54 * MyMessage *msg = [MyMessage parseData:data extensionRegistry:registry error:& parseError]; 54 /// MyMessage *msg = [MyMessage parseData:data
55 * ``` 55 /// extensionRegistry:registry
56 **/ 56 /// error:&parseError];
57 /// @endcode
57 @interface GPBExtensionRegistry : NSObject<NSCopying> 58 @interface GPBExtensionRegistry : NSObject<NSCopying>
58 59
59 /** 60 /// Add the given @c GPBExtensionDescriptor to this registry.
60 * Adds the given GPBExtensionDescriptor to this registry. 61 ///
61 * 62 /// @param extension The extension description to add.
62 * @param extension The extension description to add.
63 **/
64 - (void)addExtension:(GPBExtensionDescriptor *)extension; 63 - (void)addExtension:(GPBExtensionDescriptor *)extension;
65 64
66 /** 65 /// Adds all the extensions from another registry to this registry.
67 * Adds all the extensions from another registry to this registry. 66 ///
68 * 67 /// @param registry The registry to merge into this registry.
69 * @param registry The registry to merge into this registry.
70 **/
71 - (void)addExtensions:(GPBExtensionRegistry *)registry; 68 - (void)addExtensions:(GPBExtensionRegistry *)registry;
72 69
73 /** 70 /// Looks for the extension registered for the given field number on a given
74 * Looks for the extension registered for the given field number on a given 71 /// @c GPBDescriptor.
75 * GPBDescriptor. 72 ///
76 * 73 /// @param descriptor The descriptor to look for a registered extension on.
77 * @param descriptor The descriptor to look for a registered extension on. 74 /// @param fieldNumber The field number of an extension to look for.
78 * @param fieldNumber The field number of the extension to look for. 75 ///
79 * 76 /// @return The registered @c GPBExtensionDescripto or nil if none was found.
80 * @return The registered GPBExtensionDescriptor or nil if none was found.
81 **/
82 - (nullable GPBExtensionDescriptor *)extensionForDescriptor:(GPBDescriptor *)des criptor 77 - (nullable GPBExtensionDescriptor *)extensionForDescriptor:(GPBDescriptor *)des criptor
83 fieldNumber:(NSInteger)fieldNumb er; 78 fieldNumber:(NSInteger)fieldNumb er;
84 79
85 @end 80 @end
86 81
87 NS_ASSUME_NONNULL_END 82 NS_ASSUME_NONNULL_END
OLDNEW
« no previous file with comments | « third_party/protobuf/objectivec/GPBExtensionInternals.m ('k') | third_party/protobuf/objectivec/GPBExtensionRegistry.m » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698