Functions > FileDirDisk >

IniWriteSection

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

IniWriteSection ( "filename", "section", "data" [, index = 1] )

Param�tres

filename Le nom du fichier ini.
section Le nom de la section � ins�rer dans le fichier ini.
data Les donn�es � �crire. Les donn�es peuvent �tre une cha�ne ou un tableau. Si la donn�e est une cha�ne, chaque paire cl�/valeur doit �tre d�limit�e par @LF. Si la donn�e est un tableau, le tableau doit �tre de dimension 2 et la deuxi�me dimension doit �tre 2.
index [optionnel] Si un tableau est transmis en donn�e, ce param�tre indique l'index � partir duquel l'�criture doit commencer. Par d�faut, c'est 1 de telle fa�on que la valeur de retour de IniReadSection() puisse �tre utilis�e imm�diatement. Pour les tableaux cr��s � la main, cette valeur peut �tre diff�rente en fonction de la fa�on dont le tableau a �t� cr��. Ce param�tre est ignor� si une cha�ne est pass�e comme donn�e.

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 et @error = 1 si le format des donn�es n'est pas valide.

Remarques

Un fichier ini standard ressemble � :
[SectionName]
Key = valeur

Si le fichier n'existe pas, il est cr��. Tous les r�pertoires qui n'existent pas, ne seront pas cr��s. Les cl�s et/ou les sections sont ajout�s � la fin et ne sont pas tri�s d'aucune fa�on.
Si la section � �crire existe d�j�, son contenu sera �cras�.

Si vous souhaitez utiliser un fichier ini avec le codage Unicode, cr�ez d'abord un fichier ini en utilisant la fonction FileOpen() avec le param�tre de mode r�gl� sur "Unicode UTF16 Little Endian".

En relation

IniDelete, IniRead, IniReadSection, IniReadSectionNames, IniRenameSection, IniWrite

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)

    ; Cr�e une structure de section INI dans un tableau. L'�l�ment z�ro contient le nombre d'�l�ments du tableau, dans ce cas 3.
    Local $aSection[4][2] = [[3, ""],["Title", "AutoIt"],["Version", @AutoItVersion],["OS", @OSVersion]]

    ; Ecrit le tableau dans la section 'General'.
    IniWriteSection($sFilePath, "General", $aSection)

    ; Lit la section INI 'General'. Ce qui retourne un tableau � 2 dimensions.
    Local $aArray = IniReadSection($sFilePath, "General")

    ; V�rifie si une erreur s'est produite.
    If Not @error Then
        ; �num�re le tableau pour afficher les cl�s et leurs valeurs respectives.
        For $i = 1 To $aArray[0][0]
            MsgBox($MB_SYSTEMMODAL, "", "Cl�: " & $aArray[$i][0] & @CRLF & "Valeur: " & $aArray[$i][1])
        Next
    EndIf

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