|  | // Protocol Buffers - Google's data interchange format | 
|  | // Copyright 2008 Google Inc.  All rights reserved. | 
|  | // https://developers.google.com/protocol-buffers/ | 
|  | // | 
|  | // Redistribution and use in source and binary forms, with or without | 
|  | // modification, are permitted provided that the following conditions are | 
|  | // met: | 
|  | // | 
|  | //     * Redistributions of source code must retain the above copyright | 
|  | // notice, this list of conditions and the following disclaimer. | 
|  | //     * Redistributions in binary form must reproduce the above | 
|  | // copyright notice, this list of conditions and the following disclaimer | 
|  | // in the documentation and/or other materials provided with the | 
|  | // distribution. | 
|  | //     * Neither the name of Google Inc. nor the names of its | 
|  | // contributors may be used to endorse or promote products derived from | 
|  | // this software without specific prior written permission. | 
|  | // | 
|  | // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | 
|  | // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | 
|  | // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | 
|  | // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | 
|  | // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | 
|  | // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | 
|  | // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | 
|  | // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | 
|  | // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 
|  | // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | 
|  | // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 
|  |  | 
|  | // This header is private to the ProtobolBuffers library and must NOT be | 
|  | // included by any sources outside this library. The contents of this file are | 
|  | // subject to change at any time without notice. | 
|  |  | 
|  | #import "GPBDescriptor.h" | 
|  | #import "GPBWireFormat.h" | 
|  |  | 
|  | // Describes attributes of the field. | 
|  | typedef NS_OPTIONS(uint32_t, GPBFieldFlags) { | 
|  | // These map to standard protobuf concepts. | 
|  | GPBFieldRequired        = 1 << 0, | 
|  | GPBFieldRepeated        = 1 << 1, | 
|  | GPBFieldPacked          = 1 << 2, | 
|  | GPBFieldOptional        = 1 << 3, | 
|  | GPBFieldHasDefaultValue = 1 << 4, | 
|  |  | 
|  | // These are not standard protobuf concepts, they are specific to the | 
|  | // Objective C runtime. | 
|  |  | 
|  | // These bits are used to mark the field as a map and what the key | 
|  | // type is. | 
|  | GPBFieldMapKeyMask     = 0xF << 8, | 
|  | GPBFieldMapKeyInt32    =  1 << 8, | 
|  | GPBFieldMapKeyInt64    =  2 << 8, | 
|  | GPBFieldMapKeyUInt32   =  3 << 8, | 
|  | GPBFieldMapKeyUInt64   =  4 << 8, | 
|  | GPBFieldMapKeySInt32   =  5 << 8, | 
|  | GPBFieldMapKeySInt64   =  6 << 8, | 
|  | GPBFieldMapKeyFixed32  =  7 << 8, | 
|  | GPBFieldMapKeyFixed64  =  8 << 8, | 
|  | GPBFieldMapKeySFixed32 =  9 << 8, | 
|  | GPBFieldMapKeySFixed64 = 10 << 8, | 
|  | GPBFieldMapKeyBool     = 11 << 8, | 
|  | GPBFieldMapKeyString   = 12 << 8, | 
|  |  | 
|  | // Indicates the field needs custom handling for the TextFormat name, if not | 
|  | // set, the name can be derived from the ObjC name. | 
|  | GPBFieldTextFormatNameCustom = 1 << 16, | 
|  | // Indicates the field has an enum descriptor. | 
|  | GPBFieldHasEnumDescriptor = 1 << 17, | 
|  | }; | 
|  |  | 
|  | // Describes a single field in a protobuf as it is represented as an ivar. | 
|  | typedef struct GPBMessageFieldDescription { | 
|  | // Name of ivar. | 
|  | const char *name; | 
|  | // The field number for the ivar. | 
|  | uint32_t number; | 
|  | // The index (in bits) into _has_storage_. | 
|  | //   > 0: the bit to use for a value being set. | 
|  | //   = 0: no storage used. | 
|  | //   < 0: in a oneOf, use a full int32 to record the field active. | 
|  | int32_t hasIndex; | 
|  | // Field flags. Use accessor functions below. | 
|  | GPBFieldFlags flags; | 
|  | // Data type of the ivar. | 
|  | GPBDataType dataType; | 
|  | // Offset of the variable into it's structure struct. | 
|  | size_t offset; | 
|  | // FieldOptions protobuf, serialized as string. | 
|  | const char *fieldOptions; | 
|  |  | 
|  | GPBGenericValue defaultValue;  // Default value for the ivar. | 
|  | union { | 
|  | const char *className;  // Name for message class. | 
|  | // For enums only: If EnumDescriptors are compiled in, it will be that, | 
|  | // otherwise it will be the verifier. | 
|  | GPBEnumDescriptorFunc enumDescFunc; | 
|  | GPBEnumValidationFunc enumVerifier; | 
|  | } dataTypeSpecific; | 
|  | } GPBMessageFieldDescription; | 
|  |  | 
|  | // Describes a oneof. | 
|  | typedef struct GPBMessageOneofDescription { | 
|  | // Name of this enum oneof. | 
|  | const char *name; | 
|  | // The index of this oneof in the has_storage. | 
|  | int32_t index; | 
|  | } GPBMessageOneofDescription; | 
|  |  | 
|  | // Describes an enum type defined in a .proto file. | 
|  | typedef struct GPBMessageEnumDescription { | 
|  | GPBEnumDescriptorFunc enumDescriptorFunc; | 
|  | } GPBMessageEnumDescription; | 
|  |  | 
|  | // Describes an individual enum constant of a particular type. | 
|  | typedef struct GPBMessageEnumValueDescription { | 
|  | // Name of this enum constant. | 
|  | const char *name; | 
|  | // Numeric value of this enum constant. | 
|  | int32_t number; | 
|  | } GPBMessageEnumValueDescription; | 
|  |  | 
|  | // Describes attributes of the extension. | 
|  | typedef NS_OPTIONS(uint32_t, GPBExtensionOptions) { | 
|  | // These map to standard protobuf concepts. | 
|  | GPBExtensionRepeated      = 1 << 0, | 
|  | GPBExtensionPacked        = 1 << 1, | 
|  | GPBExtensionSetWireFormat = 1 << 2, | 
|  | }; | 
|  |  | 
|  | // An extension | 
|  | typedef struct GPBExtensionDescription { | 
|  | const char *singletonName; | 
|  | GPBDataType dataType; | 
|  | const char *extendedClass; | 
|  | int32_t fieldNumber; | 
|  | GPBGenericValue defaultValue; | 
|  | const char *messageOrGroupClassName; | 
|  | GPBExtensionOptions options; | 
|  | GPBEnumDescriptorFunc enumDescriptorFunc; | 
|  | } GPBExtensionDescription; | 
|  |  | 
|  | @interface GPBDescriptor () { | 
|  | @package | 
|  | NSArray *fields_; | 
|  | NSArray *oneofs_; | 
|  | size_t storageSize_; | 
|  | } | 
|  |  | 
|  | // fieldDescriptions, enumDescriptions, rangeDescriptions, and | 
|  | // extraTextFormatInfo have to be long lived, they are held as raw pointers. | 
|  | + (instancetype) | 
|  | allocDescriptorForClass:(Class)messageClass | 
|  | rootClass:(Class)rootClass | 
|  | file:(GPBFileDescriptor *)file | 
|  | fields:(GPBMessageFieldDescription *)fieldDescriptions | 
|  | fieldCount:(NSUInteger)fieldCount | 
|  | oneofs:(GPBMessageOneofDescription *)oneofDescriptions | 
|  | oneofCount:(NSUInteger)oneofCount | 
|  | enums:(GPBMessageEnumDescription *)enumDescriptions | 
|  | enumCount:(NSUInteger)enumCount | 
|  | ranges:(const GPBExtensionRange *)ranges | 
|  | rangeCount:(NSUInteger)rangeCount | 
|  | storageSize:(size_t)storageSize | 
|  | wireFormat:(BOOL)wireFormat; | 
|  | + (instancetype) | 
|  | allocDescriptorForClass:(Class)messageClass | 
|  | rootClass:(Class)rootClass | 
|  | file:(GPBFileDescriptor *)file | 
|  | fields:(GPBMessageFieldDescription *)fieldDescriptions | 
|  | fieldCount:(NSUInteger)fieldCount | 
|  | oneofs:(GPBMessageOneofDescription *)oneofDescriptions | 
|  | oneofCount:(NSUInteger)oneofCount | 
|  | enums:(GPBMessageEnumDescription *)enumDescriptions | 
|  | enumCount:(NSUInteger)enumCount | 
|  | ranges:(const GPBExtensionRange *)ranges | 
|  | rangeCount:(NSUInteger)rangeCount | 
|  | storageSize:(size_t)storageSize | 
|  | wireFormat:(BOOL)wireFormat | 
|  | extraTextFormatInfo:(const char *)extraTextFormatInfo; | 
|  |  | 
|  | - (instancetype)initWithClass:(Class)messageClass | 
|  | file:(GPBFileDescriptor *)file | 
|  | fields:(NSArray *)fields | 
|  | oneofs:(NSArray *)oneofs | 
|  | enums:(NSArray *)enums | 
|  | extensionRanges:(const GPBExtensionRange *)ranges | 
|  | extensionRangesCount:(NSUInteger)rangeCount | 
|  | storageSize:(size_t)storage | 
|  | wireFormat:(BOOL)wireFormat; | 
|  |  | 
|  | @end | 
|  |  | 
|  | @interface GPBFileDescriptor () | 
|  | - (instancetype)initWithPackage:(NSString *)package | 
|  | syntax:(GPBFileSyntax)syntax; | 
|  | @end | 
|  |  | 
|  | @interface GPBOneofDescriptor () { | 
|  | @package | 
|  | GPBMessageOneofDescription *oneofDescription_; | 
|  | NSArray *fields_; | 
|  |  | 
|  | SEL caseSel_; | 
|  | } | 
|  | - (instancetype)initWithOneofDescription: | 
|  | (GPBMessageOneofDescription *)oneofDescription | 
|  | fields:(NSArray *)fields; | 
|  | @end | 
|  |  | 
|  | @interface GPBFieldDescriptor () { | 
|  | @package | 
|  | GPBMessageFieldDescription *description_; | 
|  | GPB_UNSAFE_UNRETAINED GPBOneofDescriptor *containingOneof_; | 
|  |  | 
|  | SEL getSel_; | 
|  | SEL setSel_; | 
|  | SEL hasOrCountSel_;  // *Count for map<>/repeated fields, has* otherwise. | 
|  | SEL setHasSel_; | 
|  | } | 
|  |  | 
|  | // Single initializer | 
|  | // description has to be long lived, it is held as a raw pointer. | 
|  | - (instancetype)initWithFieldDescription: | 
|  | (GPBMessageFieldDescription *)description | 
|  | rootClass:(Class)rootClass | 
|  | syntax:(GPBFileSyntax)syntax; | 
|  | @end | 
|  |  | 
|  | @interface GPBEnumDescriptor () | 
|  | // valueDescriptions and extraTextFormatInfo have to be long lived, they are | 
|  | // held as raw pointers. | 
|  | + (instancetype) | 
|  | allocDescriptorForName:(NSString *)name | 
|  | values:(GPBMessageEnumValueDescription *)valueDescriptions | 
|  | valueCount:(NSUInteger)valueCount | 
|  | enumVerifier:(GPBEnumValidationFunc)enumVerifier; | 
|  | + (instancetype) | 
|  | allocDescriptorForName:(NSString *)name | 
|  | values:(GPBMessageEnumValueDescription *)valueDescriptions | 
|  | valueCount:(NSUInteger)valueCount | 
|  | enumVerifier:(GPBEnumValidationFunc)enumVerifier | 
|  | extraTextFormatInfo:(const char *)extraTextFormatInfo; | 
|  |  | 
|  | - (instancetype)initWithName:(NSString *)name | 
|  | values:(GPBMessageEnumValueDescription *)valueDescriptions | 
|  | valueCount:(NSUInteger)valueCount | 
|  | enumVerifier:(GPBEnumValidationFunc)enumVerifier; | 
|  | @end | 
|  |  | 
|  | @interface GPBExtensionDescriptor () { | 
|  | @package | 
|  | GPBExtensionDescription *description_; | 
|  | } | 
|  | @property(nonatomic, readonly) GPBWireFormat wireType; | 
|  |  | 
|  | // For repeated extensions, alternateWireType is the wireType with the opposite | 
|  | // value for the packable property.  i.e. - if the extension was marked packed | 
|  | // it would be the wire type for unpacked; if the extension was marked unpacked, | 
|  | // it would be the wire type for packed. | 
|  | @property(nonatomic, readonly) GPBWireFormat alternateWireType; | 
|  |  | 
|  | // description has to be long lived, it is held as a raw pointer. | 
|  | - (instancetype)initWithExtensionDescription: | 
|  | (GPBExtensionDescription *)description; | 
|  | - (NSComparisonResult)compareByFieldNumber:(GPBExtensionDescriptor *)other; | 
|  | @end | 
|  |  | 
|  | CF_EXTERN_C_BEGIN | 
|  |  | 
|  | GPB_INLINE BOOL GPBFieldIsMapOrArray(GPBFieldDescriptor *field) { | 
|  | return (field->description_->flags & | 
|  | (GPBFieldRepeated | GPBFieldMapKeyMask)) != 0; | 
|  | } | 
|  |  | 
|  | GPB_INLINE GPBDataType GPBGetFieldDataType(GPBFieldDescriptor *field) { | 
|  | return field->description_->dataType; | 
|  | } | 
|  |  | 
|  | GPB_INLINE int32_t GPBFieldHasIndex(GPBFieldDescriptor *field) { | 
|  | return field->description_->hasIndex; | 
|  | } | 
|  |  | 
|  | GPB_INLINE uint32_t GPBFieldNumber(GPBFieldDescriptor *field) { | 
|  | return field->description_->number; | 
|  | } | 
|  |  | 
|  | uint32_t GPBFieldTag(GPBFieldDescriptor *self); | 
|  |  | 
|  | // For repeated fields, alternateWireType is the wireType with the opposite | 
|  | // value for the packable property.  i.e. - if the field was marked packed it | 
|  | // would be the wire type for unpacked; if the field was marked unpacked, it | 
|  | // would be the wire type for packed. | 
|  | uint32_t GPBFieldAlternateTag(GPBFieldDescriptor *self); | 
|  |  | 
|  | GPB_INLINE BOOL GPBPreserveUnknownFields(GPBFileSyntax syntax) { | 
|  | return syntax != GPBFileSyntaxProto3; | 
|  | } | 
|  |  | 
|  | GPB_INLINE BOOL GPBHasPreservingUnknownEnumSemantics(GPBFileSyntax syntax) { | 
|  | return syntax == GPBFileSyntaxProto3; | 
|  | } | 
|  |  | 
|  | GPB_INLINE BOOL GPBExtensionIsRepeated(GPBExtensionDescription *description) { | 
|  | return (description->options & GPBExtensionRepeated) != 0; | 
|  | } | 
|  |  | 
|  | GPB_INLINE BOOL GPBExtensionIsPacked(GPBExtensionDescription *description) { | 
|  | return (description->options & GPBExtensionPacked) != 0; | 
|  | } | 
|  |  | 
|  | GPB_INLINE BOOL GPBExtensionIsWireFormat(GPBExtensionDescription *description) { | 
|  | return (description->options & GPBExtensionSetWireFormat) != 0; | 
|  | } | 
|  |  | 
|  |  | 
|  | CF_EXTERN_C_END |