articles:dicorebol-fr:write-io [RebolFranceWiki]

Write-IO - Détail de la fonction

En résumé :

Ecriture bas-niveau dans un port.

Utilisation :

write-io port buffer length

Arguments :

port - Port déjà ouvert où écrire (type: port!)

buffer - Tampon à utiliser pour l’écriture. (type: any-string!)

length - Nombre maximum de charactère à écrire (type: number!)

Description :

Cette fonction fournit une méthode bas-niveau pour écrire des données dans un port. La plupart du temps, cette fonction ne devrait pas être utilisée, la fonction INSERT étant la méthode appropriée pour écrire des données dans un port.

La différence principale entre WRITE-IO et INSERT est que WRITE-IO prend en argument une longueur maximale de transfert. Comme avec la fonction WRITE du language C, les octets sont transférés depuis le tampon jusqu’à concurrence de la longueur maximale spécifée. La longueur du transfert est retournée en résultat; elle peut être zéro (si rien n’est transféré,) ou même négative dans le cas de certaines erreurs.

Voici un exemple simple d’utilisation de WRITE-IO sur un fichier (Notez à nouveau: c’est une méthode d’E/S bas-niveau; vous devriez normalement utiliser les fonctions sur les séries comme COPY, INSERT, NEXT, etc. pour lire et écrire dans les ports d’E/S.)

    attempt [delete %testfile]
    port: open/direct %testfile
    buffer: "testing"
    write-io port buffer 4
    close port
    probe read %testfile
    "test"

Fonction en relation :

read-io - Lecture bas-niveau d’un port.

Version anglaise officielle :

http://www.rebol.com/docs/words/wwrite-io.html