You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
351 lines
14 KiB
351 lines
14 KiB
// 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. |
|
|
|
#import <Foundation/Foundation.h> |
|
|
|
#import "GPBUtilities.h" |
|
|
|
#import "GPBDescriptor_PackagePrivate.h" |
|
|
|
// Macros for stringifying library symbols. These are used in the generated |
|
// PB descriptor classes wherever a library symbol name is represented as a |
|
// string. See README.google for more information. |
|
#define GPBStringify(S) #S |
|
#define GPBStringifySymbol(S) GPBStringify(S) |
|
|
|
#define GPBNSStringify(S) @#S |
|
#define GPBNSStringifySymbol(S) GPBNSStringify(S) |
|
|
|
// Constant to internally mark when there is no has bit. |
|
#define GPBNoHasBit INT32_MAX |
|
|
|
CF_EXTERN_C_BEGIN |
|
|
|
// These two are used to inject a runtime check for version mismatch into the |
|
// generated sources to make sure they are linked with a supporting runtime. |
|
void GPBCheckRuntimeVersionSupport(int32_t objcRuntimeVersion); |
|
GPB_INLINE void GPB_DEBUG_CHECK_RUNTIME_VERSIONS() { |
|
// NOTE: By being inline here, this captures the value from the library's |
|
// headers at the time the generated code was compiled. |
|
#if defined(DEBUG) && DEBUG |
|
GPBCheckRuntimeVersionSupport(GOOGLE_PROTOBUF_OBJC_VERSION); |
|
#endif |
|
} |
|
|
|
// Legacy version of the checks, remove when GOOGLE_PROTOBUF_OBJC_GEN_VERSION |
|
// goes away (see more info in GPBBootstrap.h). |
|
void GPBCheckRuntimeVersionInternal(int32_t version); |
|
GPB_INLINE void GPBDebugCheckRuntimeVersion() { |
|
#if defined(DEBUG) && DEBUG |
|
GPBCheckRuntimeVersionInternal(GOOGLE_PROTOBUF_OBJC_GEN_VERSION); |
|
#endif |
|
} |
|
|
|
// Conversion functions for de/serializing floating point types. |
|
|
|
GPB_INLINE int64_t GPBConvertDoubleToInt64(double v) { |
|
union { double f; int64_t i; } u; |
|
u.f = v; |
|
return u.i; |
|
} |
|
|
|
GPB_INLINE int32_t GPBConvertFloatToInt32(float v) { |
|
union { float f; int32_t i; } u; |
|
u.f = v; |
|
return u.i; |
|
} |
|
|
|
GPB_INLINE double GPBConvertInt64ToDouble(int64_t v) { |
|
union { double f; int64_t i; } u; |
|
u.i = v; |
|
return u.f; |
|
} |
|
|
|
GPB_INLINE float GPBConvertInt32ToFloat(int32_t v) { |
|
union { float f; int32_t i; } u; |
|
u.i = v; |
|
return u.f; |
|
} |
|
|
|
GPB_INLINE int32_t GPBLogicalRightShift32(int32_t value, int32_t spaces) { |
|
return (int32_t)((uint32_t)(value) >> spaces); |
|
} |
|
|
|
GPB_INLINE int64_t GPBLogicalRightShift64(int64_t value, int32_t spaces) { |
|
return (int64_t)((uint64_t)(value) >> spaces); |
|
} |
|
|
|
// Decode a ZigZag-encoded 32-bit value. ZigZag encodes signed integers |
|
// into values that can be efficiently encoded with varint. (Otherwise, |
|
// negative values must be sign-extended to 64 bits to be varint encoded, |
|
// thus always taking 10 bytes on the wire.) |
|
GPB_INLINE int32_t GPBDecodeZigZag32(uint32_t n) { |
|
return (int32_t)(GPBLogicalRightShift32((int32_t)n, 1) ^ -((int32_t)(n) & 1)); |
|
} |
|
|
|
// Decode a ZigZag-encoded 64-bit value. ZigZag encodes signed integers |
|
// into values that can be efficiently encoded with varint. (Otherwise, |
|
// negative values must be sign-extended to 64 bits to be varint encoded, |
|
// thus always taking 10 bytes on the wire.) |
|
GPB_INLINE int64_t GPBDecodeZigZag64(uint64_t n) { |
|
return (int64_t)(GPBLogicalRightShift64((int64_t)n, 1) ^ -((int64_t)(n) & 1)); |
|
} |
|
|
|
// Encode a ZigZag-encoded 32-bit value. ZigZag encodes signed integers |
|
// into values that can be efficiently encoded with varint. (Otherwise, |
|
// negative values must be sign-extended to 64 bits to be varint encoded, |
|
// thus always taking 10 bytes on the wire.) |
|
GPB_INLINE uint32_t GPBEncodeZigZag32(int32_t n) { |
|
// Note: the right-shift must be arithmetic |
|
return ((uint32_t)n << 1) ^ (uint32_t)(n >> 31); |
|
} |
|
|
|
// Encode a ZigZag-encoded 64-bit value. ZigZag encodes signed integers |
|
// into values that can be efficiently encoded with varint. (Otherwise, |
|
// negative values must be sign-extended to 64 bits to be varint encoded, |
|
// thus always taking 10 bytes on the wire.) |
|
GPB_INLINE uint64_t GPBEncodeZigZag64(int64_t n) { |
|
// Note: the right-shift must be arithmetic |
|
return ((uint64_t)n << 1) ^ (uint64_t)(n >> 63); |
|
} |
|
|
|
#pragma clang diagnostic push |
|
#pragma clang diagnostic ignored "-Wswitch-enum" |
|
#pragma clang diagnostic ignored "-Wdirect-ivar-access" |
|
|
|
GPB_INLINE BOOL GPBDataTypeIsObject(GPBDataType type) { |
|
switch (type) { |
|
case GPBDataTypeBytes: |
|
case GPBDataTypeString: |
|
case GPBDataTypeMessage: |
|
case GPBDataTypeGroup: |
|
return YES; |
|
default: |
|
return NO; |
|
} |
|
} |
|
|
|
GPB_INLINE BOOL GPBDataTypeIsMessage(GPBDataType type) { |
|
switch (type) { |
|
case GPBDataTypeMessage: |
|
case GPBDataTypeGroup: |
|
return YES; |
|
default: |
|
return NO; |
|
} |
|
} |
|
|
|
GPB_INLINE BOOL GPBFieldDataTypeIsMessage(GPBFieldDescriptor *field) { |
|
return GPBDataTypeIsMessage(field->description_->dataType); |
|
} |
|
|
|
GPB_INLINE BOOL GPBFieldDataTypeIsObject(GPBFieldDescriptor *field) { |
|
return GPBDataTypeIsObject(field->description_->dataType); |
|
} |
|
|
|
GPB_INLINE BOOL GPBExtensionIsMessage(GPBExtensionDescriptor *ext) { |
|
return GPBDataTypeIsMessage(ext->description_->dataType); |
|
} |
|
|
|
// The field is an array/map or it has an object value. |
|
GPB_INLINE BOOL GPBFieldStoresObject(GPBFieldDescriptor *field) { |
|
GPBMessageFieldDescription *desc = field->description_; |
|
if ((desc->flags & (GPBFieldRepeated | GPBFieldMapKeyMask)) != 0) { |
|
return YES; |
|
} |
|
return GPBDataTypeIsObject(desc->dataType); |
|
} |
|
|
|
BOOL GPBGetHasIvar(GPBMessage *self, int32_t index, uint32_t fieldNumber); |
|
void GPBSetHasIvar(GPBMessage *self, int32_t idx, uint32_t fieldNumber, |
|
BOOL value); |
|
uint32_t GPBGetHasOneof(GPBMessage *self, int32_t index); |
|
|
|
GPB_INLINE BOOL |
|
GPBGetHasIvarField(GPBMessage *self, GPBFieldDescriptor *field) { |
|
GPBMessageFieldDescription *fieldDesc = field->description_; |
|
return GPBGetHasIvar(self, fieldDesc->hasIndex, fieldDesc->number); |
|
} |
|
GPB_INLINE void GPBSetHasIvarField(GPBMessage *self, GPBFieldDescriptor *field, |
|
BOOL value) { |
|
GPBMessageFieldDescription *fieldDesc = field->description_; |
|
GPBSetHasIvar(self, fieldDesc->hasIndex, fieldDesc->number, value); |
|
} |
|
|
|
void GPBMaybeClearOneof(GPBMessage *self, GPBOneofDescriptor *oneof, |
|
int32_t oneofHasIndex, uint32_t fieldNumberNotToClear); |
|
|
|
#pragma clang diagnostic pop |
|
|
|
//%PDDM-DEFINE GPB_IVAR_SET_DECL(NAME, TYPE) |
|
//%void GPBSet##NAME##IvarWithFieldInternal(GPBMessage *self, |
|
//% NAME$S GPBFieldDescriptor *field, |
|
//% NAME$S TYPE value, |
|
//% NAME$S GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(Bool, BOOL) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetBoolIvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
BOOL value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(Int32, int32_t) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetInt32IvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
int32_t value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(UInt32, uint32_t) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetUInt32IvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
uint32_t value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(Int64, int64_t) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetInt64IvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
int64_t value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(UInt64, uint64_t) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetUInt64IvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
uint64_t value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(Float, float) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetFloatIvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
float value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(Double, double) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetDoubleIvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
double value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND GPB_IVAR_SET_DECL(Enum, int32_t) |
|
// This block of code is generated, do not edit it directly. |
|
|
|
void GPBSetEnumIvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
int32_t value, |
|
GPBFileSyntax syntax); |
|
//%PDDM-EXPAND-END (8 expansions) |
|
|
|
int32_t GPBGetEnumIvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
GPBFileSyntax syntax); |
|
|
|
id GPBGetObjectIvarWithField(GPBMessage *self, GPBFieldDescriptor *field); |
|
|
|
void GPBSetObjectIvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, id value, |
|
GPBFileSyntax syntax); |
|
void GPBSetRetainedObjectIvarWithFieldInternal(GPBMessage *self, |
|
GPBFieldDescriptor *field, |
|
id __attribute__((ns_consumed)) |
|
value, |
|
GPBFileSyntax syntax); |
|
|
|
// GPBGetObjectIvarWithField will automatically create the field (message) if |
|
// it doesn't exist. GPBGetObjectIvarWithFieldNoAutocreate will return nil. |
|
id GPBGetObjectIvarWithFieldNoAutocreate(GPBMessage *self, |
|
GPBFieldDescriptor *field); |
|
|
|
void GPBSetAutocreatedRetainedObjectIvarWithField( |
|
GPBMessage *self, GPBFieldDescriptor *field, |
|
id __attribute__((ns_consumed)) value); |
|
|
|
// Clears and releases the autocreated message ivar, if it's autocreated. If |
|
// it's not set as autocreated, this method does nothing. |
|
void GPBClearAutocreatedMessageIvarWithField(GPBMessage *self, |
|
GPBFieldDescriptor *field); |
|
|
|
// Returns an Objective C encoding for |selector|. |instanceSel| should be |
|
// YES if it's an instance selector (as opposed to a class selector). |
|
// |selector| must be a selector from MessageSignatureProtocol. |
|
const char *GPBMessageEncodingForSelector(SEL selector, BOOL instanceSel); |
|
|
|
// Helper for text format name encoding. |
|
// decodeData is the data describing the sepecial decodes. |
|
// key and inputString are the input that needs decoding. |
|
NSString *GPBDecodeTextFormatName(const uint8_t *decodeData, int32_t key, |
|
NSString *inputString); |
|
|
|
// A series of selectors that are used solely to get @encoding values |
|
// for them by the dynamic protobuf runtime code. See |
|
// GPBMessageEncodingForSelector for details. GPBRootObject conforms to |
|
// the protocol so that it is encoded in the Objective C runtime. |
|
@protocol GPBMessageSignatureProtocol |
|
@optional |
|
|
|
#define GPB_MESSAGE_SIGNATURE_ENTRY(TYPE, NAME) \ |
|
-(TYPE)get##NAME; \ |
|
-(void)set##NAME : (TYPE)value; \ |
|
-(TYPE)get##NAME##AtIndex : (NSUInteger)index; |
|
|
|
GPB_MESSAGE_SIGNATURE_ENTRY(BOOL, Bool) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(uint32_t, Fixed32) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(int32_t, SFixed32) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(float, Float) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(uint64_t, Fixed64) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(int64_t, SFixed64) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(double, Double) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(int32_t, Int32) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(int64_t, Int64) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(int32_t, SInt32) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(int64_t, SInt64) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(uint32_t, UInt32) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(uint64_t, UInt64) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(NSData *, Bytes) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(NSString *, String) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(GPBMessage *, Message) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(GPBMessage *, Group) |
|
GPB_MESSAGE_SIGNATURE_ENTRY(int32_t, Enum) |
|
|
|
#undef GPB_MESSAGE_SIGNATURE_ENTRY |
|
|
|
- (id)getArray; |
|
- (NSUInteger)getArrayCount; |
|
- (void)setArray:(NSArray *)array; |
|
+ (id)getClassValue; |
|
@end |
|
|
|
BOOL GPBClassHasSel(Class aClass, SEL sel); |
|
|
|
CF_EXTERN_C_END
|
|
|