
EN: rebol.com -
rebol.org -
rebol.net -
FR: Rebol Documentation Project -
forum RebelBB -
rebol-france.org -
forum codeur -
Lit un fichier, une URL ou un bloc défini (bloc ou object).
read source
source - L’argument “source” (type: file! url! object! block!).
/binary - Conserve exactement le contenu.
/string - Modifie toutes les fins de lignes.
/direct - Ouvre le port sans mise en buffer.
/no-wait - Rend la main sans attendre s’il n’y a pas de données.
/lines - Manipule les données comme des lignes.
/part - Lit une partie des données .
size - L’argument “size”. (type: number!)
/with - Spécifie un mode de fin de ligne différent.
end-of-line - L’argument “end-of-line”. (type: char! string!)
/mode - Bloc de raffinements précédents.
args - L’argument “args”. (type: block!)
/custom - Autorise des raffinements particuliers.
params - L’argument “params”. (type: block!)
/skip - Saute un certain nombre d’octets.
length - L’argument “length”, nombre de bits à sauter. (type: number!)
Le moyen le plus simple de récupérer une information d’un fichier, ou d’une URL est d’utiliser READ. C’est le plus haut niveau de manipulation d’un port : ouverture du port, lecture de certaines ou de toutes les données, puis fermeture du port et renvoi des données lues. Avec un fichier, ou une URL, le contenu du fichier ou de l’URL est renvoyé sous forme d’une chaîne de caractères.
Le raffinement /BINARY oblige READ à une lecture binaire. Avec un fichier texte, les caractères de fin de ligne ne seront pas convertis (entre systèmes d’exploitation différents).
Le raffinement /STRING traduit les caractères de fin de ligne pour qu’ils soient identiques à ceux du système d’exploitation. Ce comportement est par défaut.
Le raffinement /DIRECT lit les données sans utiliser de buffer, ce qui est pratique pour les fichiers trop grands pour être stockés en mémoire.
Le raffinement /LINES renvoie le contenu lu comme une série de lignes. Une ligne est créée pour chaque caractère de terminaison de ligne trouvé dans les données lues.
Le raffinement /PART lit un nombre spécifié d’éléments à partir d’un fichier, d’une URL, ou d’un port. La lecture d’un fichier ou d’une URL s’effectuera sur le nombre spécifié de caractères. Utilisé avec /LINES, lit un nombre spécifié de lignes.
Le raffinement /WITH convertit les caractères ou les chaînes spécifiés en terminaisons de lignes.
Voir le guide Utilisateur pour plus de détails concernant l’explication de READ et de ses raffinements.
write %rebol-test-file.r "text file" print read %rebol-test-file.r text file
write %rebol-test-file.r [ {A learned blockhead is a greater man than an ignorant blockhead. -- Rooseveldt Franklin} ] probe first read/lines %rebol-test-file.r "A learned blockhead is a greater man"
probe pick (read/lines %rebol-test-file.r) 3 " -- Rooseveldt Franklin"
probe read/part %rebol-test-file.r 9 "A learned"
probe read/with %rebol-test-file.r "blockhead" {A learned is a greater man^M than an ignorant .^M -- Rooseveldt Franklin}
close - Ferme une connexion sur un port ouvert.
get-modes - Renvoie les caractéristiques d’un port (mode).
load - Charge un fichier, une URL, ou une chaîne. Lie les mots au contexte global.
open - Ouvre une nouvelle connexion sur un port.
save - Sauve une valeur ou un bloc dans un fichier ou une URL.
set-modes - Change les caractéristiques d’un port (mode).
write - Ecrit dans un fichier, une URL, ou un port spécifié (bloc ou object).