PLIKI*.INI

Funkcje do odczytu plików INI
Funkcja wczytująca wartość pojedynczego klucza
IniRead ("nazwa_pliku", "sekcja", "klucz", "domyślny" )
Funkcja zwraca wartość klucza lub string "domyślny" jeżeli klucz nie został odnaleziony.

Przykład:
IniWriteSection("ustawienia.ini", "sekcja_1", "kl1=10"&@LF&"kl2=20") ;tworzenie sekcji_1 z dwoma kluczami
IniWriteSection("ustawienia.ini", "sekcja_2", "kl1=czerwony"&@LF&"kl2=niebieski");tworzenie sekcji_2 z dwoma kluczami
MsgBox(0, "", IniRead("ustawienia.ini", "sekcja_2","kl2","brak klucza")) ;wyświetli: niebieski
MsgBox(0, "", IniRead("ustawienia.ini", "sekcja_2","kl3","brak klucza")) ;wyświetli: brak klucza

Funkcja wczytująca nazwy i wartości kluczy z całej sekcji
IniReadSection ( "nazwa_pliku", "sekcja" )
Funkcja zwraca dwuwymiarową tablicę. Pierwszy wymiar ma tyle komórek ile jest kluczy+1, a drugi wymiar ma dwie komórki (zerowa zawiera nazwę klucza, a
pierwsza jego wartość). W komórce [0,0] zapisana jest ilość kluczy, komórka [0,1] nie jest wykorzystana.
[0,0] - ilość kluczy [0,1] - niewykorzystane
[1,0] - nazwa 1 klucza [1,1] - wartość 1 klucza
[2,0] - nazwa 2 klucza [2,1] - wartość 2 klucza
Jeżeli wystąpi błąd (np. brak pliku lub sekcji o podanej nazwie), funkcja oraz makro @error przyjmują wartość 1.
Przykład:
#include <Array.au3>
IniWriteSection("ustawienia.ini", "sekcja_1", "kl1=10"&@LF&"kl2=20") ;tworzenie sekcji_1 z dwoma kluczami
IniWriteSection("ustawienia.ini", "sekcja_2", "kl1=czerwony"&@LF&"kl2=niebieski");tworzenie sekcji_2 z dwoma kluczami
$aArray = IniReadSection("ustawienia.ini", "sekcja_2") ;utworzenie tablicy z kluczami
_ArrayDisplay($aArray)

Funkcja wczytująca nazwy wszystkich sekcji w pliku INI
IniReadSectionNames ( "nazwa_pliku" )
Funkcja zwraca jednowymiarową tablicę, w komórce [0] wpisuje ilość sekcji, a w następnych kolejne nazwy sekcji. Jeżeli wystąpi błąd (np. brak pliku), funkcja oraz
makro @error przyjmują wartość 1.
Przykład:
#include <Array.au3>
IniWriteSection("ustawienia.ini", "sekcja_1", "kl1=10"&@LF&"kl2=20") ;tworzenie sekcji_1 z dwoma kluczami
IniWriteSection("ustawienia.ini", "sekcja_2", "kl1=czerwony"&@LF&"kl2=niebieski");tworzenie sekcji_2 z dwoma kluczami
$aArray = IniReadSectionNames("ustawienia.ini") ;utworzenie tablicy z nazwami sekcji
_ArrayDisplay($aArray)
Tekst udostępniany na licencji Creative Commons: uznanie autorstwa, na tych samych warunkach,