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.
352 lines
14 KiB
352 lines
14 KiB
2 years ago
|
// 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
|