diff options
Diffstat (limited to 'objectivec/GPBArray.h')
| -rw-r--r-- | objectivec/GPBArray.h | 549 |
1 files changed, 0 insertions, 549 deletions
diff --git a/objectivec/GPBArray.h b/objectivec/GPBArray.h deleted file mode 100644 index afda57f3..00000000 --- a/objectivec/GPBArray.h +++ /dev/null @@ -1,549 +0,0 @@ -// 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 <Foundation/Foundation.h> - -#import "GPBRuntimeTypes.h" - -// These classes are used for repeated fields of basic data types. They are used because -// they perform better than boxing into NSNumbers in NSArrays. - -// Note: These are not meant to be subclassed. - -NS_ASSUME_NONNULL_BEGIN - -//%PDDM-EXPAND DECLARE_ARRAYS() -// This block of code is generated, do not edit it directly. - -#pragma mark - Int32 - -@interface GPBInt32Array : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; - -+ (instancetype)array; -+ (instancetype)arrayWithValue:(int32_t)value; -+ (instancetype)arrayWithValueArray:(GPBInt32Array *)array; -+ (instancetype)arrayWithCapacity:(NSUInteger)count; - -- (instancetype)init NS_DESIGNATED_INITIALIZER; -// Initializes the array, copying the values. -- (instancetype)initWithValues:(const int32_t [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBInt32Array *)array; -- (instancetype)initWithCapacity:(NSUInteger)count; - -- (int32_t)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(int32_t value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(int32_t value, NSUInteger idx, BOOL *stop))block; - -- (void)addValue:(int32_t)value; -- (void)addValues:(const int32_t [])values count:(NSUInteger)count; -- (void)addValuesFromArray:(GPBInt32Array *)array; - -- (void)insertValue:(int32_t)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withValue:(int32_t)value; - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -#pragma mark - UInt32 - -@interface GPBUInt32Array : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; - -+ (instancetype)array; -+ (instancetype)arrayWithValue:(uint32_t)value; -+ (instancetype)arrayWithValueArray:(GPBUInt32Array *)array; -+ (instancetype)arrayWithCapacity:(NSUInteger)count; - -- (instancetype)init NS_DESIGNATED_INITIALIZER; -// Initializes the array, copying the values. -- (instancetype)initWithValues:(const uint32_t [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBUInt32Array *)array; -- (instancetype)initWithCapacity:(NSUInteger)count; - -- (uint32_t)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(uint32_t value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(uint32_t value, NSUInteger idx, BOOL *stop))block; - -- (void)addValue:(uint32_t)value; -- (void)addValues:(const uint32_t [])values count:(NSUInteger)count; -- (void)addValuesFromArray:(GPBUInt32Array *)array; - -- (void)insertValue:(uint32_t)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withValue:(uint32_t)value; - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -#pragma mark - Int64 - -@interface GPBInt64Array : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; - -+ (instancetype)array; -+ (instancetype)arrayWithValue:(int64_t)value; -+ (instancetype)arrayWithValueArray:(GPBInt64Array *)array; -+ (instancetype)arrayWithCapacity:(NSUInteger)count; - -- (instancetype)init NS_DESIGNATED_INITIALIZER; -// Initializes the array, copying the values. -- (instancetype)initWithValues:(const int64_t [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBInt64Array *)array; -- (instancetype)initWithCapacity:(NSUInteger)count; - -- (int64_t)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(int64_t value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(int64_t value, NSUInteger idx, BOOL *stop))block; - -- (void)addValue:(int64_t)value; -- (void)addValues:(const int64_t [])values count:(NSUInteger)count; -- (void)addValuesFromArray:(GPBInt64Array *)array; - -- (void)insertValue:(int64_t)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withValue:(int64_t)value; - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -#pragma mark - UInt64 - -@interface GPBUInt64Array : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; - -+ (instancetype)array; -+ (instancetype)arrayWithValue:(uint64_t)value; -+ (instancetype)arrayWithValueArray:(GPBUInt64Array *)array; -+ (instancetype)arrayWithCapacity:(NSUInteger)count; - -- (instancetype)init NS_DESIGNATED_INITIALIZER; -// Initializes the array, copying the values. -- (instancetype)initWithValues:(const uint64_t [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBUInt64Array *)array; -- (instancetype)initWithCapacity:(NSUInteger)count; - -- (uint64_t)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(uint64_t value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(uint64_t value, NSUInteger idx, BOOL *stop))block; - -- (void)addValue:(uint64_t)value; -- (void)addValues:(const uint64_t [])values count:(NSUInteger)count; -- (void)addValuesFromArray:(GPBUInt64Array *)array; - -- (void)insertValue:(uint64_t)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withValue:(uint64_t)value; - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -#pragma mark - Float - -@interface GPBFloatArray : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; - -+ (instancetype)array; -+ (instancetype)arrayWithValue:(float)value; -+ (instancetype)arrayWithValueArray:(GPBFloatArray *)array; -+ (instancetype)arrayWithCapacity:(NSUInteger)count; - -- (instancetype)init NS_DESIGNATED_INITIALIZER; -// Initializes the array, copying the values. -- (instancetype)initWithValues:(const float [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBFloatArray *)array; -- (instancetype)initWithCapacity:(NSUInteger)count; - -- (float)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(float value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(float value, NSUInteger idx, BOOL *stop))block; - -- (void)addValue:(float)value; -- (void)addValues:(const float [])values count:(NSUInteger)count; -- (void)addValuesFromArray:(GPBFloatArray *)array; - -- (void)insertValue:(float)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withValue:(float)value; - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -#pragma mark - Double - -@interface GPBDoubleArray : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; - -+ (instancetype)array; -+ (instancetype)arrayWithValue:(double)value; -+ (instancetype)arrayWithValueArray:(GPBDoubleArray *)array; -+ (instancetype)arrayWithCapacity:(NSUInteger)count; - -- (instancetype)init NS_DESIGNATED_INITIALIZER; -// Initializes the array, copying the values. -- (instancetype)initWithValues:(const double [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBDoubleArray *)array; -- (instancetype)initWithCapacity:(NSUInteger)count; - -- (double)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(double value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(double value, NSUInteger idx, BOOL *stop))block; - -- (void)addValue:(double)value; -- (void)addValues:(const double [])values count:(NSUInteger)count; -- (void)addValuesFromArray:(GPBDoubleArray *)array; - -- (void)insertValue:(double)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withValue:(double)value; - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -#pragma mark - Bool - -@interface GPBBoolArray : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; - -+ (instancetype)array; -+ (instancetype)arrayWithValue:(BOOL)value; -+ (instancetype)arrayWithValueArray:(GPBBoolArray *)array; -+ (instancetype)arrayWithCapacity:(NSUInteger)count; - -- (instancetype)init NS_DESIGNATED_INITIALIZER; -// Initializes the array, copying the values. -- (instancetype)initWithValues:(const BOOL [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBBoolArray *)array; -- (instancetype)initWithCapacity:(NSUInteger)count; - -- (BOOL)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(BOOL value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(BOOL value, NSUInteger idx, BOOL *stop))block; - -- (void)addValue:(BOOL)value; -- (void)addValues:(const BOOL [])values count:(NSUInteger)count; -- (void)addValuesFromArray:(GPBBoolArray *)array; - -- (void)insertValue:(BOOL)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withValue:(BOOL)value; - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -#pragma mark - Enum - -@interface GPBEnumArray : NSObject <NSCopying> - -@property(nonatomic, readonly) NSUInteger count; -@property(nonatomic, readonly) GPBEnumValidationFunc validationFunc; - -+ (instancetype)array; -+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func; -+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func - rawValue:(int32_t)value; -+ (instancetype)arrayWithValueArray:(GPBEnumArray *)array; -+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func - capacity:(NSUInteger)count; - -- (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func - NS_DESIGNATED_INITIALIZER; - -// Initializes the array, copying the values. -- (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func - rawValues:(const int32_t [])values - count:(NSUInteger)count; -- (instancetype)initWithValueArray:(GPBEnumArray *)array; -- (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. - -- (int32_t)valueAtIndex:(NSUInteger)index; - -- (void)enumerateValuesWithBlock:(void (^)(int32_t value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(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. - -- (int32_t)rawValueAtIndex:(NSUInteger)index; - -- (void)enumerateRawValuesWithBlock:(void (^)(int32_t value, NSUInteger idx, BOOL *stop))block; -- (void)enumerateRawValuesWithOptions:(NSEnumerationOptions)opts - usingBlock:(void (^)(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. - -- (void)addValue:(int32_t)value; -- (void)addValues:(const int32_t [])values count:(NSUInteger)count; - -- (void)insertValue:(int32_t)value atIndex:(NSUInteger)index; - -- (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. - -- (void)addRawValue:(int32_t)value; -- (void)addRawValuesFromArray:(GPBEnumArray *)array; -- (void)addRawValues:(const int32_t [])values count:(NSUInteger)count; - -- (void)insertRawValue:(int32_t)value atIndex:(NSUInteger)index; - -- (void)replaceValueAtIndex:(NSUInteger)index withRawValue:(int32_t)value; - -// No validation applies to these methods. - -- (void)removeValueAtIndex:(NSUInteger)index; -- (void)removeAll; - -- (void)exchangeValueAtIndex:(NSUInteger)idx1 - withValueAtIndex:(NSUInteger)idx2; - -@end - -//%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 -//% -//%@interface GPB##NAME##Array : NSObject <NSCopying> -//% -//%@property(nonatomic, readonly) NSUInteger count; -//% -//%+ (instancetype)array; -//%+ (instancetype)arrayWithValue:(TYPE)value; -//%+ (instancetype)arrayWithValueArray:(GPB##NAME##Array *)array; -//%+ (instancetype)arrayWithCapacity:(NSUInteger)count; -//% -//%- (instancetype)init NS_DESIGNATED_INITIALIZER; -//%// Initializes the array, copying the values. -//%- (instancetype)initWithValues:(const TYPE [])values -//% count:(NSUInteger)count; -//%- (instancetype)initWithValueArray:(GPB##NAME##Array *)array; -//%- (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 -//% -//%@interface GPB##NAME##Array : NSObject <NSCopying> -//% -//%@property(nonatomic, readonly) NSUInteger count; -//%@property(nonatomic, readonly) GPBEnumValidationFunc validationFunc; -//% -//%+ (instancetype)array; -//%+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func; -//%+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func -//% rawValue:(TYPE)value; -//%+ (instancetype)arrayWithValueArray:(GPB##NAME##Array *)array; -//%+ (instancetype)arrayWithValidationFunction:(nullable GPBEnumValidationFunc)func -//% capacity:(NSUInteger)count; -//% -//%- (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func -//% NS_DESIGNATED_INITIALIZER; -//% -//%// Initializes the array, copying the values. -//%- (instancetype)initWithValidationFunction:(nullable GPBEnumValidationFunc)func -//% rawValues:(const TYPE [])values -//% count:(NSUInteger)count; -//%- (instancetype)initWithValueArray:(GPB##NAME##Array *)array; -//%- (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. -//% -//%- (TYPE)rawValueAtIndex:(NSUInteger)index; -//% -//%- (void)enumerateRawValuesWithBlock:(void (^)(TYPE value, NSUInteger idx, BOOL *stop))block; -//%- (void)enumerateRawValuesWithOptions:(NSEnumerationOptions)opts -//% usingBlock:(void (^)(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) -//%- (TYPE)valueAtIndex:(NSUInteger)index; -//% -//%- (void)enumerateValuesWithBlock:(void (^)(TYPE value, NSUInteger idx, BOOL *stop))block; -//%- (void)enumerateValuesWithOptions:(NSEnumerationOptions)opts -//% usingBlock:(void (^)(TYPE value, NSUInteger idx, BOOL *stop))block; - -//%PDDM-DEFINE ARRAY_MUTABLE_INTERFACE(NAME, TYPE, HELPER_NAME) -//%- (void)addValue:(TYPE)value; -//%- (void)addValues:(const TYPE [])values count:(NSUInteger)count; -//%ARRAY_EXTRA_MUTABLE_METHODS1_##HELPER_NAME(NAME, TYPE) -//%- (void)insertValue:(TYPE)value atIndex:(NSUInteger)index; -//% -//%- (void)replaceValueAtIndex:(NSUInteger)index withValue:(TYPE)value; -//%ARRAY_EXTRA_MUTABLE_METHODS2_##HELPER_NAME(NAME, TYPE) -//%- (void)removeValueAtIndex:(NSUInteger)index; -//%- (void)removeAll; -//% -//%- (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) -//%- (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. -//% -//%- (void)addRawValue:(TYPE)value; -//%- (void)addRawValuesFromArray:(GPB##NAME##Array *)array; -//%- (void)addRawValues:(const TYPE [])values count:(NSUInteger)count; -//% -//%- (void)insertRawValue:(TYPE)value atIndex:(NSUInteger)index; -//% -//%- (void)replaceValueAtIndex:(NSUInteger)index withRawValue:(TYPE)value; -//% -//%// No validation applies to these methods. -//% |