| Index: third_party/protobuf/objectivec/GPBExtensionRegistry.h
|
| diff --git a/third_party/protobuf/objectivec/GPBExtensionRegistry.h b/third_party/protobuf/objectivec/GPBExtensionRegistry.h
|
| index 08a6472ac0748c3f8a31a67a7ccc74c4e0b36a58..d79632d28b079ecc31c8b27e99179ca23f274888 100644
|
| --- a/third_party/protobuf/objectivec/GPBExtensionRegistry.h
|
| +++ b/third_party/protobuf/objectivec/GPBExtensionRegistry.h
|
| @@ -35,45 +35,50 @@
|
|
|
| NS_ASSUME_NONNULL_BEGIN
|
|
|
| -/// A table of known extensions, searchable by name or field number. When
|
| -/// parsing a protocol message that might have extensions, you must provide a
|
| -/// @c GPBExtensionRegistry in which you have registered any extensions that you
|
| -/// want to be able to parse. Otherwise, those extensions will just be treated
|
| -/// like unknown fields.
|
| -///
|
| -/// The @c *Root classes provide @c +extensionRegistry for the extensions defined
|
| -/// in a given file *and* all files it imports. You can also create a
|
| -/// @c GPBExtensionRegistry, and merge those registries to handle parsing
|
| -/// extensions defined from non overlapping files.
|
| -///
|
| -/// @code
|
| -/// GPBExtensionRegistry *registry =
|
| -/// [[[MyProtoFileRoot extensionRegistry] copy] autorelease];
|
| -/// [registry addExtension:[OtherMessage neededExtension]; // Not in MyProtoFile
|
| -/// NSError *parseError = nil;
|
| -/// MyMessage *msg = [MyMessage parseData:data
|
| -/// extensionRegistry:registry
|
| -/// error:&parseError];
|
| -/// @endcode
|
| +/**
|
| + * A table of known extensions, searchable by name or field number. When
|
| + * parsing a protocol message that might have extensions, you must provide a
|
| + * GPBExtensionRegistry in which you have registered any extensions that you
|
| + * want to be able to parse. Otherwise, those extensions will just be treated
|
| + * like unknown fields.
|
| + *
|
| + * The *Root classes provide `+extensionRegistry` for the extensions defined
|
| + * in a given file *and* all files it imports. You can also create a
|
| + * GPBExtensionRegistry, and merge those registries to handle parsing
|
| + * extensions defined from non overlapping files.
|
| + *
|
| + * ```
|
| + * GPBExtensionRegistry *registry = [[MyProtoFileRoot extensionRegistry] copy];
|
| + * [registry addExtension:[OtherMessage neededExtension]]; // Not in MyProtoFile
|
| + * NSError *parseError;
|
| + * MyMessage *msg = [MyMessage parseData:data extensionRegistry:registry error:&parseError];
|
| + * ```
|
| + **/
|
| @interface GPBExtensionRegistry : NSObject<NSCopying>
|
|
|
| -/// Add the given @c GPBExtensionDescriptor to this registry.
|
| -///
|
| -/// @param extension The extension description to add.
|
| +/**
|
| + * Adds the given GPBExtensionDescriptor to this registry.
|
| + *
|
| + * @param extension The extension description to add.
|
| + **/
|
| - (void)addExtension:(GPBExtensionDescriptor *)extension;
|
|
|
| -/// Adds all the extensions from another registry to this registry.
|
| -///
|
| -/// @param registry The registry to merge into this registry.
|
| +/**
|
| + * Adds all the extensions from another registry to this registry.
|
| + *
|
| + * @param registry The registry to merge into this registry.
|
| + **/
|
| - (void)addExtensions:(GPBExtensionRegistry *)registry;
|
|
|
| -/// Looks for the extension registered for the given field number on a given
|
| -/// @c GPBDescriptor.
|
| -///
|
| -/// @param descriptor The descriptor to look for a registered extension on.
|
| -/// @param fieldNumber The field number of an extension to look for.
|
| -///
|
| -/// @return The registered @c GPBExtensionDescripto or nil if none was found.
|
| +/**
|
| + * Looks for the extension registered for the given field number on a given
|
| + * GPBDescriptor.
|
| + *
|
| + * @param descriptor The descriptor to look for a registered extension on.
|
| + * @param fieldNumber The field number of the extension to look for.
|
| + *
|
| + * @return The registered GPBExtensionDescriptor or nil if none was found.
|
| + **/
|
| - (nullable GPBExtensionDescriptor *)extensionForDescriptor:(GPBDescriptor *)descriptor
|
| fieldNumber:(NSInteger)fieldNumber;
|
|
|
|
|