open_memstream(3) Library Functions Manual open_memstream(3) NUME open_memstream, open_wmemstream, open_wmemstream - deschide un flux de memorie tampon dinamica BIBLIOTECA Biblioteca C standard (libc, -lc) REZUMAT #include FILE *open_memstream(char **ptr, size_t *sizeloc); #include FILE *open_wmemstream(wchar_t **ptr, size_t *sizeloc); Cerine pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultai feature_test_macros(7)): open_memstream(), open_wmemstream(): Incepand cu glibc 2.10 _POSIX_C_SOURCE >= 200809L Inainte de glibc 2.10: _GNU_SOURCE DESCRIERE Funcia open_memstream() deschide un flux pentru a scrie intr-o memorie tampon. Funcia aloca dinamic memoria tampon, iar aceasta crete automat in funcie de necesitai. Iniial, memoria tampon are dimensiunea zero. Dupa inchiderea fluxului, apelantul trebuie sa elibereze (sa apeleze free(3)) aceasta memorie tampon. Locaiile indicate de ptr i sizeloc sunt utilizate pentru a raporta, respectiv, locaia curenta i dimensiunea memoriei tampon. Locaiile la care se face referire prin aceti indicatori sunt actualizate de fiecare data cand fluxul este golit (fflush(3)) i cand fluxul este inchis (fclose(3)). Aceste valori raman valabile doar atat timp cat apelantul nu mai efectueaza nici o ieire pe flux. In cazul in care se efectueaza alte ieiri, fluxul trebuie sa fie din nou curaat inainte de a incerca sa acceseze aceste valori. La sfaritul memoriei tampon se pastreaza un octet nul. Acest octet nu este este inclus in valoarea dimensiunii stocata la sizeloc. Fluxul pastreaza noiunea de poziie curenta, care este iniial zero (inceputul memoriei tampon). Fiecare operaie de scriere ajusteaza implicit poziia memoriei tampon. Poziia memoriei tampon a fluxului poate fi modificata in mod explicit cu fseek(3) sau fseeko(3). Mutarea poziiei in memoria tampon dupa sfaritul datelor deja scrise umple spaiul intermediar cu caractere nule. open_wmemstream() este similara cu open_memstream(), dar opereaza pe caractere late in loc de octei. VALOAREA RETURNATA La finalizarea cu succes, open_memstream() i open_wmemstream() returneaza un indicator FILE. In caz contrar, se returneaza NULL, iar errno este configurata pentru a indica eroarea. ATRIBUTE Pentru o explicaie a termenilor folosii in aceasta seciune, a se vedea attributes(7). +--------------------------------------+---------------------+---------+ |Interfaa | Atribut | Valoare | +--------------------------------------+---------------------+---------+ |open_memstream(), open_wmemstream() | Sigurana firelor | MT-Safe | +--------------------------------------+---------------------+---------+ STANDARDE POSIX.1-2008. ISTORIC open_memstream() glibc 1.0.x. open_wmemstream() glibc 2.4. NOTE Nu exista niciun descriptor de fiier asociat cu fluxul de fiiere returnat de aceste funcii (de exemplu, fileno(3) va returna o eroare daca este apelat pe fluxul returnat). ERORI Inainte de glibc 2.7, cautarea dincolo de capatul unui flux creat de open_memstream() nu marete memoria tampon; in schimb, apelul fseek(3) eueaza, returnand -1. EXEMPLE A se vedea fmemopen(3). CONSULTAI I fmemopen(3), fopen(3), setbuf(3) TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . Pagini de manual de Linux 6.06 28 decembrie 2023 open_memstream(3)