Bloque de funciones FS_WRITE
El bloque de funciones FS_WRITE escribe datos en un sistema de archivos.
Atención: Los archivos existentes se sobrescriben sin advertencia.
El sistema de archivos debe haber sido inicializado previamente mediante FS_INIT. Todas las operaciones se realizan de manera asíncrona por cada medio de almacenamiento configurado.
Entrada WRITE
Al detectar un flanco positivo, los datos se escriben en el medio de almacenamiento.
Entrada DEV
Define el dispositivo desde el cual se accederá a los archivos. El dispositivo se utiliza por proyecto y puede administrarse en el menú contextual bajo Proyecto Almacenamiento externo.
Entrada PATH
Especifica la ruta al archivo en el medio de almacenamiento. La ruta corresponde a una ruta de archivo Unix en formato UTF-8, si este es soportado. La ruta se representa de la siguiente manera:
Carpeta/Subcarpeta/Archivo.txt
Entrada DATA
Define los datos que se desean escribir.
Entrada MODE
Especifica el modo en el cual se desea escribir el archivo. Los modos posibles son:
| Modo | Descripción |
|---|---|
| "r" | Solo para lectura. Coloca el puntero del archivo al inicio. |
| "r+" | Solo para lectura y escritura. Coloca el puntero del archivo al inicio. |
| "w" | Solo para escritura. Coloca el puntero del archivo al inicio. Elimina el contenido del archivo. Si el archivo no existe, se crea. |
| "w+" | Solo para escritura y lectura. Coloca el puntero del archivo al inicio. Elimina el contenido del archivo. Si el archivo no existe, se crea. |
| "a" | Solo para escritura. Coloca el puntero del archivo al final. Si el archivo no existe, se crea. Los datos se anexan al final. |
| "a+" | Solo para escritura y lectura. Coloca el puntero del archivo al final. Si el archivo no existe, se crea. Los datos se anexan al final. |
| "x" | Solo para escritura. Coloca el puntero del archivo al inicio. Si el archivo existe, se aborta. |
| "x+" | Solo para escritura y lectura. Coloca el puntero del archivo al inicio. Si el archivo existe, se aborta. |
| "c" | Solo para escritura. Coloca el puntero del archivo al inicio. Si el archivo no existe, se crea. Sobrescribe el contenido del archivo. |
| "c+" | Solo para escritura y lectura. Coloca el puntero del archivo al inicio. Si el archivo no existe, se crea. Sobrescribe el contenido del archivo. |
Entrada BOM
Si la entrada es verdadera durante la escritura, se agrega el UTF-8 Byte Order Mark al inicio del archivo. Esto solo ocurre si el archivo se sobrescribe o se crea nuevo. Si no se escribió el BOM al inicio del archivo, no puede agregarse posteriormente.
Salida DONE
La salida devuelve un pulso en caso de éxito para realizar la siguiente operación. El pulso ocurre al finalizar el proceso, incluso si ha ocurrido un error.
Salida LENGTH
Devuelve la cantidad de bytes escritos. El estado se almacena para su uso posterior.
Salida ERROR
En caso de error, devuelve un texto con un mensaje de error. Este es FALSE, si no ha ocurrido ningún error. El estado se almacena para su uso posterior.
Posibles causas:
- El servicio del medio de almacenamiento no se ha iniciado.
- El almacenamiento no se ha inicializado.
- Las credenciales de inicio de sesión son inválidas.
- No se pudo alcanzar el servidor remoto.
- El medio de almacenamiento no existe.
- La ruta especificada es inválida.
- No se puede escribir en el medio de almacenamiento.
- No hay espacio disponible en el almacenamiento o está protegido contra escritura.