Functions > FileDirDisk >


IniReadSectionNames

Lit toutes les sections d'un fichier .ini au format standard.

IniReadSectionNames ( "filename" )

Paramètre

filename Le nom du fichier ini.

Valeur de retour

Succès: Retourne un tableau contenant tous les noms de section du fichier INI.
Échec: Définit @error <> 0

Remarques

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


Le nombre d'éléments retournés sera en position [0]. Si une erreur se produit, aucun tableau n'est retourné.

En relation

IniDelete, IniRead, IniReadSection, 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

    ; Écrit la chaîne dans les sections 'General', 'Version' et 'Other'.
    IniWriteSection($sFilePath, "General", $sSection)
    IniWriteSection($sFilePath, "Version", $sSection)
    IniWriteSection($sFilePath, "Other", $sSection)

    ; Lit les noms des sections INI, ce qui retourne un tableau à 1 dimension.
    Local $aArray = IniReadSectionNames($sFilePath)

    ; Vérifie si une erreur s'est produite.
    If Not @error Then
        ; Énumére le tableau où figurent les noms des sections.
        For $i = 1 To $aArray[0]
            MsgBox($MB_SYSTEMMODAL, "", "Section: " & $aArray[$i])
        Next
    EndIf

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