rand(3)                    Library Functions Manual                    rand(3)

NUME
       rand, rand_r, srand - generator de numere pseudo-aleatorii

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <stdlib.h>

       int rand(void);
       void srand(unsigned int seed);

       [[depreciat]] int rand_r(unsigned int *seedp);

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

       rand_r():
           Incepand cu glibc 2.24:
               _POSIX_C_SOURCE >= 199506L
           glibc 2.23 <?>i versiunile anterioare:
               _POSIX_C_SOURCE

DESCRIERE
       Func<?>ia rand() returneaza un numar intreg pseudo-aleatoriu in
       intervalul de la 0 la RAND_MAX inclusiv (adica intervalul matematic
       [0, RAND_MAX]).

       Func<?>ia srand() stabile<?>te argumentul sau ca saman<?>a pentru o
       noua secven<?>a de numere intregi pseudo-aleatorii care va fi returnata
       de rand(). Aceste secven<?>e pot fi repetate prin apelarea srand() cu
       aceea<?>i valoare de saman<?>a.

       In cazul in care nu este furnizata nicio valoare de saman<?>a,
       func<?>ia rand() este alimentata automat cu o valoare de 1.

       Func<?>ia rand() nu este reentranta, deoarece utilizeaza o stare
       ascunsa care este modificata la fiecare apel. Aceasta ar putea fi doar
       valoarea ini<?>iala care va fi utilizata de urmatorul apel sau ar putea
       fi ceva mai elaborat. Pentru a ob<?>ine un comportament reproductibil
       intr-o aplica<?>ie cu fire de execu<?>ie, aceasta stare trebuie sa fie
       explicita; acest lucru poate fi realizat cu ajutorul func<?>iei
       reentrante rand_r().

       Ca <?>i rand(), rand_r() returneaza un numar intreg pseudo-aleatoriu in
       intervalul [0, RAND_MAX]. Argumentul seedp este un indicator catre un
       unsigned int care este utilizat pentru a stoca starea intre apeluri.
       Daca rand_r() este apelat cu aceea<?>i valoare ini<?>iala pentru
       numarul intreg indicat de seedp, iar aceasta valoare nu este modificata
       intre apeluri, atunci va rezulta aceea<?>i secven<?>a pseudo-aleatorie.

       Valoarea indicata de argumentul seedp din rand_r() ofera doar o
       cantitate foarte mica de stare, astfel incat aceasta func<?>ie va fi un
       generator pseudo-aleatoriu slab. Incerca<?>i in schimb drand48_r(3).

VALOAREA RETURNATA
       Func<?>iile rand() <?>i rand_r() returneaza o valoare cuprinsa intre 0
       <?>i RAND_MAX (inclusiv). Func<?>ia srand() nu returneaza nicio
       valoare.

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |rand(), rand_r(), srand()             | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
VERSIUNI
       Versiunile de rand() <?>i srand() din biblioteca Linux C utilizeaza
       acela<?>i generator de numere aleatoare ca <?>i random(3) <?>i
       srandom(3), astfel incat bi<?>ii de ordin inferior ar trebui sa fie la
       fel de aleatori ca <?>i cei de ordin superior. Cu toate acestea, in
       implementarile mai vechi ale rand() <?>i in implementarile actuale pe
       diferite sisteme, bi<?>ii de ordin inferior sunt mult mai pu<?>in
       aleatori decat cei de ordin superior. Nu utiliza<?>i aceasta func<?>ie
       in aplica<?>ii destinate sa fie portabile atunci cand este necesar un
       bun caracter aleatoriu; (utiliza<?>i in schimb random(3).)

STANDARDE
       rand()
       srand()
              C11, POSIX.1-2008.

       rand_r()
              POSIX.1-2008.

ISTORIC
       rand()
       srand()
              SVr4, 4.3BSD, C89, POSIX.1-2001.

       rand_r()
              POSIX.1-2001. Obsoleta in POSIX.1-2008.

EXEMPLE
       POSIX.1-2001 ofera urmatorul exemplu de implementare a rand() <?>i
       srand(), posibil util atunci cand este nevoie de aceea<?>i secven<?>a
       pe doua ma<?>ini diferite.

           static unsigned long next = 1;

           /* RAND_MAX se presupune a fi 32767 */
           int myrand(void) {
               next = next * 1103515245 + 12345;
               return((unsigned)(next/65536) % 32768);
           }

           void mysrand(unsigned int seed) {
               next = seed;
           }

       Urmatorul program poate fi utilizat pentru a afi<?>a secven<?>a
       pseudo-aleatoare produsa de rand() atunci cand i se da o anumita
       saman<?>a. Atunci cand saman<?>a este -1, programul utilizeaza o
       saman<?>a aleatoare.

           #include <stdio.h>
           #include <stdlib.h>

           int
           main(int argc, char *argv[])
           {
               int           r;
               unsigned int  seed, nloops;

               if (argc != 3) {
                   fprintf(stderr, "Utilizare: %s <seed> <nloops>\n", argv[0]);
                   exit(EXIT_FAILURE);
               }

               seed = atoi(argv[1]);
               nloops = atoi(argv[2]);

               if (seed == -1) {
                   seed = arc4random();
                   printf("saman<?>a: %u\n", seed);
               }

               srand(seed);
               for (unsigned int j = 0; j < nloops; j++) {
                   r =  rand();
                   printf("%d\n", r);
               }

               exit(EXIT_SUCCESS);
           }

CONSULTA<?>I <?>I
       drand48(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                       rand(3)