random_r(3)                Library Functions Manual                random_r(3)

NUME
       random_r, srandom_r, initstate_r, setstate_r - generator de numere
       aleatoare reentrante

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdlib.h>

       int random_r(struct random_data *restrict buf,
                    int32_t *restrict result);
       int srandom_r(unsigned int seed, struct random_data *buf);

       int initstate_r(unsigned int seed, char statebuf[restrict .statelen],
                    size_t statelen, struct random_data *restrict buf);
       int setstate_r(char *restrict statebuf,
                    struct random_data *restrict buf);

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       random_r(), srandom_r(), initstate_r(), setstate_r():
           /* glibc >= 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

DESCRIERE
       Aceste func<?>ii sunt echivalentele reentrante ale func<?>iilor
       descrise in random(3). Ele sunt adecvate pentru utilizarea in programe
       cu mai multe fire de execu<?>ie, in care fiecare fir de execu<?>ie
       trebuie sa ob<?>ina o secven<?>a independenta <?>i reproductibila de
       numere aleatoare.

       Func<?>ia random_r() este ca <?>i random(3), cu excep<?>ia faptului ca,
       in loc sa utilizeze informa<?>iile de stare pastrate intr-o variabila
       globala, utilizeaza informa<?>iile de stare din argumentul indicat de
       buf, care trebuie sa fi fost ini<?>ializat anterior de initstate_r().
       Numarul aleatoriu generat este returnat in argumentul result.

       Func<?>ia srandom_r() este la fel ca srandom(3), cu excep<?>ia faptului
       ca ini<?>ializeaza saman<?>a pentru generatorul de numere aleatoare a
       carui stare este men<?>inuta in obiectul indicat de buf, care trebuie
       sa fi fost ini<?>ializat in prealabil de initstate_r(), in loc de
       saman<?>a asociata cu variabila de stare globala.

       Func<?>ia initstate_r() este ca initstate(3), cu excep<?>ia faptului ca
       ini<?>ializeaza starea in obiectul indicat de buf, in loc sa
       ini<?>ializeze variabila de stare globala. Inainte de a apela aceasta
       func<?>ie, campul buf.state trebuie ini<?>ializat la NULL.  Func<?>ia
       initstate_r() inregistreaza un indicator la argumentul statebuf in
       interiorul structurii indicate de buf. Astfel, statebuf nu trebuie sa
       fie eliberat atata timp cat buf este inca in uz; (a<?>adar, statebuf ar
       trebui sa fie alocat de obicei ca o variabila statica sau sa fie alocat
       pe gramada cu ajutorul malloc(3) sau similar).

       Func<?>ia setstate_r() este ca setstate(3), cu excep<?>ia faptului ca
       modifica starea din obiectul indicat de buf, in loc sa modifice
       variabila de stare globala. state trebuie mai intai sa fi fost
       ini<?>ializat cu initstate_r() sau sa fie rezultatul unui apel anterior
       al func<?>iei setstate_r().

VALOAREA RETURNATA
       Toate aceste func<?>ii returneaza 0 in caz de succes.  In caz de
       eroare, se returneaza -1, cu errno configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EINVAL O matrice de stare mai mica de 8 octe<?>i a fost specificata la
              initstate_r().

       EINVAL Argumentul statebuf sau buf la setstate_r() a fost NULL.

       EINVAL Argumentul buf sau result din random_r() a fost NULL.

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +-----------------------------+---------------------+------------------+
       |Interfa<?>a                  | Atribut             | Valoare          |
       +-----------------------------+---------------------+------------------+
       |random_r(), srandom_r(),     | Siguran<?>a firelor | MT-Safe race:buf |
       |initstate_r(), setstate_r()  |                     |                  |
       +-----------------------------+---------------------+------------------+
STANDARDE
       GNU.

ERORI
       Interfa<?>a initstate_r() este confuza. Se pare ca tipul random_data
       este menit sa fie opac, dar implementarea cere utilizatorului fie sa
       ini<?>ializeze campul buf.state la NULL, fie sa elimine intreaga
       structura inainte de apel.

CONSULTA<?>I <?>I
       drand48(3), rand(3), random(3)

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>.

Pagini de manual de Linux 6.06 31 octombrie 2023                   random_r(3)