NAZWA¶

SKŁADNIA¶

#include <sys/types.h>
#include <limits.h>
#include <db.h>

DB *
dbopen(const char *plik, int znaczniki, int tryb, DBTYPE rodzaj,
const void *info_otw);

OPIS¶

typedef struct {

DBTYPE type;
int (*close)(const DB *db);
int (*del)(const DB *db, const DBT *klucz, u_int znaczniki);
int (*fd)(const DB *db);
int (*get)(const DB *db, DBT *klucz, DBT *dane, u_int znaczniki);
int (*put)(const DB *db, DBT *klucz, const DBT *dane,
u_int znaczniki);
int (*sync)(const DB *db, u_int znaczniki);
int (*seq)(const DB *db, DBT *klucz, DBT *dane, u_int znaczniki);

} DB;

type

Rodzaj właściwej metody dostępu (i format plików).

close

Wskaźnik do funkcji zrzucającej zbuforowane informacje ma dysk, zwalniającej przydzielone zasoby i zamykającej podległe pliki. Ze względu na to, że pary klucz/dane mogą być buforowane w pamięci, niepomyślne zrzucenie buforów pliku za pomocą funkcji close lub sync ,oże prowadzić do niespójności lub utraty informacji. Funkcje close zwracają -1 w przypadku błędu (ustawiając errno), a 0 w przypadku zakończenia pomyślnego.

del

Wskaźnik do funkcji usuwającej pary klucz/dane z bazy danych.

Parametr znacznik może mieć jedną z następujących wartości:

Funkcje delete zwracają -1 w przypadku błędu (ustawiając errno), 0 w przypadku pomyślnego zakończenia, a 1 gdy podany klucz nie występuje w pliku.

fd

Wskaźnik do funkcji zwracającej deskryptor pliku odpowiadający używanej bazie danych. Dla wszystkich procesów wywołujących dbopen dla tej samej nazwy pliku plik zostanie zwrócony deskryptor pliku wskazujący na ten sam plik. Tego deskryptora pliku można bezpiecznie używać jako argumentu funkcji blokujących fcntl(2) i flock(2). Deskryptor pliku nie musi być związany z którymkolwiek z plików używanych przez daną metodę dostępu. Deskryptor pliku nie jest dostępny dla baz danych zawartych w pamięci. Funkcje fd zwracają -1 w przypadku błędu (ustawiając errno), a deskryptor pliku w przypadku pomyślnego zakończenia.

get

Wskaźnik do funkcji stanowiącej interfejs dla pobierania danych z bazy według klucza. Adres i rozmiar danych związanych z podanym kluczem klucz są zwracane w strukturze wskazywanej przez dane. Funkcje get zwracają -1 w przypadku błędu (ustawiając errno), 0 w przypadku pomyślnego zakończenia, a 1 gdy podany klucz nie występuje w pliku.

put

Wskaźnik do funkcji przechowującej pary klucz/dane w bazie danych.

Parametr znacznik może mieć jedną z następujących wartości:

R_SETCURSOR jest dostępne jedynie dla metod dostępu DB_BTREE i DB_RECNO, gdyż zakłada, że klucze mają ustaloną, niezmienną kolejność.

R_IAFTER i R_IBEFORE są dostępne jedynie dla metody dostępu DB_RECNO, gdyż każde z nich zakłada, że metoda dostępu umożliwia tworzenie nowych kluczy. Jest to prawda jedynie w przypadku, gdy klucze są uporządkowane i niezależne, na przykład numery rekordów.

Domyślne zachowanie funkcji put polega na wprowadzeniu nowej pary klucz/dane, zastępując uprzednio istniejący klucz.

Funkcje put zwracają -1 w przypadku błędu (ustawiając errno), 0 w przypadku pomyślnego zakończenia, a 1 gdy ustawiony jest znacznik R_NOOVERWRITE, a klucz już istnieje w pliku.

seq

Wskaźnik do funkcji stanowiącej interfejs dla sekwencyjnego pobierania danych z bazy. Adres i długość klucza są zwracane w strukturze wskazywanej przez klucz, zaś adres i rozmiar danych są zwracane w strukturze wskazywanej przez dane.

Sekwencyjne pobieranie par klucz/dane może się rozpocząć w dowolnym momencie, a wywołania funkcji del, get, put, i sync nie mają wpływu na pozycję ``kursora''. Zmiany bazy danych podczas sekwencyjnego czytania będą odwzorowane podczas odczytów, tzn. rekordy wstawione za kursorem nie będą zwrócone, podczas gdy rekordy wstawione przed kursorem zostaną zwrócone.

Wartość znacznik musi być ustawiona jako jedna z poniższych wartości:

R_LAST i R_PREV są dostępne jedynie dla metod dostępu DB_BTREE i DB_RECNO, gdyż zakładają, że klucze mają ustaloną, niezmienną kolejność.

Funkcje seq zwracają -1 w przypadku błędu (ustawiając errno), 0 w przypadku pomyślnego zakończenia, a 1 gdy brak w bazie pary klucz/dane mniejszej lub większej niż podany lub aktualny klucz. Dla metody dostępu DB_RECNO, gdy plik bazy danych jest specjalnym plikiem znakowym, a żadna pełna para klucz/dane nie jest w danej chwili dostępna, funkcja seq zwraca 2.

sync

Wskaźnik do funkcji zrzucającej zbuforowane informacje na dysk. Jeśli baza danych znajduje się wyłącznie w pamięci, to funkcja sync nic nie robi i kończy się zawsze pomyślnie.

Wartość znacznika może być jedną z następujących wartości:

Funkcje sync zwracają -1 w przypadku błędu (ustawiając errno), 0 w przypadku pomyślnego zakończenia.

Pary KLUCZ/DANE¶

data

Wskaźnik do łańcucha bajtów.

size

Długość łańcucha bajtów.

BŁĘDY¶

[EFTYPE]

Plik jest nieprawidłowo sformatowany.

[EINVAL]

Podano parametr (funkcję mieszającą, bajt wyrównania, itp.) niezgodny z aktualną specyfikacją pliku, lub który nie ma sensu dla funkcji (na przykład, użycie kursora bez uprzedniej inicjalizacji) lub występuje niezgodność wersji pomiędzy plikiem i oprogramowaniem.

ZOBACZ TAKŻE¶

BUGS¶

INFORMACJE O TŁUMACZENIU¶

man --locale=C 3 dbopen