File

de https://docs.godotengine.org/en/stable/classes/class_fileaccess.html

Acceso a archivos¶

Hereda: RefCounted < Objeto

Escriba para manejar las operaciones de lectura y escritura de archivos.

Descripción¶

File type. /Tipo de archivo. Esto se utiliza para almacenar datos de forma permanente en el sistema de archivos del dispositivo del usuario y para leerlos. Esto se puede usar para almacenar datos guardados del juego o archivos de configuración del jugador, por ejemplo.

Aquí hay una muestra de cómo escribir y leer desde un archivo:

func save(content):
    var file = FileAccess.open("user://save_game.dat", FileAccess.WRITE)
    file.store_string(content)

func load():
    var file = FileAccess.open("user://save_game.dat", FileAccess.READ)
    var content = file.get_as_text()
    return content

(Si lo pongo tal cual en godot4.0.1 me da error. xd)
En el ejemplo anterior, el archivo se guardará en la carpeta de datos del usuario como se especifica en la documentación de Rutas de datos .
FileAccess se cerrará cuando se libere, lo que sucede cuando sale del alcance o cuando se le asigna la extensión null. En C#, la referencia debe desecharse una vez que hayamos terminado de usarla, esto se puede hacer con la usingdeclaración o llamando al Disposemétodo directamente.
var file = FileAccess.open("res://something") # File is opened and locked for use.
file = null # File is closed.
Nota: para acceder a los recursos del proyecto una vez exportados, se recomienda utilizar ResourceLoader en lugar de la API de FileAccess , ya que algunos archivos se convierten a formatos específicos del motor y es posible que sus archivos de origen originales no estén presentes en el paquete PCK exportado.
Nota: los archivos se cierran automáticamente solo si el proceso sale "normalmente" (como al hacer clic en el botón de cierre del administrador de ventanas o al presionar Alt + F4 ). Si detiene la ejecución del proyecto presionando F8 mientras el proyecto se está ejecutando, el archivo no se cerrará ya que el proceso del juego se cancelará. Puede solucionar esto llamando a flush a intervalos regulares.

FileAccess
open ( String path, ModeFlags flags ) static
FileAccess
open_compressed ( String path, ModeFlags mode_flags, CompressionMode compression_mode=0 ) static
FileAccess
open_encrypted ( String path, ModeFlags mode_flags, PackedByteArray key ) static
FileAccess
open_encrypted_with_pass ( String path, ModeFlags mode_flags, String pass ) static
en  Enumerations /Enumeraciones
enum ModeFlags:
ModeFlags READ = 1

 Abre el archivo para operaciones de lectura. El cursor se coloca al principio del archivo.

ModeFlags WRITE = 2 
 Abre el archivo para operaciones de escritura. El archivo se crea si no existe y se trunca si existe. Truncar significa que se eliminará todo su contenido antes de comenzar a escribir en él.

ModeFlags READ_WRITE = 3
 Abre el archivo para operaciones de lectura y escritura. No trunca el archivo. El cursor se coloca al principio del archivo.

ModeFlags WRITE_READ = 7
Abre el archivo para operaciones de lectura y escritura. El archivo se crea si no existe y se trunca si existe. El cursor se coloca al principio del archivo..

--
enum CompressionMode :
Modo de compresión COMPRESSION_FASTLZ =0
Utiliza el método de compresión FastLZ .
Modo de compresión COMPRESSION_DEFLATE =1
Utiliza el método de compresión DEFLATE .
Modo de compresión COMPRESSION_ZSTD =2
Utiliza el método de compresión Zstandard .
Modo de compresión COMPRESSION_GZIP =3
Utiliza el método de compresión gzip .

Method Descriptions
void close ( )
Cierra el archivo abierto actualmente y evita operaciones posteriores de lectura/escritura. Use flush para conservar los datos en el disco sin cerrar el archivo.
Nota: FileAccess se cerrará automáticamente cuando se libere, lo que sucede cuando sale del alcance o cuando se le asigna la extensión null. En C#, la referencia debe desecharse una vez que hayamos terminado de usarla, esto se puede hacer con la usingdeclaración o llamando al Disposemétodo directamente.

Method Descriptions
GDExtension get_extension ( String path )
...