42ab9b4442
Work for #1866 Migrates all the public class docs over to appledoc format. While Xcode is fine with blank lines in `///` comments, appledoc (used by cocoadocs) isn't and was leaving a bunch of info off the doc pages. The generator still needs to be updated to do this also; that will be a follow up CL.
535 lines
17 KiB
Objective-C
535 lines
17 KiB
Objective-C
// 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 "GPBArray.h"
|
|
#import "GPBMessage.h"
|
|
#import "GPBRuntimeTypes.h"
|
|
|
|
CF_EXTERN_C_BEGIN
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
* Generates a string that should be a valid "TextFormat" for the C++ version
|
|
* of Protocol Buffers.
|
|
*
|
|
* @param message The message to generate from.
|
|
* @param lineIndent A string to use as the prefix for all lines generated. Can
|
|
* be nil if no extra indent is needed.
|
|
*
|
|
* @return An NSString with the TextFormat of the message.
|
|
**/
|
|
NSString *GPBTextFormatForMessage(GPBMessage *message,
|
|
NSString * __nullable lineIndent);
|
|
|
|
/**
|
|
* Generates a string that should be a valid "TextFormat" for the C++ version
|
|
* of Protocol Buffers.
|
|
*
|
|
* @param unknownSet The unknown field set to generate from.
|
|
* @param lineIndent A string to use as the prefix for all lines generated. Can
|
|
* be nil if no extra indent is needed.
|
|
*
|
|
* @return An NSString with the TextFormat of the unknown field set.
|
|
**/
|
|
NSString *GPBTextFormatForUnknownFieldSet(GPBUnknownFieldSet * __nullable unknownSet,
|
|
NSString * __nullable lineIndent);
|
|
|
|
/**
|
|
* Checks if the given field number is set on a message.
|
|
*
|
|
* @param self The message to check.
|
|
* @param fieldNumber The field number to check.
|
|
*
|
|
* @return YES if the field number is set on the given message.
|
|
**/
|
|
BOOL GPBMessageHasFieldNumberSet(GPBMessage *self, uint32_t fieldNumber);
|
|
|
|
/**
|
|
* Checks if the given field is set on a message.
|
|
*
|
|
* @param self The message to check.
|
|
* @param field The field to check.
|
|
*
|
|
* @return YES if the field is set on the given message.
|
|
**/
|
|
BOOL GPBMessageHasFieldSet(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Clears the given field for the given message.
|
|
*
|
|
* @param self The message for which to clear the field.
|
|
* @param field The field to clear.
|
|
**/
|
|
void GPBClearMessageField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
//%PDDM-EXPAND GPB_ACCESSORS()
|
|
// This block of code is generated, do not edit it directly.
|
|
|
|
|
|
//
|
|
// Get/Set a given field from/to a message.
|
|
//
|
|
|
|
// Single Fields
|
|
|
|
/**
|
|
* Gets the value of a bytes field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
NSData *GPBGetMessageBytesField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a bytes field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageBytesField(GPBMessage *self, GPBFieldDescriptor *field, NSData *value);
|
|
|
|
/**
|
|
* Gets the value of a string field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
NSString *GPBGetMessageStringField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a string field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageStringField(GPBMessage *self, GPBFieldDescriptor *field, NSString *value);
|
|
|
|
/**
|
|
* Gets the value of a message field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
GPBMessage *GPBGetMessageMessageField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a message field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageMessageField(GPBMessage *self, GPBFieldDescriptor *field, GPBMessage *value);
|
|
|
|
/**
|
|
* Gets the value of a group field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
GPBMessage *GPBGetMessageGroupField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a group field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageGroupField(GPBMessage *self, GPBFieldDescriptor *field, GPBMessage *value);
|
|
|
|
/**
|
|
* Gets the value of a bool field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
BOOL GPBGetMessageBoolField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a bool field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageBoolField(GPBMessage *self, GPBFieldDescriptor *field, BOOL value);
|
|
|
|
/**
|
|
* Gets the value of an int32 field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
int32_t GPBGetMessageInt32Field(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of an int32 field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageInt32Field(GPBMessage *self, GPBFieldDescriptor *field, int32_t value);
|
|
|
|
/**
|
|
* Gets the value of an uint32 field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
uint32_t GPBGetMessageUInt32Field(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of an uint32 field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageUInt32Field(GPBMessage *self, GPBFieldDescriptor *field, uint32_t value);
|
|
|
|
/**
|
|
* Gets the value of an int64 field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
int64_t GPBGetMessageInt64Field(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of an int64 field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageInt64Field(GPBMessage *self, GPBFieldDescriptor *field, int64_t value);
|
|
|
|
/**
|
|
* Gets the value of an uint64 field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
uint64_t GPBGetMessageUInt64Field(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of an uint64 field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageUInt64Field(GPBMessage *self, GPBFieldDescriptor *field, uint64_t value);
|
|
|
|
/**
|
|
* Gets the value of a float field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
float GPBGetMessageFloatField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a float field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageFloatField(GPBMessage *self, GPBFieldDescriptor *field, float value);
|
|
|
|
/**
|
|
* Gets the value of a double field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
**/
|
|
double GPBGetMessageDoubleField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a double field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The to set in the field.
|
|
**/
|
|
void GPBSetMessageDoubleField(GPBMessage *self, GPBFieldDescriptor *field, double value);
|
|
|
|
/**
|
|
* Gets the given enum field of a message. For proto3, if the value isn't a
|
|
* member of the enum, @c kGPBUnrecognizedEnumeratorValue will be returned.
|
|
* GPBGetMessageRawEnumField will bypass the check and return whatever value
|
|
* was set.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
*
|
|
* @return The enum value for the given field.
|
|
**/
|
|
int32_t GPBGetMessageEnumField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Set the given enum field of a message. You can only set values that are
|
|
* members of the enum.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The enum value to set in the field.
|
|
**/
|
|
void GPBSetMessageEnumField(GPBMessage *self,
|
|
GPBFieldDescriptor *field,
|
|
int32_t value);
|
|
|
|
/**
|
|
* Get the given enum field of a message. No check is done to ensure the value
|
|
* was defined in the enum.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The field to get.
|
|
*
|
|
* @return The raw enum value for the given field.
|
|
**/
|
|
int32_t GPBGetMessageRawEnumField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Set the given enum field of a message. You can set the value to anything,
|
|
* even a value that is not a member of the enum.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param value The raw enum value to set in the field.
|
|
**/
|
|
void GPBSetMessageRawEnumField(GPBMessage *self,
|
|
GPBFieldDescriptor *field,
|
|
int32_t value);
|
|
|
|
// Repeated Fields
|
|
|
|
/**
|
|
* Gets the value of a repeated field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The repeated field to get.
|
|
*
|
|
* @return A GPB*Array or an NSMutableArray based on the field's type.
|
|
**/
|
|
id GPBGetMessageRepeatedField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a repeated field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param array A GPB*Array or NSMutableArray based on the field's type.
|
|
**/
|
|
void GPBSetMessageRepeatedField(GPBMessage *self,
|
|
GPBFieldDescriptor *field,
|
|
id array);
|
|
|
|
// Map Fields
|
|
|
|
/**
|
|
* Gets the value of a map<> field.
|
|
*
|
|
* @param self The message from which to get the field.
|
|
* @param field The repeated field to get.
|
|
*
|
|
* @return A GPB*Dictionary or NSMutableDictionary based on the field's type.
|
|
**/
|
|
id GPBGetMessageMapField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
|
|
/**
|
|
* Sets the value of a map<> field.
|
|
*
|
|
* @param self The message into which to set the field.
|
|
* @param field The field to set.
|
|
* @param dictionary A GPB*Dictionary or NSMutableDictionary based on the
|
|
* field's type.
|
|
**/
|
|
void GPBSetMessageMapField(GPBMessage *self,
|
|
GPBFieldDescriptor *field,
|
|
id dictionary);
|
|
|
|
//%PDDM-EXPAND-END GPB_ACCESSORS()
|
|
|
|
/**
|
|
* Returns an empty NSData to assign to byte fields when you wish to assign them
|
|
* to empty. Prevents allocating a lot of little [NSData data] objects.
|
|
**/
|
|
NSData *GPBEmptyNSData(void) __attribute__((pure));
|
|
|
|
NS_ASSUME_NONNULL_END
|
|
|
|
CF_EXTERN_C_END
|
|
|
|
|
|
//%PDDM-DEFINE GPB_ACCESSORS()
|
|
//%
|
|
//%//
|
|
//%// Get/Set a given field from/to a message.
|
|
//%//
|
|
//%
|
|
//%// Single Fields
|
|
//%
|
|
//%GPB_ACCESSOR_SINGLE_FULL(Bytes, NSData, , *)
|
|
//%GPB_ACCESSOR_SINGLE_FULL(String, NSString, , *)
|
|
//%GPB_ACCESSOR_SINGLE_FULL(Message, GPBMessage, , *)
|
|
//%GPB_ACCESSOR_SINGLE_FULL(Group, GPBMessage, , *)
|
|
//%GPB_ACCESSOR_SINGLE(Bool, BOOL, )
|
|
//%GPB_ACCESSOR_SINGLE(Int32, int32_t, n)
|
|
//%GPB_ACCESSOR_SINGLE(UInt32, uint32_t, n)
|
|
//%GPB_ACCESSOR_SINGLE(Int64, int64_t, n)
|
|
//%GPB_ACCESSOR_SINGLE(UInt64, uint64_t, n)
|
|
//%GPB_ACCESSOR_SINGLE(Float, float, )
|
|
//%GPB_ACCESSOR_SINGLE(Double, double, )
|
|
//%/**
|
|
//% * Gets the given enum field of a message. For proto3, if the value isn't a
|
|
//% * member of the enum, @c kGPBUnrecognizedEnumeratorValue will be returned.
|
|
//% * GPBGetMessageRawEnumField will bypass the check and return whatever value
|
|
//% * was set.
|
|
//% *
|
|
//% * @param self The message from which to get the field.
|
|
//% * @param field The field to get.
|
|
//% *
|
|
//% * @return The enum value for the given field.
|
|
//% **/
|
|
//%int32_t GPBGetMessageEnumField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
//%
|
|
//%/**
|
|
//% * Set the given enum field of a message. You can only set values that are
|
|
//% * members of the enum.
|
|
//% *
|
|
//% * @param self The message into which to set the field.
|
|
//% * @param field The field to set.
|
|
//% * @param value The enum value to set in the field.
|
|
//% **/
|
|
//%void GPBSetMessageEnumField(GPBMessage *self,
|
|
//% GPBFieldDescriptor *field,
|
|
//% int32_t value);
|
|
//%
|
|
//%/**
|
|
//% * Get the given enum field of a message. No check is done to ensure the value
|
|
//% * was defined in the enum.
|
|
//% *
|
|
//% * @param self The message from which to get the field.
|
|
//% * @param field The field to get.
|
|
//% *
|
|
//% * @return The raw enum value for the given field.
|
|
//% **/
|
|
//%int32_t GPBGetMessageRawEnumField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
//%
|
|
//%/**
|
|
//% * Set the given enum field of a message. You can set the value to anything,
|
|
//% * even a value that is not a member of the enum.
|
|
//% *
|
|
//% * @param self The message into which to set the field.
|
|
//% * @param field The field to set.
|
|
//% * @param value The raw enum value to set in the field.
|
|
//% **/
|
|
//%void GPBSetMessageRawEnumField(GPBMessage *self,
|
|
//% GPBFieldDescriptor *field,
|
|
//% int32_t value);
|
|
//%
|
|
//%// Repeated Fields
|
|
//%
|
|
//%/**
|
|
//% * Gets the value of a repeated field.
|
|
//% *
|
|
//% * @param self The message from which to get the field.
|
|
//% * @param field The repeated field to get.
|
|
//% *
|
|
//% * @return A GPB*Array or an NSMutableArray based on the field's type.
|
|
//% **/
|
|
//%id GPBGetMessageRepeatedField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
//%
|
|
//%/**
|
|
//% * Sets the value of a repeated field.
|
|
//% *
|
|
//% * @param self The message into which to set the field.
|
|
//% * @param field The field to set.
|
|
//% * @param array A GPB*Array or NSMutableArray based on the field's type.
|
|
//% **/
|
|
//%void GPBSetMessageRepeatedField(GPBMessage *self,
|
|
//% GPBFieldDescriptor *field,
|
|
//% id array);
|
|
//%
|
|
//%// Map Fields
|
|
//%
|
|
//%/**
|
|
//% * Gets the value of a map<> field.
|
|
//% *
|
|
//% * @param self The message from which to get the field.
|
|
//% * @param field The repeated field to get.
|
|
//% *
|
|
//% * @return A GPB*Dictionary or NSMutableDictionary based on the field's type.
|
|
//% **/
|
|
//%id GPBGetMessageMapField(GPBMessage *self, GPBFieldDescriptor *field);
|
|
//%
|
|
//%/**
|
|
//% * Sets the value of a map<> field.
|
|
//% *
|
|
//% * @param self The message into which to set the field.
|
|
//% * @param field The field to set.
|
|
//% * @param dictionary A GPB*Dictionary or NSMutableDictionary based on the
|
|
//% * field's type.
|
|
//% **/
|
|
//%void GPBSetMessageMapField(GPBMessage *self,
|
|
//% GPBFieldDescriptor *field,
|
|
//% id dictionary);
|
|
//%
|
|
|
|
//%PDDM-DEFINE GPB_ACCESSOR_SINGLE(NAME, TYPE, AN)
|
|
//%GPB_ACCESSOR_SINGLE_FULL(NAME, TYPE, AN, )
|
|
//%PDDM-DEFINE GPB_ACCESSOR_SINGLE_FULL(NAME, TYPE, AN, TisP)
|
|
//%/**
|
|
//% * Gets the value of a##AN NAME$L field.
|
|
//% *
|
|
//% * @param self The message from which to get the field.
|
|
//% * @param field The field to get.
|
|
//% **/
|
|
//%TYPE TisP##GPBGetMessage##NAME##Field(GPBMessage *self, GPBFieldDescriptor *field);
|
|
//%
|
|
//%/**
|
|
//% * Sets the value of a##AN NAME$L field.
|
|
//% *
|
|
//% * @param self The message into which to set the field.
|
|
//% * @param field The field to set.
|
|
//% * @param value The to set in the field.
|
|
//% **/
|
|
//%void GPBSetMessage##NAME##Field(GPBMessage *self, GPBFieldDescriptor *field, TYPE TisP##value);
|
|
//%
|