123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356 |
- // 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) {
- GPBInternalCompileAssert(sizeof(double) == sizeof(int64_t), double_not_64_bits);
- int64_t result;
- memcpy(&result, &v, sizeof(result));
- return result;
- }
- GPB_INLINE int32_t GPBConvertFloatToInt32(float v) {
- GPBInternalCompileAssert(sizeof(float) == sizeof(int32_t), float_not_32_bits);
- int32_t result;
- memcpy(&result, &v, sizeof(result));
- return result;
- }
- GPB_INLINE double GPBConvertInt64ToDouble(int64_t v) {
- GPBInternalCompileAssert(sizeof(double) == sizeof(int64_t), double_not_64_bits);
- double result;
- memcpy(&result, &v, sizeof(result));
- return result;
- }
- GPB_INLINE float GPBConvertInt32ToFloat(int32_t v) {
- GPBInternalCompileAssert(sizeof(float) == sizeof(int32_t), float_not_32_bits);
- float result;
- memcpy(&result, &v, sizeof(result));
- return result;
- }
- 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
|