Funktionreferenz


IniReadSectionNames

Beschreibung anzeigen in

Liest alle Sektionen aus einer standardkonformen .ini-Datei.

IniReadSectionNames ( "filename" )

Parameter

filename Der Dateiname der .ini-Datei.

Rückgabewert

Erfolg: ein Array aller Sektionen der .ini-Datei.
Fehler: Setzt das @error Flag auf ungleich null.

Bemerkungen

Eine standardkonforme .ini-Datei sieht folgendermaßen aus:
[SektionsName]
Schlüssel=Wert


Die Anzahl der zurückgegebenen Elemente steht in $aArray[0]. Wenn ein @error auftaucht, wird kein Array zurückgegeben.

Verwandte Funktionen

IniDelete, IniRead, IniReadSection, IniRenameSection, IniWrite, IniWriteSection

Beispiel

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

Example()

Func Example()
    ; Erstellt eine Konstante im lokalen Bereich des Dateipfades, welcher zum lesen bzw. schreiben verwendet wird.
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Erstellt eine Sektion in der ini mit der Struktur eines Strings.
    Local $sSection = "Title=AutoIt" & @LF & "Version=" & @AutoItVersion & @LF & "OS=" & @OSVersion

    ; Schreibt den String in die Sektions 'General', 'Version' und 'andere'.
    IniWriteSection($sFilePath, "General", $sSection)
    IniWriteSection($sFilePath, "Version", $sSection)
    IniWriteSection($sFilePath, "andere", $sSection)

    ; Liest die Sektions der ini-Datei. Es wird ein 1D Array zurückgegeben.
    Local $aArray = IniReadSectionNames($sFilePath)

    ; Prüft, ob ein Fehler aufgetreten ist.
    If Not @error Then
        ; Durchläuft das Array und stellt die einzelnen Sektions dar.
        For $i = 1 To $aArray[0]
            MsgBox($MB_SYSTEMMODAL, "", "Sektion: " & $aArray[$i])
        Next
    EndIf

    ; Löscht die ini-Datei.
    FileDelete($sFilePath)
EndFunc   ;==>Example