random(3)

NUME
random, srandom, initstate, setstate - generator de numere aleatoare

BIBLIOTECA
Biblioteca C standard (libc, -lc)

SINOPSIS
#include <stdlib.h>

long random(void);
void srandom(unsigned int seed);

char *initstate(unsigned int seed, char state[.n], size_t n);
char *setstate(char *state);

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

random(), srandom(), initstate(), setstate():
    _XOPEN_SOURCE >= 500
        || /* glibc >= 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE

DESCRIERE
Funcția random() utilizează un generator de numere aleatoare cu reacție aditivă neliniară care utilizează un tabel implicit de 31 de numere întregi lungi pentru a returna numere pseudoaleatoare succesive în intervalul 0-2^31 - 1. Perioada acestui generator de numere aleatoare este foarte mare, aproximativ 16 * ((2^31) - 1).

Funcția srandom() își stabilește argumentul ca sămânță pentru o nouă secvență de numere întregi pseudoaleatoare care va fi returnată de random(). Aceste secvențe pot fi repetate prin apelarea srandom() cu aceeași valoare de sămânță. În cazul în care nu se furnizează nicio valoare de sămânță, funcția random() este automat însămânțată cu o valoare de 1.

Funcția initstate() permite inițializarea unei matrice de stări state pentru a fi utilizată de random(). Dimensiunea matricei de stare n este utilizată de initstate() pentru a decide cât de sofisticat trebuie să fie generatorul de numere aleatoare pe care trebuie să-l utilizeze - cu cât matricea de stare este mai mare, cu atât mai bune vor fi numerele aleatoare. Valorile „optime” actuale pentru dimensiunea matricei de stări n sunt 8, 32, 64, 128 și 256 de octeți; alte valori vor fi rotunjite la cea mai apropiată valoare cunoscută. Dacă se utilizează mai puțin de 8 octeți, se produce o eroare. seed este sămânța pentru inițializare, care specifică un punct de pornire pentru secvența de numere aleatoare și asigură repornirea în același punct.

Funcția setstate() modifică matricea de stare utilizată de funcția random(). Matricea de stare state este utilizată pentru generarea numerelor aleatoare până la următorul apel al funcției initstate() sau setstate(). state trebuie mai întâi să fi fost inițializat cu ajutorul initstate() sau să fie rezultatul unui apel anterior al setstate().

VALOAREA RETURNATĂ
Funcția random() returnează o valoare între 0 și (2^31) - 1. Funcția srandom() nu returnează nicio valoare.

Funcția initstate() returnează un indicator la matricea de stare anterioară. În caz de eșec, aceasta returnează NULL, iar errno este configurată pentru a indica eroarea.

În caz de succes, setstate() returnează un indicator la matricea de stare anterioară. În caz de eșec, aceasta returnează NULL, iar errno este configurată pentru a indica eroarea.

ERORI-IEȘIRE

EINVAL
    Argumentul state dat la setstate() a fost NULL.

EINVAL
    O matrice de stare mai mică de 8 octeți a fost specificată la initstate().

ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).
Interfață | Atribut | Valoare
random(), srandom(), initstate(), setstate() | Siguranța firelor | MT-Safe

STANDARDE
POSIX.1-2008.

ISTORIC
POSIX.1-2001, 4.3BSD.

NOTE
Generarea numerelor aleatoare este un subiect complex. Numerical Recipes in C: The Art of Scientific Computing (William H. Press, Brian P. Flannery, Saul A. Teukolsky, William T. Vetterling; New York: Cambridge University Press, 2007, ed. a 3-a) oferă o discuție excelentă a problemelor practice de generare a numerelor aleatoare în capitolul 7 (Random Numbers).

Pentru o discuție mai teoretică, care acoperă în profunzime și multe aspecte practice, a se vedea capitolul 3 (Random Numbers) din The Art of Computer Programming Donald E. Knuth's, volumul 2 (Seminumerical Algorithms), 2nd ed.; Reading, Massachusetts: Addison-Wesley Publishing Company, 1981.

PRECAUȚII
Funcția random() nu ar trebui utilizată în programele cu mai multe fire de execuție în care este necesar un comportament reproductibil. Folosiți random_r(3) în acest scop.

ERORI
În conformitate cu POSIX, initstate() ar trebui să returneze NULL în caz de eroare. În implementarea glibc, errno este (așa cum este specificat) stabilită în caz de eroare, dar funcția nu returnează NULL.

CONSULTAȚI ȘI
getrandom(2), drand48(3), rand(3), random_r(3), srand(3)

TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.