4.2.2. Odczytywanie wartości parametrów

Do pobierania wartości parametrów zwykle używa się jednej z dwóch funkcji:

• void libpar_readpar(char *section, char *par, char *buf,
                      int size, int exit_on_error);

  Funkcja szuka w sekcji o nazwie sections (lub globalnej jeżeli podano NULL) parametru o nazwie par. Jeżeli znaleziono parametr, jego wartość jest kopiowana do bufora o adresie buf i wielkości size (jeżeli wartość parametru była dłuższa, to jest ona obcinana - w efekcie bufor może nie kończyć się znakiem '\000'). Parametr exit_on_error różny od 0 powoduje, że nieznalezienie parametru kończy program z błędem. Wypisywany jest odpowiedni komunikat. Jeżeli nie znaleziono parametru, bufor nie jest modyfikowany.

• char *libpar_getpar(char *section, char *par, int exit_on_error);

  Funkcja działa podobnie do poprzedniej, ale wartość parametru jest kopiowana do nowo zaalokowanego bufora o odpowiedniej wielkości, którego adres jest zwracany. Zwolnienie bufora za pomocą funkcji free() należy do programu. Jeżeli nie znaleziono parametru i podano exit_on_error równe 0, funkcja zwraca NULL.