Blocco Funzionale FS_WRITE
Il blocco funzionale FS_WRITE scrive dati su un sistema di file.
Attenzione: I file esistenti vengono sovrascritti senza alcun avviso.
Il sistema di file deve essere stato precedentemente inizializzato tramite FS_INIT. Tutte le operazioni avvengono in modo asincrono per ogni supporto di memorizzazione creato.
Ingresso WRITE
Su un fronte positivo, i dati vengono scritti sul supporto di memorizzazione.
Ingresso DEV
Definisce il dispositivo da cui accedere ai file. Il dispositivo viene utilizzato per progetto e può essere gestito nel menu contestuale sotto Progetto Memoria Esterna.
Ingresso PATH
Specifica il percorso del file sul supporto di memorizzazione. Il percorso corrisponde a un percorso di file Unix in formato UTF-8, se supportato. Il percorso è rappresentato come segue:
Cartella/Sottocartella/File.txt
Ingresso DATA
Definisce i dati che devono essere scritti.
Ingresso MODE
Specifica la modalità con cui il file deve essere scritto. Le modalità possibili sono:
| Modalità | Descrizione |
|---|---|
| "r" | Aperto solo per la lettura. Posiziona il puntatore del file all'inizio del file. |
| "r+" | Aperto solo per la lettura e la scrittura. Posiziona il puntatore del file all'inizio del file. |
| "w" | Aperto solo per la scrittura. Posiziona il puntatore del file all'inizio del file. Cancella il contenuto del file. Se il file non esiste, viene creato. |
| "w+" | Aperto solo per la scrittura e la lettura. Posiziona il puntatore del file all'inizio del file. Cancella il contenuto del file. Se il file non esiste, viene creato. |
| "a" | Aperto solo per la scrittura. Posiziona il puntatore del file alla fine del file. Se il file non esiste, viene creato. I dati vengono aggiunti alla fine. |
| "a+" | Aperto solo per la scrittura e la lettura. Posiziona il puntatore del file alla fine del file. Se il file non esiste, viene creato. I dati vengono aggiunti alla fine. |
| "x" | Aperto solo per la scrittura. Posiziona il puntatore del file all'inizio del file. Se il file esiste, l'operazione viene interrotta. |
| "x+" | Aperto solo per la scrittura e la lettura. Posiziona il puntatore del file all'inizio del file. Se il file esiste, l'operazione viene interrotta. |
| "c" | Aperto solo per la scrittura. Posiziona il puntatore del file all'inizio del file. Se il file non esiste, viene creato. Sovrascrive il contenuto del file. |
| "c+" | Aperto solo per la scrittura e la lettura. Posiziona il puntatore del file all'inizio del file. Se il file non esiste, viene creato. Sovrascrive il contenuto del file. |
Ingresso BOM
Se l'ingresso è vero durante la scrittura, viene aggiunto il Byte Order Mark UTF-8 all'inizio del file. Questo avviene solo se il file viene sovrascritto o creato. Se il BOM non è stato scritto all'inizio del file, non può essere aggiunto in un secondo momento.
Uscita DONE
L'uscita restituisce un impulso di successo per eseguire la successiva operazione. L'impulso avviene al termine dell'operazione, anche se si è verificato un errore.
Uscita LENGTH
Restituisce il numero di byte scritti. Lo stato viene salvato per l'uso successivo.
Uscita ERROR
In caso di errore, restituisce un testo con un messaggio di errore. Questo è FALSE, se non si è verificato alcun errore. Lo stato viene salvato per l'uso successivo.
Cause possibili:
- Il servizio del supporto di memorizzazione non è stato avviato.
- La memoria non è stata inizializzata.
- Le credenziali di accesso sono invalid.
- Il server remoto non può essere raggiunto.
- Il supporto di memorizzazione non esiste.
- Il percorso specificato non è valido.
- Non si può scrivere sul supporto di memorizzazione.
- Nessuno spazio di memoria disponibile o la memoria è protetta in scrittura.