Google_Protobuf_FieldOptions
descriptor.pb.swift:1429struct Google_Protobuf_FieldOptions
struct Google_Protobuf_FieldOptions
import SwiftProtobuf
Support library for Swift code generated by protoc-gen-swift.
protocol Copyable
A type whose values can be implicitly or explicitly copied.
protocol CustomDebugStringConvertible
A type with a customized textual representation suitable for debugging purposes.
protocol Equatable
A type that can be compared for value equality.
protocol Escapable
@preconcurrency protocol ExtensibleMessage : Message
Additional capabilities needed by messages that allow extensions.
protocol Hashable : Equatable
A type that can be hashed into a Hasher
to produce an integer hash value.
@preconcurrency protocol Message : CustomDebugStringConvertible, Sendable
The protocol which all generated protobuf messages implement. Message
is the protocol type you should use whenever you need an argument or variable which holds “some message”.
protocol Sendable
@preconcurrency protocol _MessageImplementationBase : Hashable, Message
Implementation base for all messages; not intended for client use.
protocol _ProtoNameProviding
SwiftProtobuf Internal: Common support looking up field names.
init()
static let _protobuf_nameMap: _NameMap
static let protoMessageName: String
var _protobuf_extensionFieldValues: ExtensionFieldValueSet
var ctype: Google_Protobuf_FieldOptions.CType { get set }
NOTE: ctype is deprecated. Use features.(pb.cpp).string_type
instead. The ctype option instructs the C++ code generator to use a different representation of the field than it normally would. See the specific options below. This option is only implemented to support use of [ctype=CORD] and [ctype=STRING] (the default) on non-repeated fields of type “bytes” in the open source release. TODO: make ctype actually deprecated.
var debugRedact: Bool { get set }
Indicate that the field value should not be printed out when using debug formats, e.g. when the field contains sensitive credentials.
var deprecated: Bool { get set }
Is this field deprecated? Depending on the target platform, this can emit Deprecated annotations for accessors, or it will be completely ignored; in the very least, this is a formalization for deprecating fields.
var editionDefaults: [Google_Protobuf_FieldOptions.EditionDefault] { get set }
var featureSupport: Google_Protobuf_FieldOptions.FeatureSupport { get set }
var features: Google_Protobuf_FeatureSet { get set }
Any features defined in the specific edition. WARNING: This field should only be used by protobuf plugins or special cases like the proto compiler. Other uses are discouraged and developers should rely on the protoreflect APIs for their client language.
var hasCtype: Bool { get }
Returns true if ctype
has been explicitly set.
var hasDebugRedact: Bool { get }
Returns true if debugRedact
has been explicitly set.
var hasDeprecated: Bool { get }
Returns true if deprecated
has been explicitly set.
var hasFeatureSupport: Bool { get }
Returns true if featureSupport
has been explicitly set.
var hasFeatures: Bool { get }
Returns true if features
has been explicitly set.
var hasJstype: Bool { get }
Returns true if jstype
has been explicitly set.
var hasLazy: Bool { get }
Returns true if lazy
has been explicitly set.
var hasPacked: Bool { get }
Returns true if packed
has been explicitly set.
var hasRetention: Bool { get }
Returns true if retention
has been explicitly set.
var hasUnverifiedLazy: Bool { get }
Returns true if unverifiedLazy
has been explicitly set.
var hasWeak: Bool { get }
Returns true if weak
has been explicitly set.
var isInitialized: Bool { get }
var jstype: Google_Protobuf_FieldOptions.JSType { get set }
The jstype option determines the JavaScript type used for values of the field. The option is permitted only for 64 bit integral and fixed types (int64, uint64, sint64, fixed64, sfixed64). A field with jstype JS_STRING is represented as JavaScript string, which avoids loss of precision that can happen when a large value is converted to a floating point JavaScript. Specifying JS_NUMBER for the jstype causes the generated JavaScript code to use the JavaScript “number” type. The behavior of the default option JS_NORMAL is implementation dependent.
var lazy: Bool { get set }
Should this field be parsed lazily? Lazy applies only to message-type fields. It means that when the outer message is initially parsed, the inner message’s contents will not be parsed but instead stored in encoded form. The inner message will actually be parsed when it is first accessed.
var packed: Bool { get set }
The packed option can be enabled for repeated primitive fields to enable a more efficient representation on the wire. Rather than repeatedly writing the tag and type for each element, the entire array is encoded as a single length-delimited blob. In proto3, only explicit setting it to false will avoid using packed encoding. This option is prohibited in Editions, but the repeated_field_encoding
feature can be used to control the behavior.
var retention: Google_Protobuf_FieldOptions.OptionRetention { get set }
var targets: [Google_Protobuf_FieldOptions.OptionTargetType] { get set }
var uninterpretedOption: [Google_Protobuf_UninterpretedOption] { get set }
The parser stores options it doesn’t recognize here. See above.
var unknownFields: UnknownStorage
var unverifiedLazy: Bool { get set }
unverified_lazy does no correctness checks on the byte stream. This should only be used where lazy with verification is prohibitive for performance reasons.
var weak: Bool { get set }
For Google-internal migration only. Do not use.
static func == (lhs: Google_Protobuf_FieldOptions, rhs: Google_Protobuf_FieldOptions) -> Bool
mutating func clearCtype()
Clears the value of ctype
. Subsequent reads from it will return its default value.
mutating func clearDebugRedact()
Clears the value of debugRedact
. Subsequent reads from it will return its default value.
mutating func clearDeprecated()
Clears the value of deprecated
. Subsequent reads from it will return its default value.
mutating func clearFeatureSupport()
Clears the value of featureSupport
. Subsequent reads from it will return its default value.
mutating func clearFeatures()
Clears the value of features
. Subsequent reads from it will return its default value.
mutating func clearJstype()
Clears the value of jstype
. Subsequent reads from it will return its default value.
mutating func clearLazy()
Clears the value of lazy
. Subsequent reads from it will return its default value.
mutating func clearPacked()
Clears the value of packed
. Subsequent reads from it will return its default value.
mutating func clearRetention()
Clears the value of retention
. Subsequent reads from it will return its default value.
mutating func clearUnverifiedLazy()
Clears the value of unverifiedLazy
. Subsequent reads from it will return its default value.
mutating func clearWeak()
Clears the value of weak
. Subsequent reads from it will return its default value.
mutating func decodeMessage<D>(decoder: inout D) throws where D : Decoder
func traverse<V>(visitor: inout V) throws where V : Visitor
enum CType
struct EditionDefault
struct FeatureSupport
Information about the support window of a feature.
enum JSType
enum OptionRetention
If set to RETENTION_SOURCE, the option will be omitted from the binary.
enum OptionTargetType
This indicates the types of entities that the field may apply to when used as an option. If it is unset, then the field may be freely used as an option on any kind of entity.
init(jsonString: String, extensions: (any ExtensionMap)? = nil, options: JSONDecodingOptions = JSONDecodingOptions()) throws
Creates a new message by decoding the given string containing a serialized message in JSON format.
init(jsonString: String, options: JSONDecodingOptions = JSONDecodingOptions()) throws
Creates a new message by decoding the given string containing a serialized message in JSON format.
init<Bytes>(jsonUTF8Bytes: Bytes, extensions: (any ExtensionMap)? = nil, options: JSONDecodingOptions = JSONDecodingOptions()) throws where Bytes : SwiftProtobufContiguousBytes
Creates a new message by decoding the given SwiftProtobufContiguousBytes
containing a serialized message in JSON format, interpreting the data as UTF-8 encoded text.
init<Bytes>(jsonUTF8Bytes: Bytes, options: JSONDecodingOptions = JSONDecodingOptions()) throws where Bytes : SwiftProtobufContiguousBytes
Creates a new message by decoding the given SwiftProtobufContiguousBytes
containing a serialized message in JSON format, interpreting the data as UTF-8 encoded text.
init(jsonUTF8Data: Data, extensions: (any ExtensionMap)? = nil, options: JSONDecodingOptions = JSONDecodingOptions()) throws
Creates a new message by decoding the given Data
containing a serialized message in JSON format, interpreting the data as UTF-8 encoded text.
init(jsonUTF8Data: Data, options: JSONDecodingOptions = JSONDecodingOptions()) throws
Creates a new message by decoding the given Data
containing a serialized message in JSON format, interpreting the data as UTF-8 encoded text.
init<Bytes>(serializedBytes bytes: Bytes, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws where Bytes : SwiftProtobufContiguousBytes
Creates a new message by decoding the given SwiftProtobufContiguousBytes
value containing a serialized message in Protocol Buffer binary format.
init(textFormatString: String, extensions: (any ExtensionMap)? = nil) throws
Creates a new message by decoding the given string containing a serialized message in Protocol Buffer text format.
init(textFormatString: String, options: TextFormatDecodingOptions = TextFormatDecodingOptions(), extensions: (any ExtensionMap)? = nil) throws
Creates a new message by decoding the given string containing a serialized message in Protocol Buffer text format.
init(unpackingAny: Google_Protobuf_Any, extensions: (any ExtensionMap)? = nil, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws
Initialize this message from the provided google.protobuf.Any
well-known type.
static func array(fromJSONString jsonString: String, extensions: any ExtensionMap = SimpleExtensionMap(), options: JSONDecodingOptions = JSONDecodingOptions()) throws -> [Self]
Creates a new array of messages by decoding the given string containing a serialized array of messages in JSON format.
static func array(fromJSONString jsonString: String, options: JSONDecodingOptions = JSONDecodingOptions()) throws -> [Self]
Creates a new array of messages by decoding the given string containing a serialized array of messages in JSON format.
static func array<Bytes>(fromJSONUTF8Bytes jsonUTF8Bytes: Bytes, extensions: any ExtensionMap = SimpleExtensionMap(), options: JSONDecodingOptions = JSONDecodingOptions()) throws -> [Self] where Bytes : SwiftProtobufContiguousBytes
Creates a new array of messages by decoding the given SwiftProtobufContiguousBytes
containing a serialized array of messages in JSON format, interpreting the data as UTF-8 encoded text.
static func array<Bytes>(fromJSONUTF8Bytes jsonUTF8Bytes: Bytes, options: JSONDecodingOptions = JSONDecodingOptions()) throws -> [Self] where Bytes : SwiftProtobufContiguousBytes
Creates a new array of messages by decoding the given SwiftProtobufContiguousBytes
containing a serialized array of messages in JSON format, interpreting the data as UTF-8 encoded text.
static func array(fromJSONUTF8Data jsonUTF8Data: Data, extensions: any ExtensionMap = SimpleExtensionMap(), options: JSONDecodingOptions = JSONDecodingOptions()) throws -> [Self]
Creates a new array of messages by decoding the given Data
containing a serialized array of messages in JSON format, interpreting the data as UTF-8 encoded text.
static func array(fromJSONUTF8Data jsonUTF8Data: Data, options: JSONDecodingOptions = JSONDecodingOptions()) throws -> [Self]
Creates a new array of messages by decoding the given Data
containing a serialized array of messages in JSON format, interpreting the data as UTF-8 encoded text.
static func isPathValid(_ path: String) -> Bool
Checks whether the given path is valid for Message type.
static func jsonString<C>(from collection: C, options: JSONEncodingOptions = JSONEncodingOptions()) throws -> String where Self == C.Element, C : Collection
Returns a string containing the JSON serialization of the messages.
static func jsonUTF8Bytes<C, Bytes>(from collection: C, options: JSONEncodingOptions = JSONEncodingOptions()) throws -> Bytes where Self == C.Element, C : Collection, Bytes : SwiftProtobufContiguousBytes
Returns a SwiftProtobufContiguousBytes
containing the UTF-8 JSON serialization of the messages.
static func jsonUTF8Data<C>(from collection: C, options: JSONEncodingOptions = JSONEncodingOptions()) throws -> Data where Self == C.Element, C : Collection
Returns a Data containing the UTF-8 JSON serialization of the messages.
static func with(_ populator: (inout Self) throws -> Void) rethrows -> Self
Creates an instance of the message type on which this method is called, executes the given block passing the message in as its sole inout
argument, and then returns the message.
var debugDescription: String { get }
A description generated by recursively visiting all fields in the message, including messages.
static func != (lhs: Self, rhs: Self) -> Bool
Returns a Boolean value indicating whether two values are not equal.
static func == (lhs: Self, rhs: Self) -> Bool
func _protobuf_generated_isEqualTo(other: Self) -> Bool
mutating func clearExtensionValue<F>(ext: MessageExtension<F, Self>) where F : ExtensionField
func getExtensionValue<F>(ext: MessageExtension<F, Self>) -> F.ValueType? where F : ExtensionField
func hasExtensionValue<F>(ext: MessageExtension<F, Self>) -> Bool where F : ExtensionField
func hash(into hasher: inout Hasher)
A hash based on the message’s full contents.
func isEqualTo(message: any Message) -> Bool
func jsonString(options: JSONEncodingOptions = JSONEncodingOptions()) throws -> String
Returns a string containing the JSON serialization of the message.
func jsonUTF8Bytes<Bytes>(options: JSONEncodingOptions = JSONEncodingOptions()) throws -> Bytes where Bytes : SwiftProtobufContiguousBytes
Returns a SwiftProtobufContiguousBytes
containing the UTF-8 JSON serialization of the message.
func jsonUTF8Data(options: JSONEncodingOptions = JSONEncodingOptions()) throws -> Data
Returns a Data containing the UTF-8 JSON serialization of the message.
mutating func merge(from source: Self, fieldMask: Google_Protobuf_FieldMask, mergeOption: Google_Protobuf_FieldMask.MergeOptions = .init()) throws
Merges fields specified in a FieldMask into another message.
mutating func merge<Bytes>(serializedBytes bytes: Bytes, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws where Bytes : SwiftProtobufContiguousBytes
Updates the message by decoding the given SwiftProtobufContiguousBytes
value containing a serialized message in Protocol Buffer binary format into the receiver.
mutating func merge(serializedData data: Data, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws
Updates the message by decoding the given Data
value containing a serialized message in Protocol Buffer binary format into the receiver.
func serializedBytes<Bytes>(partial: Bool = false, options: BinaryEncodingOptions = BinaryEncodingOptions()) throws -> Bytes where Bytes : SwiftProtobufContiguousBytes
Returns a SwiftProtobufContiguousBytes
instance containing the Protocol Buffer binary format serialization of the message.
func serializedData(partial: Bool = false) throws -> Data
Returns a Data
instance containing the Protocol Buffer binary format serialization of the message.
func serializedData(partial: Bool = false, options: BinaryEncodingOptions = BinaryEncodingOptions()) throws -> Data
Returns a Data
instance containing the Protocol Buffer binary format serialization of the message.
mutating func setExtensionValue<E>(ext: MessageExtension<PackedEnumExtensionField<E>, Self>, value: [E]) where E : Enum, E.RawValue == Int
mutating func setExtensionValue<E>(ext: MessageExtension<RepeatedEnumExtensionField<E>, Self>, value: [E]) where E : Enum, E.RawValue == Int
mutating func setExtensionValue<M>(ext: MessageExtension<RepeatedGroupExtensionField<M>, Self>, value: [M]) where M : Hashable, M : Message
mutating func setExtensionValue<T>(ext: MessageExtension<PackedExtensionField<T>, Self>, value: [T.BaseType]) where T : FieldType
mutating func setExtensionValue<T>(ext: MessageExtension<RepeatedExtensionField<T>, Self>, value: [T.BaseType]) where T : FieldType
mutating func setExtensionValue<M>(ext: MessageExtension<RepeatedMessageExtensionField<M>, Self>, value: [M]) where M : Equatable, M : Message
mutating func setExtensionValue<F>(ext: MessageExtension<F, Self>, value: F.ValueType) where F : ExtensionField
func textFormatString() -> String
Returns a string containing the Protocol Buffer text format serialization of the message.
func textFormatString(options: TextFormatEncodingOptions) -> String
Returns a string containing the Protocol Buffer text format serialization of the message.
@discardableResult mutating func trim(keeping fieldMask: Google_Protobuf_FieldMask) -> Bool
Removes from ‘message’ any field that is not represented in the given FieldMask. If the FieldMask is empty, does nothing.
init<Bytes>(contiguousBytes bytes: Bytes, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws where Bytes : ContiguousBytes
Creates a new message by decoding the given Foundation/ContiguousBytes
value containing a serialized message in Protocol Buffer binary format.
init<Bytes>(serializedBytes bytes: Bytes, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws where Bytes : ContiguousBytes
Creates a new message by decoding the given Foundation/ContiguousBytes
value containing a serialized message in Protocol Buffer binary format.
init(serializedData data: Data, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws
Creates a new message by decoding the given Data
value containing a serialized message in Protocol Buffer binary format.
mutating func merge<Bytes>(contiguousBytes bytes: Bytes, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws where Bytes : ContiguousBytes
Updates the message by decoding the given Foundation/ContiguousBytes
value containing a serialized message in Protocol Buffer binary format into the receiver.
mutating func merge<Bytes>(serializedBytes bytes: Bytes, extensions: (any ExtensionMap)? = nil, partial: Bool = false, options: BinaryDecodingOptions = BinaryDecodingOptions()) throws where Bytes : ContiguousBytes
Updates the message by decoding the given Foundation/ContiguousBytes
value containing a serialized message in Protocol Buffer binary format into the receiver.