recno(3)                   Library Functions Manual                   recno(3)

NUME
       recno - metoda de acces la baza de date cu numarul de inregistrare

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

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

DESCRIERE
       Noteaza bine: Aceasta pagina documenteaza interfe<?>ele furnizate pana
       la glibc 2.1. Incepand cu glibc 2.2, glibc nu mai furnizeaza aceste
       interfe<?>e. Probabil ca, in schimb, cauta<?>i API-urile furnizate de
       biblioteca libdbb.

       Rutina dbopen(3) este interfa<?>a bibliotecii cu fi<?>ierele de baze de
       date. Unul dintre formatele de fi<?>iere acceptate este cel al
       fi<?>ierelor cu numere de inregistrare. Descrierea generala a metodelor
       de accesare a bazei de date se gase<?>te in dbopen(3), aceasta pagina
       de manual descrie doar informa<?>iile specifice pentru recno.

       Structura de date a numarului de inregistrare este formata din
       inregistrari cu lungime variabila sau fixa stocate intr-un format de
       fi<?>ier plat, accesate prin numarul logic de inregistrare. Existen<?>a
       inregistrarii cu numarul cinci implica existen<?>a inregistrarilor de
       la unu la patru, iar <?>tergerea inregistrarii cu numarul unu face ca
       inregistrarea cu numarul cinci sa fie renumerotata in inregistrarea cu
       numarul patru, iar cursorul, daca este pozi<?>ionat dupa inregistrarea
       cu numarul unu, sa se deplaseze cu o inregistrare in jos.

       Structura de date specifica metodei de acces recno furnizata lui
       dbopen(3) este definita in fi<?>ierul de includere <db.h> dupa cum
       urmeaza:

           typedef struct {
               unsigned long flags;
               unsigned int  cachesize;
               unsigned int  psize;
               int           lorder;
               size_t        reclen;
               unsigned char bval;
               char         *bfname;
           } RECNOINFO;

       Elementele acestei structuri sunt definite dupa cum urmeaza:

       flags  Valoarea fanionului este specificata prin combinarea prin OR a
              oricareia dintre urmatoarele valori:

              R_FIXEDLEN
                     Inregistrarile sunt de lungime fixa, nu sunt delimitate
                     de octe<?>i. Elementul de structura reclen specifica
                     lungimea inregistrarii, iar elementul de structura bval
                     este utilizat ca caracter de rezerva. Toate
                     inregistrarile inserate in baza de date care au o lungime
                     mai mica de reclen octe<?>i sunt automat completate.

              R_NOKEY
                     In interfa<?>a specificata de dbopen(3), recuperarea
                     secven<?>iala a inregistrarilor completeaza atat cheia,
                     cat <?>i structurile de date ale apelantului. In cazul in
                     care se specifica indicatorul R_NOKEY, rutinele cursor nu
                     trebuie sa completeze structura cheie. Acest lucru
                     permite aplica<?>iilor sa recupereze inregistrarile de la
                     sfar<?>itul fi<?>ierelor fara a citi toate inregistrarile
                     intermediare.

              R_SNAPSHOT
                     Acest fanion impune ca o imagine instantanee a
                     fi<?>ierului sa fie luata atunci cand este apelat
                     dbopen(3), in loc sa permita citirea inregistrarilor
                     nemodificate din fi<?>ierul original.

       cachesize
              Dimensiunea maxima sugerata, in octe<?>i, a memoriei cache.
              Aceasta valoare este numai consultativa, iar metoda de acces va
              aloca mai multa memorie in loc sa e<?>ueze. Daca cachesize este
              0 (nu este specificata nicio dimensiune), se utilizeaza o
              memorie cache implicita.

       psize  Metoda de acces recno stocheaza copiile in memorie ale
              inregistrarilor sale intr-un btree. Aceasta valoare reprezinta
              dimensiunea (in octe<?>i) a paginilor utilizate pentru nodurile
              din arborele respectiv. Daca psize este 0 (nu este specificata
              dimensiunea paginii), dimensiunea paginii este aleasa pe baza
              dimensiunii blocului de intrare/ie<?>ire din sistemul de
              fi<?>iere. Pentru mai multe informa<?>ii, consulta<?>i btree(3).

       lorder Ordinea octe<?>ilor pentru numerele intregi din metadatele
              stocate in baza de date. Numarul ar trebui sa reprezinte ordinea
              ca numar intreg; de exemplu, ordinea big endian ar fi numarul
              4,321. Daca lorder este 0 (nu se specifica nicio ordine), se
              utilizeaza ordinea curenta a gazdei.

       reclen Lungimea unei inregistrari de lungime fixa.

       bval   Octetul de delimitare care trebuie utilizat pentru a marca
              sfar<?>itul unei inregistrari in cazul inregistrarilor de
              lungime variabila <?>i caracterul de umplere in cazul
              inregistrarilor de lungime fixa. Daca nu se specifica nicio
              valoare, se utilizeaza linii noi (,,\n") pentru a marca
              sfar<?>itul inregistrarilor de lungime variabila, iar
              inregistrarile de lungime fixa sunt completate cu spa<?>ii.

       bfname Metoda de acces recno stocheaza copiile in memorie ale
              inregistrarilor sale intr-un btree. Daca bfname nu este NULL, se
              specifica numele fi<?>ierului btree, ca <?>i cum ar fi
              specificat ca nume de fi<?>ier pentru un dbopen(3) al unui
              fi<?>ier btree.

       Partea de date a perechii cheie/date utilizata de metoda de acces recno
       este aceea<?>i cu cea a altor metode de acces. Cheia este diferita.
       Campul data al cheii trebuie sa fie un indicator la o loca<?>ie de
       memorie de tip recno_t, a<?>a cum este definit in fi<?>ierul de
       includere <db.h>. Acest tip este, in mod normal, cel mai mare tip
       integral fara semn disponibil pentru implementare. Campul size al cheii
       trebuie sa fie dimensiunea acestui tip.

       Deoarece nu pot exista metadate asociate cu fi<?>ierele de baza ale
       metodei de acces recno, orice modificari aduse valorilor implicite (de
       exemplu, lungimea fixa a inregistrarii sau valoarea separatorului de
       octe<?>i) trebuie sa fie specificate in mod explicit de fiecare data
       cand fi<?>ierul este deschis.

       In interfa<?>a specificata de dbopen(3), utilizarea interfe<?>ei put
       pentru a crea o noua inregistrare va duce la crearea mai multor
       inregistrari goale daca numarul inregistrarii este cu mai mult de unu
       mai mare decat cea mai mare inregistrare existenta in prezent in baza
       de date.

ERORI-IE<?>IRE
       Rutinele metodei de acces recno pot e<?>ua <?>i configura errno pentru
       oricare dintre erorile specificate pentru rutina de biblioteca
       dbopen(3) sau pentru urmatoarele:

       EINVAL S-a incercat adaugarea unei inregistrari la o baza de date cu
              lungime fixa care era prea mare pentru a incapea.

ERORI
       Se accepta numai ordinea big <?>i little endian a octe<?>ilor.

CONSULTA<?>I <?>I
       btree(3), dbopen(3), hash(3), mpool(3)

       Document Processing in a Relational Database System, Michael
       Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene
       Lynn, Memorandum nr. UCB/ERL M82/32, mai 1982.

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

4.4 Berkeley Distribution        23 iulie 2024                        recno(3)