Bloco de Função FS_WRITE
O bloco de função FS_WRITE escreve dados em um sistema de arquivos.
Atenção: Arquivos existentes serão sobrescritos sem aviso.
O sistema de arquivos deve ter sido inicializado anteriormente usando FS_INIT. Todas as operações são realizadas assincronamente por meio de armazenamento criado.
Entrada WRITE
Em uma borda positiva, os dados são escritos no meio de armazenamento.
Entrada DEV
Define o dispositivo a partir do qual os arquivos devem ser acessados. O dispositivo é usado por projeto e pode ser gerenciado no menu de contexto sob Projeto Armazenamento Externo.
Entrada PATH
Especifica o caminho para o arquivo no meio de armazenamento. O caminho corresponde a um caminho de arquivo Unix no formato UTF-8, se este for suportado. O caminho é representado da seguinte forma:
Pasta/Subpasta/Arquivo.txt
Entrada DATA
Define os dados que devem ser escritos.
Entrada MODE
Especifica o modo com o qual o arquivo deve ser escrito. Modos possíveis são:
| Modo | Descrição |
|---|---|
| "r" | Aberto apenas para leitura. Posiciona o ponteiro do arquivo no início do arquivo. |
| "r+" | Aberto apenas para leitura e escrita. Posiciona o ponteiro do arquivo no início do arquivo. |
| "w" | Aberto apenas para escrita. Posiciona o ponteiro do arquivo no início do arquivo. Apaga o conteúdo do arquivo. Se o arquivo não existir, ele será criado. |
| "w+" | Aberto apenas para escrita e leitura. Posiciona o ponteiro do arquivo no início do arquivo. Apaga o conteúdo do arquivo. Se o arquivo não existir, ele será criado. |
| "a" | Aberto apenas para escrita. Posiciona o ponteiro do arquivo no final do arquivo. Se o arquivo não existir, ele será criado. Os dados serão anexados ao final. |
| "a+" | Aberto apenas para escrita e leitura. Posiciona o ponteiro do arquivo no final do arquivo. Se o arquivo não existir, ele será criado. Os dados serão anexados ao final. |
| "x" | Aberto apenas para escrita. Posiciona o ponteiro do arquivo no início do arquivo. Se o arquivo existir, a operação será abortada. |
| "x+" | Aberto apenas para escrita e leitura. Posiciona o ponteiro do arquivo no início do arquivo. Se o arquivo existir, a operação será abortada. |
| "c" | Aberto apenas para escrita. Posiciona o ponteiro do arquivo no início do arquivo. Se o arquivo não existir, ele será criado. Sobrescreve o conteúdo do arquivo. |
| "c+" | Aberto apenas para escrita e leitura. Posiciona o ponteiro do arquivo no início do arquivo. Se o arquivo não existir, ele será criado. Sobrescreve o conteúdo do arquivo. |
Entrada BOM
Se a entrada for verdadeira durante a escrita, o UTF-8 Byte Order Mark será adicionado no início do arquivo. Isso ocorre apenas se o arquivo for sobrescrito ou criado. Se o BOM não foi escrito no início do arquivo, ele não pode ser adicionado posteriormente.
Saída DONE
A saída retorna um pulso de sucesso para executar a próxima operação. O pulso ocorre ao término da operação, mesmo que um erro tenha ocorrido.
Saída LENGTH
Retorna o número de bytes escritos. O estado é armazenado para uso posterior.
Saída ERROR
Em caso de erro, retorna um texto com uma mensagem de erro. Este é FALSE, se nenhum erro tiver ocorrido. O estado é armazenado para uso posterior.
Causas possíveis:
- O serviço do meio de armazenamento não foi iniciado.
- A memória não foi inicializada.
- As credenciais de login são inválidas.
- O servidor remoto não pôde ser alcançado.
- O meio de armazenamento não existe.
- O caminho especificado é inválido.
- Não é possível escrever no meio de armazenamento.
- Nenhum espaço de armazenamento disponível na memória ou a memória está protegida contra gravação.