// Protocol Buffers - Google's data interchange format // Copyright 2015 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 #import "GPBRuntimeTypes.h" NS_ASSUME_NONNULL_BEGIN //%PDDM-EXPAND DECLARE_ARRAYS() // This block of code is generated, do not edit it directly. // clang-format off #pragma mark - Int32 /** * Class used for repeated fields of int32_t values. This performs better than * boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBInt32Array : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** * @return A newly instanced and empty GPBInt32Array. **/ + (instancetype)array; /** * Creates and initializes a GPBInt32Array with the single element given. * * @param value The value to be placed in the array. * * @return A newly instanced GPBInt32Array with value in it. **/ + (instancetype)arrayWithValue:(int32_t)value; /** * Creates and initializes a GPBInt32Array with the contents of the given * array. * * @param array Array with the contents to be put into the new array. * * @return A newly instanced GPBInt32Array with the contents of array. **/ + (instancetype)arrayWithValueArray:(GPBInt32Array *)array; /** * Creates and initializes a GPBInt32Array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly instanced GPBInt32Array with a capacity of count. **/ + (instancetype)arrayWithCapacity:(NSUInteger)count; /** * @return A newly initialized and empty GPBInt32Array. **/ - (instancetype)init NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBInt32Array with a copy of the values. **/ - (instancetype)initWithValues:(const int32_t [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBInt32Array with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBInt32Array *)array; /** * Initializes the array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly initialized GPBInt32Array with a capacity of count. **/ - (instancetype)initWithCapacity:(NSUInteger)count; /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (int32_t)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(int32_t value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(int32_t value, NSUInteger idx, BOOL *stop))block; /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(int32_t)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const int32_t [__nullable])values count:(NSUInteger)count; /** * Adds the values from the given array to this array. * * @param array The array containing the elements to add to this array. **/ - (void)addValuesFromArray:(GPBInt32Array *)array; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(int32_t)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(int32_t)value; /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end #pragma mark - UInt32 /** * Class used for repeated fields of uint32_t values. This performs better than * boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBUInt32Array : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** * @return A newly instanced and empty GPBUInt32Array. **/ + (instancetype)array; /** * Creates and initializes a GPBUInt32Array with the single element given. * * @param value The value to be placed in the array. * * @return A newly instanced GPBUInt32Array with value in it. **/ + (instancetype)arrayWithValue:(uint32_t)value; /** * Creates and initializes a GPBUInt32Array with the contents of the given * array. * * @param array Array with the contents to be put into the new array. * * @return A newly instanced GPBUInt32Array with the contents of array. **/ + (instancetype)arrayWithValueArray:(GPBUInt32Array *)array; /** * Creates and initializes a GPBUInt32Array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly instanced GPBUInt32Array with a capacity of count. **/ + (instancetype)arrayWithCapacity:(NSUInteger)count; /** * @return A newly initialized and empty GPBUInt32Array. **/ - (instancetype)init NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBUInt32Array with a copy of the values. **/ - (instancetype)initWithValues:(const uint32_t [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBUInt32Array with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBUInt32Array *)array; /** * Initializes the array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly initialized GPBUInt32Array with a capacity of count. **/ - (instancetype)initWithCapacity:(NSUInteger)count; /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (uint32_t)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(uint32_t value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(uint32_t value, NSUInteger idx, BOOL *stop))block; /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(uint32_t)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const uint32_t [__nullable])values count:(NSUInteger)count; /** * Adds the values from the given array to this array. * * @param array The array containing the elements to add to this array. **/ - (void)addValuesFromArray:(GPBUInt32Array *)array; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(uint32_t)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(uint32_t)value; /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end #pragma mark - Int64 /** * Class used for repeated fields of int64_t values. This performs better than * boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBInt64Array : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** * @return A newly instanced and empty GPBInt64Array. **/ + (instancetype)array; /** * Creates and initializes a GPBInt64Array with the single element given. * * @param value The value to be placed in the array. * * @return A newly instanced GPBInt64Array with value in it. **/ + (instancetype)arrayWithValue:(int64_t)value; /** * Creates and initializes a GPBInt64Array with the contents of the given * array. * * @param array Array with the contents to be put into the new array. * * @return A newly instanced GPBInt64Array with the contents of array. **/ + (instancetype)arrayWithValueArray:(GPBInt64Array *)array; /** * Creates and initializes a GPBInt64Array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly instanced GPBInt64Array with a capacity of count. **/ + (instancetype)arrayWithCapacity:(NSUInteger)count; /** * @return A newly initialized and empty GPBInt64Array. **/ - (instancetype)init NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBInt64Array with a copy of the values. **/ - (instancetype)initWithValues:(const int64_t [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBInt64Array with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBInt64Array *)array; /** * Initializes the array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly initialized GPBInt64Array with a capacity of count. **/ - (instancetype)initWithCapacity:(NSUInteger)count; /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (int64_t)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(int64_t value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(int64_t value, NSUInteger idx, BOOL *stop))block; /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(int64_t)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const int64_t [__nullable])values count:(NSUInteger)count; /** * Adds the values from the given array to this array. * * @param array The array containing the elements to add to this array. **/ - (void)addValuesFromArray:(GPBInt64Array *)array; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(int64_t)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(int64_t)value; /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end #pragma mark - UInt64 /** * Class used for repeated fields of uint64_t values. This performs better than * boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBUInt64Array : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** * @return A newly instanced and empty GPBUInt64Array. **/ + (instancetype)array; /** * Creates and initializes a GPBUInt64Array with the single element given. * * @param value The value to be placed in the array. * * @return A newly instanced GPBUInt64Array with value in it. **/ + (instancetype)arrayWithValue:(uint64_t)value; /** * Creates and initializes a GPBUInt64Array with the contents of the given * array. * * @param array Array with the contents to be put into the new array. * * @return A newly instanced GPBUInt64Array with the contents of array. **/ + (instancetype)arrayWithValueArray:(GPBUInt64Array *)array; /** * Creates and initializes a GPBUInt64Array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly instanced GPBUInt64Array with a capacity of count. **/ + (instancetype)arrayWithCapacity:(NSUInteger)count; /** * @return A newly initialized and empty GPBUInt64Array. **/ - (instancetype)init NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBUInt64Array with a copy of the values. **/ - (instancetype)initWithValues:(const uint64_t [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBUInt64Array with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBUInt64Array *)array; /** * Initializes the array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly initialized GPBUInt64Array with a capacity of count. **/ - (instancetype)initWithCapacity:(NSUInteger)count; /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (uint64_t)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(uint64_t value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(uint64_t value, NSUInteger idx, BOOL *stop))block; /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(uint64_t)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const uint64_t [__nullable])values count:(NSUInteger)count; /** * Adds the values from the given array to this array. * * @param array The array containing the elements to add to this array. **/ - (void)addValuesFromArray:(GPBUInt64Array *)array; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(uint64_t)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(uint64_t)value; /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end #pragma mark - Float /** * Class used for repeated fields of float values. This performs better than * boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBFloatArray : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** * @return A newly instanced and empty GPBFloatArray. **/ + (instancetype)array; /** * Creates and initializes a GPBFloatArray with the single element given. * * @param value The value to be placed in the array. * * @return A newly instanced GPBFloatArray with value in it. **/ + (instancetype)arrayWithValue:(float)value; /** * Creates and initializes a GPBFloatArray with the contents of the given * array. * * @param array Array with the contents to be put into the new array. * * @return A newly instanced GPBFloatArray with the contents of array. **/ + (instancetype)arrayWithValueArray:(GPBFloatArray *)array; /** * Creates and initializes a GPBFloatArray with the given capacity. * * @param count The capacity needed for the array. * * @return A newly instanced GPBFloatArray with a capacity of count. **/ + (instancetype)arrayWithCapacity:(NSUInteger)count; /** * @return A newly initialized and empty GPBFloatArray. **/ - (instancetype)init NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBFloatArray with a copy of the values. **/ - (instancetype)initWithValues:(const float [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBFloatArray with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBFloatArray *)array; /** * Initializes the array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly initialized GPBFloatArray with a capacity of count. **/ - (instancetype)initWithCapacity:(NSUInteger)count; /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (float)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(float value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(float value, NSUInteger idx, BOOL *stop))block; /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(float)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const float [__nullable])values count:(NSUInteger)count; /** * Adds the values from the given array to this array. * * @param array The array containing the elements to add to this array. **/ - (void)addValuesFromArray:(GPBFloatArray *)array; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(float)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(float)value; /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end #pragma mark - Double /** * Class used for repeated fields of double values. This performs better than * boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBDoubleArray : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** * @return A newly instanced and empty GPBDoubleArray. **/ + (instancetype)array; /** * Creates and initializes a GPBDoubleArray with the single element given. * * @param value The value to be placed in the array. * * @return A newly instanced GPBDoubleArray with value in it. **/ + (instancetype)arrayWithValue:(double)value; /** * Creates and initializes a GPBDoubleArray with the contents of the given * array. * * @param array Array with the contents to be put into the new array. * * @return A newly instanced GPBDoubleArray with the contents of array. **/ + (instancetype)arrayWithValueArray:(GPBDoubleArray *)array; /** * Creates and initializes a GPBDoubleArray with the given capacity. * * @param count The capacity needed for the array. * * @return A newly instanced GPBDoubleArray with a capacity of count. **/ + (instancetype)arrayWithCapacity:(NSUInteger)count; /** * @return A newly initialized and empty GPBDoubleArray. **/ - (instancetype)init NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBDoubleArray with a copy of the values. **/ - (instancetype)initWithValues:(const double [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBDoubleArray with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBDoubleArray *)array; /** * Initializes the array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly initialized GPBDoubleArray with a capacity of count. **/ - (instancetype)initWithCapacity:(NSUInteger)count; /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (double)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(double value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(double value, NSUInteger idx, BOOL *stop))block; /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(double)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const double [__nullable])values count:(NSUInteger)count; /** * Adds the values from the given array to this array. * * @param array The array containing the elements to add to this array. **/ - (void)addValuesFromArray:(GPBDoubleArray *)array; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(double)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(double)value; /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end #pragma mark - Bool /** * Class used for repeated fields of BOOL values. This performs better than * boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBBoolArray : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** * @return A newly instanced and empty GPBBoolArray. **/ + (instancetype)array; /** * Creates and initializes a GPBBoolArray with the single element given. * * @param value The value to be placed in the array. * * @return A newly instanced GPBBoolArray with value in it. **/ + (instancetype)arrayWithValue:(BOOL)value; /** * Creates and initializes a GPBBoolArray with the contents of the given * array. * * @param array Array with the contents to be put into the new array. * * @return A newly instanced GPBBoolArray with the contents of array. **/ + (instancetype)arrayWithValueArray:(GPBBoolArray *)array; /** * Creates and initializes a GPBBoolArray with the given capacity. * * @param count The capacity needed for the array. * * @return A newly instanced GPBBoolArray with a capacity of count. **/ + (instancetype)arrayWithCapacity:(NSUInteger)count; /** * @return A newly initialized and empty GPBBoolArray. **/ - (instancetype)init NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBBoolArray with a copy of the values. **/ - (instancetype)initWithValues:(const BOOL [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBBoolArray with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBBoolArray *)array; /** * Initializes the array with the given capacity. * * @param count The capacity needed for the array. * * @return A newly initialized GPBBoolArray with a capacity of count. **/ - (instancetype)initWithCapacity:(NSUInteger)count; /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (BOOL)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(BOOL value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(BOOL value, NSUInteger idx, BOOL *stop))block; /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(BOOL)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const BOOL [__nullable])values count:(NSUInteger)count; /** * Adds the values from the given array to this array. * * @param array The array containing the elements to add to this array. **/ - (void)addValuesFromArray:(GPBBoolArray *)array; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(BOOL)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(BOOL)value; /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end #pragma mark - Enum /** * This class is used for repeated fields of int32_t values. This performs * better than boxing into NSNumbers in NSArrays. * * @note This class is not meant to be subclassed. **/ @interface GPBEnumArray : NSObject /** The number of elements contained in the array. */ @property(nonatomic, readonly) NSUInteger count; /** The validation function to check if the enums are valid. */ @property(nonatomic, readonly) GPBEnumValidationFunc validationFunc; /** * @return A newly instanced and empty GPBEnumArray. **/ + (instancetype)array; /** * Creates and initializes a GPBEnumArray with the enum validation function * given. * * @param func The enum validation function for the array. * * @return A newly instanced GPBEnumArray. **/ + (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func; /** * Creates and initializes a GPBEnumArray with the enum validation function * given and the single raw value given. * * @param func The enum validation function for the array. * @param value The raw value to add to this array. * * @return A newly instanced GPBEnumArray. **/ + (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func rawValue:(int32_t)value; /** * Creates and initializes a GPBEnumArray that adds the elements from the * given array. * * @param array Array containing the values to add to the new array. * * @return A newly instanced GPBEnumArray. **/ + (instancetype)arrayWithValueArray:(GPBEnumArray *)array; /** * Creates and initializes a GPBEnumArray with the given enum validation * function and with the givencapacity. * * @param func The enum validation function for the array. * @param count The capacity needed for the array. * * @return A newly instanced GPBEnumArray with a capacity of count. **/ + (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func capacity:(NSUInteger)count; /** * Initializes the array with the given enum validation function. * * @param func The enum validation function for the array. * * @return A newly initialized GPBEnumArray with a copy of the values. **/ - (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func NS_DESIGNATED_INITIALIZER; /** * Initializes the array, copying the given values. * * @param func The enum validation function for the array. * @param values An array with the values to put inside this array. * @param count The number of elements to copy into the array. * * @return A newly initialized GPBEnumArray with a copy of the values. **/ - (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func rawValues:(const int32_t [__nullable])values count:(NSUInteger)count; /** * Initializes the array, copying the given values. * * @param array An array with the values to put inside this array. * * @return A newly initialized GPBEnumArray with a copy of the values. **/ - (instancetype)initWithValueArray:(GPBEnumArray *)array; /** * Initializes the array with the given capacity. * * @param func The enum validation function for the array. * @param count The capacity needed for the array. * * @return A newly initialized GPBEnumArray with a capacity of count. **/ - (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func capacity:(NSUInteger)count; // These will return kGPBUnrecognizedEnumeratorValue if the value at index is not a // valid enumerator as defined by validationFunc. If the actual value is // desired, use "raw" version of the method. /** * Gets the value at the given index. * * @param index The index of the value to get. * * @return The value at the given index. **/ - (int32_t)valueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(int32_t value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(int32_t value, NSUInteger idx, BOOL *stop))block; // These methods bypass the validationFunc to provide access to values that were not // known at the time the binary was compiled. /** * Gets the raw enum value at the given index. * * @param index The index of the raw enum value to get. * * @return The raw enum value at the given index. **/ - (int32_t)rawValueAtIndex:(NSUInteger)index; /** * Enumerates the values on this array with the given block. * * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateRawValuesWithBlock:(void (NS_NOESCAPE ^)(int32_t value, NSUInteger idx, BOOL *stop))block; /** * Enumerates the values on this array with the given block. * * @param opts Options to control the enumeration. * @param block The block to enumerate with. * **value**: The current value being enumerated. * **idx**: The index of the current value. * **stop**: A pointer to a boolean that when set stops the enumeration. **/ - (void)enumerateRawValuesWithOptions:(NSEnumerationOptions)opts usingBlock:(void (NS_NOESCAPE ^)(int32_t value, NSUInteger idx, BOOL *stop))block; // If value is not a valid enumerator as defined by validationFunc, these // methods will assert in debug, and will log in release and assign the value // to the default value. Use the rawValue methods below to assign non enumerator // values. /** * Adds a value to this array. * * @param value The value to add to this array. **/ - (void)addValue:(int32_t)value; /** * Adds values to this array. * * @param values The values to add to this array. * @param count The number of elements to add. **/ - (void)addValues:(const int32_t [__nullable])values count:(NSUInteger)count; /** * Inserts a value into the given position. * * @param value The value to add to this array. * @param index The index into which to insert the value. **/ - (void)insertValue:(int32_t)value atIndex:(NSUInteger)index; /** * Replaces the value at the given index with the given value. * * @param index The index for which to replace the value. * @param value The value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withValue:(int32_t)value; // These methods bypass the validationFunc to provide setting of values that were not // known at the time the binary was compiled. /** * Adds a raw enum value to this array. * * @note This method bypass the validationFunc to enable the setting of values that * were not known at the time the binary was compiled. * * @param value The raw enum value to add to the array. **/ - (void)addRawValue:(int32_t)value; /** * Adds raw enum values to this array. * * @note This method bypass the validationFunc to enable the setting of values that * were not known at the time the binary was compiled. * * @param array Array containing the raw enum values to add to this array. **/ - (void)addRawValuesFromArray:(GPBEnumArray *)array; /** * Adds raw enum values to this array. * * @note This method bypass the validationFunc to enable the setting of values that * were not known at the time the binary was compiled. * * @param values Array containing the raw enum values to add to this array. * @param count The number of raw values to add. **/ - (void)addRawValues:(const int32_t [__nullable])values count:(NSUInteger)count; /** * Inserts a raw enum value at the given index. * * @note This method bypass the validationFunc to enable the setting of values that * were not known at the time the binary was compiled. * * @param value Raw enum value to add. * @param index The index into which to insert the value. **/ - (void)insertRawValue:(int32_t)value atIndex:(NSUInteger)index; /** * Replaces the raw enum value at the given index with the given value. * * @note This method bypass the validationFunc to enable the setting of values that * were not known at the time the binary was compiled. * * @param index The index for which to replace the value. * @param value The raw enum value to replace with. **/ - (void)replaceValueAtIndex:(NSUInteger)index withRawValue:(int32_t)value; // No validation applies to these methods. /** * Removes the value at the given index. * * @param index The index of the value to remove. **/ - (void)removeValueAtIndex:(NSUInteger)index; /** * Removes all the values from this array. **/ - (void)removeAll; /** * Exchanges the values between the given indexes. * * @param idx1 The index of the first element to exchange. * @param idx2 The index of the second element to exchange. **/ - (void)exchangeValueAtIndex:(NSUInteger)idx1 withValueAtIndex:(NSUInteger)idx2; @end // clang-format on //%PDDM-EXPAND-END DECLARE_ARRAYS() NS_ASSUME_NONNULL_END //%PDDM-DEFINE DECLARE_ARRAYS() //%ARRAY_INTERFACE_SIMPLE(Int32, int32_t) //%ARRAY_INTERFACE_SIMPLE(UInt32, uint32_t) //%ARRAY_INTERFACE_SIMPLE(Int64, int64_t) //%ARRAY_INTERFACE_SIMPLE(UInt64, uint64_t) //%ARRAY_INTERFACE_SIMPLE(Float, float) //%ARRAY_INTERFACE_SIMPLE(Double, double) //%ARRAY_INTERFACE_SIMPLE(Bool, BOOL) //%ARRAY_INTERFACE_ENUM(Enum, int32_t) // // The common case (everything but Enum) // //%PDDM-DEFINE ARRAY_INTERFACE_SIMPLE(NAME, TYPE) //%#pragma mark - NAME //% //%/** //% * Class used for repeated fields of ##TYPE## values. This performs better than //% * boxing into NSNumbers in NSArrays. //% * //% * @note This class is not meant to be subclassed. //% **/ //%@interface GPB##NAME##Array : NSObject //% //%/** The number of elements contained in the array. */ //%@property(nonatomic, readonly) NSUInteger count; //% //%/** //% * @return A newly instanced and empty GPB##NAME##Array. //% **/ //%+ (instancetype)array; //% //%/** //% * Creates and initializes a GPB##NAME##Array with the single element given. //% * //% * @param value The value to be placed in the array. //% * //% * @return A newly instanced GPB##NAME##Array with value in it. //% **/ //%+ (instancetype)arrayWithValue:(TYPE)value; //% //%/** //% * Creates and initializes a GPB##NAME##Array with the contents of the given //% * array. //% * //% * @param array Array with the contents to be put into the new array. //% * //% * @return A newly instanced GPB##NAME##Array with the contents of array. //% **/ //%+ (instancetype)arrayWithValueArray:(GPB##NAME##Array *)array; //% //%/** //% * Creates and initializes a GPB##NAME##Array with the given capacity. //% * //% * @param count The capacity needed for the array. //% * //% * @return A newly instanced GPB##NAME##Array with a capacity of count. //% **/ //%+ (instancetype)arrayWithCapacity:(NSUInteger)count; //% //%/** //% * @return A newly initialized and empty GPB##NAME##Array. //% **/ //%- (instancetype)init NS_DESIGNATED_INITIALIZER; //% //%/** //% * Initializes the array, copying the given values. //% * //% * @param values An array with the values to put inside this array. //% * @param count The number of elements to copy into the array. //% * //% * @return A newly initialized GPB##NAME##Array with a copy of the values. //% **/ //%- (instancetype)initWithValues:(const TYPE [__nullable])values //% count:(NSUInteger)count; //% //%/** //% * Initializes the array, copying the given values. //% * //% * @param array An array with the values to put inside this array. //% * //% * @return A newly initialized GPB##NAME##Array with a copy of the values. //% **/ //%- (instancetype)initWithValueArray:(GPB##NAME##Array *)array; //% //%/** //% * Initializes the array with the given capacity. //% * //% * @param count The capacity needed for the array. //% * //% * @return A newly initialized GPB##NAME##Array with a capacity of count. //% **/ //%- (instancetype)initWithCapacity:(NSUInteger)count; //% //%ARRAY_IMMUTABLE_INTERFACE(NAME, TYPE, Basic) //% //%ARRAY_MUTABLE_INTERFACE(NAME, TYPE, Basic) //% //%@end //% // // Macros specific to Enums (to tweak their interface). // //%PDDM-DEFINE ARRAY_INTERFACE_ENUM(NAME, TYPE) //%#pragma mark - NAME //% //%/** //% * This class is used for repeated fields of ##TYPE## values. This performs //% * better than boxing into NSNumbers in NSArrays. //% * //% * @note This class is not meant to be subclassed. //% **/ //%@interface GPB##NAME##Array : NSObject //% //%/** The number of elements contained in the array. */ //%@property(nonatomic, readonly) NSUInteger count; //%/** The validation function to check if the enums are valid. */ //%@property(nonatomic, readonly) GPBEnumValidationFunc validationFunc; //% //%/** //% * @return A newly instanced and empty GPB##NAME##Array. //% **/ //%+ (instancetype)array; //% //%/** //% * Creates and initializes a GPB##NAME##Array with the enum validation function //% * given. //% * //% * @param func The enum validation function for the array. //% * //% * @return A newly instanced GPB##NAME##Array. //% **/ //%+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func; //% //%/** //% * Creates and initializes a GPB##NAME##Array with the enum validation function //% * given and the single raw value given. //% * //% * @param func The enum validation function for the array. //% * @param value The raw value to add to this array. //% * //% * @return A newly instanced GPB##NAME##Array. //% **/ //%+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func //% rawValue:(TYPE)value; //% //%/** //% * Creates and initializes a GPB##NAME##Array that adds the elements from the //% * given array. //% * //% * @param array Array containing the values to add to the new array. //% * //% * @return A newly instanced GPB##NAME##Array. //% **/ //%+ (instancetype)arrayWithValueArray:(GPB##NAME##Array *)array; //% //%/** //% * Creates and initializes a GPB##NAME##Array with the given enum validation //% * function and with the givencapacity. //% * //% * @param func The enum validation function for the array. //% * @param count The capacity needed for the array. //% * //% * @return A newly instanced GPB##NAME##Array with a capacity of count. //% **/ //%+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func //% capacity:(NSUInteger)count; //% //%/** //% * Initializes the array with the given enum validation function. //% * //% * @param func The enum validation function for the array. //% * //% * @return A newly initialized GPB##NAME##Array with a copy of the values. //% **/ //%- (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func //% NS_DESIGNATED_INITIALIZER; //% //%/** //% * Initializes the array, copying the given values. //% * //% * @param func The enum validation function for the array. //% * @param values An array with the values to put inside this array. //% * @param count The number of elements to copy into the array. //% * //% * @return A newly initialized GPB##NAME##Array with a copy of the values. //% **/ //%- (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func //% rawValues:(const TYPE [__nullable])values //% count:(NSUInteger)count; //% //%/** //% * Initializes the array, copying the given values. //% * //% * @param array An array with the values to put inside this array. //% * //% * @return A newly initialized GPB##NAME##Array with a copy of the values. //% **/ //%- (instancetype)initWithValueArray:(GPB##NAME##Array *)array; //% //%/** //% * Initializes the array with the given capacity. //% * //% * @param func The enum validation function for the array. //% * @param count The capacity needed for the array. //% * //% * @return A newly initialized GPB##NAME##Array with a capacity of count. //% **/ //%- (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func //% capacity:(NSUInteger)count; //% //%// These will return kGPBUnrecognizedEnumeratorValue if the value at index is not a //%// valid enumerator as defined by validationFunc. If the actual value is //%// desired, use "raw" version of the method. //% //%ARRAY_IMMUTABLE_INTERFACE(NAME, TYPE, NAME) //% //%// These methods bypass the validationFunc to provide access to values that were not //%// known at the time the binary was compiled. //% //%/** //% * Gets the raw enum value at the given index. //% * //% * @param index The index of the raw enum value to get. //% * //% * @return The raw enum value at the given index. //% **/ //%- (TYPE)rawValueAtIndex:(NSUInteger)index; //% //%/** //% * Enumerates the values on this array with the given block. //% * //% * @param block The block to enumerate with. //% * **value**: The current value being enumerated. //% * **idx**: The index of the current value. //% * **stop**: A pointer to a boolean that when set stops the enumeration. //% **/ //%- (void)enumerateRawValuesWithBlock:(void (NS_NOESCAPE ^)(TYPE value, NSUInteger idx, BOOL *stop))block; //% //%/** //% * Enumerates the values on this array with the given block. //% * //% * @param opts Options to control the enumeration. //% * @param block The block to enumerate with. //% * **value**: The current value being enumerated. //% * **idx**: The index of the current value. //% * **stop**: A pointer to a boolean that when set stops the enumeration. //% **/ //%- (void)enumerateRawValuesWithOptions:(NSEnumerationOptions)opts //% usingBlock:(void (NS_NOESCAPE ^)(TYPE value, NSUInteger idx, BOOL *stop))block; //% //%// If value is not a valid enumerator as defined by validationFunc, these //%// methods will assert in debug, and will log in release and assign the value //%// to the default value. Use the rawValue methods below to assign non enumerator //%// values. //% //%ARRAY_MUTABLE_INTERFACE(NAME, TYPE, NAME) //% //%@end //% //%PDDM-DEFINE ARRAY_IMMUTABLE_INTERFACE(NAME, TYPE, HELPER_NAME) //%/** //% * Gets the value at the given index. //% * //% * @param index The index of the value to get. //% * //% * @return The value at the given index. //% **/ //%- (TYPE)valueAtIndex:(NSUInteger)index; //% //%/** //% * Enumerates the values on this array with the given block. //% * //% * @param block The block to enumerate with. //% * **value**: The current value being enumerated. //% * **idx**: The index of the current value. //% * **stop**: A pointer to a boolean that when set stops the enumeration. //% **/ //%- (void)enumerateValuesWithBlock:(void (NS_NOESCAPE ^)(TYPE value, NSUInteger idx, BOOL *stop))block; //% //%/** //% * Enumerates the values on this array with the given block. //% * //% * @param opts Options to control the enumeration. //% * @param block The block to enumerate with. //% * **value**: The current value being enumerated. //% * **idx**: The index of the current value. //% * **stop**: A pointer to a boolean that when set stops the enumeration. //% **/ //%- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts //% usingBlock:(void (NS_NOESCAPE ^)(TYPE value, NSUInteger idx, BOOL *stop))block; //%PDDM-DEFINE ARRAY_MUTABLE_INTERFACE(NAME, TYPE, HELPER_NAME) //%/** //% * Adds a value to this array. //% * //% * @param value The value to add to this array. //% **/ //%- (void)addValue:(TYPE)value; //% //%/** //% * Adds values to this array. //% * //% * @param values The values to add to this array. //% * @param count The number of elements to add. //% **/ //%- (void)addValues:(const TYPE [__nullable])values count:(NSUInteger)count; //% //%ARRAY_EXTRA_MUTABLE_METHODS1_##HELPER_NAME(NAME, TYPE) //%/** //% * Inserts a value into the given position. //% * //% * @param value The value to add to this array. //% * @param index The index into which to insert the value. //% **/ //%- (void)insertValue:(TYPE)value atIndex:(NSUInteger)index; //% //%/** //% * Replaces the value at the given index with the given value. //% * //% * @param index The index for which to replace the value. //% * @param value The value to replace with. //% **/ //%- (void)replaceValueAtIndex:(NSUInteger)index withValue:(TYPE)value; //%ARRAY_EXTRA_MUTABLE_METHODS2_##HELPER_NAME(NAME, TYPE) //%/** //% * Removes the value at the given index. //% * //% * @param index The index of the value to remove. //% **/ //%- (void)removeValueAtIndex:(NSUInteger)index; //% //%/** //% * Removes all the values from this array. //% **/ //%- (void)removeAll; //% //%/** //% * Exchanges the values between the given indexes. //% * //% * @param idx1 The index of the first element to exchange. //% * @param idx2 The index of the second element to exchange. //% **/ //%- (void)exchangeValueAtIndex:(NSUInteger)idx1 //% withValueAtIndex:(NSUInteger)idx2; // // These are hooks invoked by the above to do insert as needed. // //%PDDM-DEFINE ARRAY_EXTRA_MUTABLE_METHODS1_Basic(NAME, TYPE) //%/** //% * Adds the values from the given array to this array. //% * //% * @param array The array containing the elements to add to this array. //% **/ //%- (void)addValuesFromArray:(GPB##NAME##Array *)array; //% //%PDDM-DEFINE ARRAY_EXTRA_MUTABLE_METHODS2_Basic(NAME, TYPE) // Empty //%PDDM-DEFINE ARRAY_EXTRA_MUTABLE_METHODS1_Enum(NAME, TYPE) // Empty //%PDDM-DEFINE ARRAY_EXTRA_MUTABLE_METHODS2_Enum(NAME, TYPE) //% //%// These methods bypass the validationFunc to provide setting of values that were not //%// known at the time the binary was compiled. //% //%/** //% * Adds a raw enum value to this array. //% * //% * @note This method bypass the validationFunc to enable the setting of values that //% * were not known at the time the binary was compiled. //% * //% * @param value The raw enum value to add to the array. //% **/ //%- (void)addRawValue:(TYPE)value; //% //%/** //% * Adds raw enum values to this array. //% * //% * @note This method bypass the validationFunc to enable the setting of values that //% * were not known at the time the binary was compiled. //% * //% * @param array Array containing the raw enum values to add to this array. //% **/ //%- (void)addRawValuesFromArray:(GPB##NAME##Array *)array; //% //%/** //% * Adds raw enum values to this array. //% * //% * @note This method bypass the validationFunc to enable the setting of values that //% * were not known at the time the binary was compiled. //% * //% * @param values Array containing the raw enum values to add to this array. //% * @param count The number of raw values to add. //% **/ //%- (void)addRawValues:(const TYPE [__nullable])values count:(NSUInteger)count; //% //%/** //% * Inserts a raw enum value at the given index. //% * //% * @note This method bypass the validationFunc to enable the setting of values that //% * were not known at the time the binary was compiled. //% * //% * @param value Raw enum value to add. //% * @param index The index into which to insert the value. //% **/ //%- (void)insertRawValue:(TYPE)value atIndex:(NSUInteger)index; //% //%/** //% * Replaces the raw enum value at the given index with the given value. //% * //% * @note This method bypass the validationFunc to enable the setting of values that //% * were not known at the time the binary was compiled. //% * //% * @param index The index for which to replace the value. //% * @param value The raw enum value to replace with. //% **/ //%- (void)replaceValueAtIndex:(NSUInteger)index withRawValue:(TYPE)value; //% //%// No validation applies to these methods. //%