Functions > FileDirDisk >

IniWrite

�crit une valeur dans un fichier ini au format standard.

IniWrite ( "filename", "section", "key", "value" )

Param�tres

filename Le nom du fichier ini.
section Le nom de la section dans le fichier ini.
key Le nom de la cl� dans le fichier ini.
value La valeur � �crire/modifier.

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 si le fichier est en lecture seule.

Remarques

Un fichier .ini standard ressemble � :
[NomdelaSection]
cl�=Valeur

Si le fichier n'existe pas, il est cr��, dans la mesure o� le r�pertoire existe. Les cl�s et/ou les sections sont ajout�es � la fin et ne sont pas tri�es.

Lorsque vous �crivez une valeur qui est entre guillemets, les guillemets sont supprim�s. Pour pouvoir �crire des guillemets dans la valeur, vous devez mettre des doubles guillemets entour� par des simple guillemets. Par exemple : ""Ceci est un test"" va produire "Ceci est un test" lors de l'utilisation de IniRead() ou semblable.

Les espaces de d�but et de fin sont supprim�s. Pour conserver les espaces, la cha�ne de caract�re doit �tre entre guillemets. Par exemple, " ceci est un test" pr�servera les espaces, mais comme vu plus haut les guillemets seront supprim�s.

Une valeur sur plusieurs lignes n'est pas possible.

Si vous desirez utiliser un fichier ini avec un encodage Unicode, premi�rement cr�ez un fichier .ini en utilisant la fonction FileOpen() avec le param�tre de mode positionn� sur Unicode.

En relation

IniDelete, IniRead, IniReadSection, IniReadSectionNames, IniRenameSection, IniWriteSection

Exemple

#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>

Example()

Func Example()
    ; Cr�e une constante locale avec le nom complet du fichier qui sera lu/�crit
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Ecrit la valeur de 'AutoIt' � la cl� "Title" et dans la section "General".
    IniWrite($sFilePath, "General", "Title", "AutoIt")

    ; Lit la valeur correspondante � la cl� 'Title' dans la section 'General'.
    Local $sRead = IniRead($sFilePath, "General", "Title", "Default Value")

    ; Affiche la valeur retourn�e par IniRead.
    MsgBox($MB_SYSTEMMODAL, "", "La valeur correspondante � la cl� 'Title' dans la section  'General' est: " & $sRead)

    ; Supprime la cl� 'Title'.
    IniDelete($sFilePath, "General", "Title")

    ; Lit le fichier INI pour la valeur de 'Title' dans la section 'General'.
    $sRead = IniRead($sFilePath, "General", "Title", "Default Value")

    ; Affiche la valeur retourn�e par IniRead. Comme il n'y a pas de cl� stock� la valeur sera la 'Valeur par d�faut' pass�e � IniRead.
    MsgBox($MB_SYSTEMMODAL, "", "La valeur correspondante � la cl� 'Title' dans la section  'General' est: : " & $sRead)

    ; Supprime le fichier INI.
    FileDelete($sFilePath)
EndFunc   ;==>Example