Functions > FileDirDisk >

IniReadSection

Lit toutes les paires cl�/valeur d'une section d'un fichier .ini au format standard.

IniReadSection ( "filename", "section" )

Param�tres

filename Le nom du fichier ini.
section Le nom de la section dans le fichier ini.

Valeur de retour

Succ�s: Retourne un tableau � 2 dimensions o� l'�l�ment [n][0] est la cl� et l'�l�ment [n][1] est la valeur.
�chec: D�finit @error <> 0 si incapable de lire la section (Le fichier INI peut ne pas exister ou la section peut ne pas exister ou �tre vide)

Remarques

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

Le nombre d'�l�ments retourn�s sera dans $aArray[0][0]. Si une error se produit, aucun tableau n'est cr��.
    [0][0] = Nombre de paires
    [1][0] = 1-�re cl�
    [1][1] = 1-�re valeur
    [2][0] = 2-i�me cl�
    [2][1] = 2-i�me caleur
    ...
    [n][0] = n-i�me cl�
    [n][1] = n-i�me valeur

Seuls les 32767 premiers caract�res sont lus pour des raisons d'h�ritage.

En relation

IniDelete, IniRead, IniReadSectionNames, IniRenameSection, IniWrite, 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)

    ; Cr�e une structure de section INI sous forme de cha�ne.
    Local $sSection = "Title=AutoIt" & @CRLF & "Version=" & @AutoItVersion & @CRLF & "OS=" & @OSVersion

    ; Ecrit la cha�ne � la section "General".
    IniWriteSection($sFilePath, "General", $sSection)

    ; Lit la section "G�n�ral". 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 affichant 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