fwrite
Écrit un fichier en mode binaire
&reftitle.description;
intfalsefwrite
resourcestream
stringdata
intnulllength&null;
fwrite écrit le contenu de la chaîne
data dans le fichier pointé par
stream.
&reftitle.parameters;
stream
&fs.file.pointer;
data
La chaîne à écrire.
length
Si la longueur length
est fournie, l'écriture s'arrêtera après
length octets, ou à la fin de la
chaîne (le premier des deux).
&reftitle.returnvalues;
fwrite retourne le nombre d'octets écrits, ou
&false; si une erreur survient.
&reftitle.changelog;
&Version;
&Description;
8.0.0
length est désormais nullable.
&reftitle.examples;
Exemple avec fwrite
]]>
&reftitle.notes;
Le fait d'écrire dans un flux peut se terminer avant que la chaîne complète ne soit
écrite. La valeur retournée par la fonction
fwrite peut être vérifiée comme ceci :
]]>
Sur les systèmes qui font la différence entre les fichiers binaires
et les fichiers textes (par exemple, Windows), le fichier doit être ouvert
avec l'option 'b' inclus dans le paramètre de mode de
fopen.
Si stream est ouvert en mode ajout (append),
fwrite sera atomique (sauf si la taille de
data excède la taille du bloc du système de fichiers,
sur quelques plates-formes, et tant que le fichier se trouve sur le système de fichiers
local). Ainsi, il n'est pas nécessaire d'utiliser la fonction flock
sur une ressource avant d'appeler la fonction fwrite ;
toutes les données seront écrites sans interruption.
Si l'on écrit 2 fois dans le fichier, les données seront ajoutées à la fin
du fichier ; cela signifie que l'exemple suivant ne donnera pas le résultat
attendu :
]]>
&reftitle.seealso;
fread
fopen
fsockopen
popen
file_get_contents
pack