Deser

---

Description:

Content:

Namespaces:

• Convert
• Enum

Interfaces:

• CodecProvider - Lets an object choose a ValueCodec for each GObject property.
• HasFallback - Explicit receiver for unknown object fields under UnknownFieldPolicy.CAPTURE.

Classes:

• ArrayCursor - Sequential array iterator that keeps its parsed input alive.
• BoolCodec - ValueCodec for Vala boolean values.
• Codec - A typed codec that reads and writes Vala values directly.
• CodecAuto - Explicit, target-aware scalar conversion for irregular input.
• DataObject - Base model for bidirectional properties, with a virtual per-property CodecProvider. Override get_ignored_properties to omit additional fields without registering a codec in Settings.
• DateTimeCodec - ValueCodec for GLib.DateTime, using Settings.date_time_serialize_method.
• DecodeContext - Context for decoding a ValueView into application values.
• DynamicValue - Owning mixed-value tree for explicitly requested unknown data.
• DynamicValueCodec - Bidirectional codec for an explicitly requested DynamicValue tree.
• EncodeContext - Context for writing application values through a ValueWriter.
• EnumCodec - ValueCodec for a specific enum GType, using Settings.enum_serialize_method.
• GenericArrayCodec - Array codec with an explicitly selected element codec.
• HashTableCodec - String-keyed map codec with an explicitly selected value codec.
• Int32Codec - ValueCodec for signed 32-bit integers.
• Int64Codec - ValueCodec for signed 64-bit integers.
• JsonWorker - Typed JSON facade; choose a Codec for the root value.
• MapCursor - Sequential map iterator that keeps its parsed input alive.
• NullableDoubleCodec - Nullable double codec for typed roots and collection elements.
• NullableInt32Codec - Nullable signed 32-bit integer codec for typed roots and collection elements.
• NullableInt64Codec - Nullable signed 64-bit integer codec for typed roots and collection elements.
• NullableUint64Codec - Signed-64-backed adapter for nullable uint64 container elements.
• ObjectCodec - Map a GObject model through the shared object mapper.
• ObjectCodecOptions - Named configuration for an object codec when default model mapping is insufficient.
• OperationContext - Per-operation settings snapshot and error path for ValueCodec calls.
• RealCodec - ValueCodec for float or double , selected by the constructor's GType.
• Settings - Settings object for de/serialization methods. It can be get/set via Deser.get_settings and Deser.set_settings. On Deser.get_settings copy returns.
• StringCodec - Nullable string codec; see Deser.reject_null to reject null.
• StringListCodec - ValueCodec for a string vector.
• TemporalCodec - Preserve the exact TOML date and time kind as a typed value.
• TomlWorker - Typed TOML facade; use Codec to describe the root value.
• Uint32Codec - ValueCodec for unsigned 32-bit integers.
• Uint64Codec - ValueCodec for unsigned 64-bit integers within the format's supported range.
• ValueCodec - A rule for converting one value between a Vala type and JSON, YAML or TOML.
• ValueView - Lightweight view of a parsed node; it keeps the input alive.
• ValueWriter - Format-neutral output sink used by ValueCodec.encode_value.
• YamlWorker - Typed YAML facade; all model work uses the shared Codec.

Structs:

• NullableValue - A value in the form used by GObject property mapping.
• TemporalValue - Native TOML date/time components, distinguished by kind.

Enums:

• Case - Wire-name case for object codecs. AUTO detects each input key's style, while writing kebab-case; KEBAB accepts kebab-case names by default.
• ConvertableDataType - Data types that can be converted via Convert.convert_data
• DateTimeSerializeMethod - How to serialize DateTime
• EnumSerializeMethod - How to serialize Enums
• UnknownFieldPolicy - Policy for input object keys without a matching model property.
• ValueKind - Kinds exposed by a ValueView. UNKNOWN indicates an unsupported backend node.

Error domains:

• Error - Error from de/serialize

Delegates:

• public delegate Type ConcreteTypeResolver (Type declared_type, ValueView node, DecodeContext context) throws Error
  Choose a concrete subtype from input before ObjectFactory runs.
• public delegate Object ObjectFactory (Type concrete_type, string[] construct_names, Value[] construct_values) throws Error
  Construct one object with its construct-only values already decoded.
• public delegate ValueCodec PropertyCodecResolver (Type concrete_type, ParamSpec property) throws Error
  Choose a codec for a property before constructing an object.

Functions:

• public Codec<T> create_auto_codec<T> () throws Error
  Opt in to broad, lossless scalar conversion for a typed value.
• public Codec<GenericArray<T>> create_codec_for_array<T> (Settings? settings = null) throws Error
  Build a native pointer-array codec using a strict standard element codec. Pass Settings to select a registered element codec for this array. Use GenericArrayCodec for nested collections or custom item rules.
• public Codec<HashTable<string,T>> create_codec_for_map<T> (Settings? settings = null) throws Error
  Build a native string-keyed map codec using a strict standard value codec. Pass Settings to select a registered value codec for this map. Use HashTableCodec for nested collections or custom value rules.
• public Codec<T> create_codec_for_type<T> (Settings? settings = null) throws Error
  Create a strict standard codec for a scalar or concrete object type. Used by create_codec_for_array and create_codec_for_map when their element or value type needs no custom codec. Pass Settings to use an exact-type registered object codec, including for abstract object types. Otherwise abstract objects need an explicit codec. Generic collections and custom rules need an explicit codec. Boxed numeric types use Vala's nullable generic arguments, e.g. int64? or double?. Use an explicit codec for nullable int32 values.
• public ValueCodec create_standard_codec_for_property (ParamSpec property, Settings? settings = null) throws Error
  Select a strict scalar or concrete object codec from property metadata, or fail if unsupported.
• public Settings get_settings ()
  Returns copy of a current Deser.Settings
• public ValueCodec reject_null (ValueCodec inner)
  Reject explicit null without changing whether the field is required.
• public ValueCodec require_input (ValueCodec inner)
  Require the property to occur in input; null remains governed by inner.
• public void set_settings (Settings settings)
  Set the default Deser.Settings copied by codec operations.