PackedDataContainer

Obsoleto: Use @GlobalScope.var_to_bytes() or FileAccess.store_var() instead. To enable data compression, use PackedByteArray.compress() or FileAccess.open_compressed().

Hereda: Resource < RefCounted < Object

Efficiently packs and serializes Array or Dictionary.

Descripción

PackedDataContainer can be used to efficiently store data from untyped containers. The data is packed into raw bytes and can be saved to file. Only Array and Dictionary can be stored this way.

You can retrieve the data by iterating on the container, which will work as if iterating on the packed data itself. If the packed container is a Dictionary, the data can be retrieved by key names (String/StringName only).

var data = { "key": "value", "another_key": 123, "lock": Vector2() }
var packed = PackedDataContainer.new()
packed.pack(data)
ResourceSaver.save(packed, "packed_data.res")

var container = load("packed_data.res")
for key in container:
    prints(key, container[key])

Prints:

key value
lock (0, 0)
another_key 123

Nested containers will be packed recursively. While iterating, they will be returned as PackedDataContainerRef.

Métodos

Error	pack(value: Variant)
int	size() const

---

Descripciones de Métodos

Error pack(value: Variant) 🔗

Empaqueta el contenedor dado en una representación binaria. El value debe ser Array o Dictionary, cualquier otro tipo resultará en un error de datos inválido.

Nota: Las llamadas siguientes a este método sobrescribirán los datos existentes.

---

int size() const 🔗

Devuelve el tamaño del contenedor empaquetado (véase Array.size() y Dictionary.size()).