.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH strtoul 3 "8 februarie 2026" "Pagini de manual de Linux 6.18" .SH NUME strtoul, strtoull, strtouq \- convertește un șir de caractere într\-un întreg lung fără semn .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBunsigned long strtoul(const char *restrict \fP\fInptr\fP\fB,\fP \fB char **_Nullable restrict \fP\fIendptr\fP\fB, int \fP\fIbază\fP\fB);\fP \fBunsigned long long strtoull(const char *restrict \fP\fInptr\fP\fB,\fP \fB char **_Nullable restrict \fP\fIendptr\fP\fB, int \fP\fIbază\fP\fB);\fP .fi .P .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .P \fBstrtoull\fP(): .nf _ISOC99_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE .fi .SH DESCRIERE Funcția \fBstrtoul\fP() convertește partea inițială a șirului din \fInptr\fP într\-o valoare \fIunsigned long\fP în funcție de \fIbaza\fP dată, care trebuie să fie cuprinsă între 2 și 36 inclusiv, sau să fie valoarea specială 0. .P Șirul poate începe cu o cantitate arbitrară de spațiu alb (determinată de \fBisspace\fP(3)), urmată de un singur semn opțional „+” sau „\-”. Dacă \fIbaza\fP este zero sau 16, șirul poate include un prefix „0x” sau „0X”, iar numărul va fi citit în baza 16; dacă \fIbaza\fP este zero sau 2, șirul poate include un prefix „0b” sau „0B”, iar numărul va fi citit în baza 2; altfel, o \fIbază\fP zero este considerată 10 (zecimal), cu excepția cazului în care următorul caracter este „0”, caz în care este considerată 8 (octal). .P Restul șirului este convertit într\-o valoare \fIunsigned long\fP în mod evident, oprindu\-se la primul caracter care nu este o cifră validă în baza dată; (în bazele mai mari de 10, litera „A”, fie cu majusculă, fie cu minusculă, reprezintă 10, „B” reprezintă 11, și așa mai departe, „Z” reprezentând 35). .P Dacă \fIendptr\fP nu este NULL, iar \fIbaza\fP este acceptată, \fBstrtoul\fP() stochează adresa primului caracter nevalid în \fI*endptr\fP. În cazul în care nu au existat deloc cifre, \fBstrtoul\fP() stochează valoarea originală a \fInptr\fP în \fI*endptr\fP (și returnează 0). În special, dacă \fI*nptr\fP nu este „\[rs]0”, dar \fI**endptr\fP este „\[rs]0” la returnare, întregul șir este valid. .P Funcția \fBstrtoull\fP() funcționează la fel ca funcția \fBstrtoul\fP(), dar returnează o valoare \fIunsigned long long\fP. .SH "VALOAREA RETURNATĂ" Funcția \fBstrtoul\fP() returnează fie rezultatul conversiei, fie, în cazul în care a existat un semn minus, negația rezultatului conversiei, reprezentat ca o valoare fără semn, cu excepția cazului în care valoarea originală (fără semn) ar fi depășită; în acest din urmă caz, \fBstrtoul\fP() returnează \fBULONG_MAX\fP și configurează \fIerrno\fP la \fBERANGE\fP. Exact același lucru este valabil și pentru \fBstrtoull\fP() (cu \fBULLONG_MAX\fP în loc de \fBULONG_MAX\fP). .SH ERORI\-IEȘIRE Această funcție nu modifică \fIerrno\fP în caz de succes. .TP \fBEINVAL\fP (nu în C99) \fIbaza\fP dată conține o valoare neacceptată. .TP \fBERANGE\fP Valoarea rezultată a fost în afara intervalului. .P Implementarea poate, de asemenea, să stabilească \fIerrno\fP la \fBEINVAL\fP în cazul în care nu a fost efectuată nicio conversie (nu se vede nicio cifră și se returnează 0). .SH ATRIBUTE Pentru o explicație a termenilor folosiți în această secțiune, a se vedea \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interfață Atribut Valoare T{ .na .nh \fBstrtoul\fP(), \fBstrtoull\fP(), \fBstrtouq\fP() T} Siguranța firelor MT\-Safe locale .TE .SH VERSIUNI În alte configurații regionale decât „C”, pot fi acceptate și alte șiruri; (de exemplu, poate fi acceptat separatorul de mii din configurația regională curentă). .P BSD are de asemenea .P .in +4n .EX \fBu_quad_t strtouq(const char *\fP\fInptr\fP\fB, char **\fP\fIendptr\fP\fB, int \fP\fIbase\fP\fB);\fP .EE .in .P cu o definiție complet analoagă. În funcție de dimensiunea cuvintelor din arhitectura curentă, acest lucru poate fi echivalent cu \fBstrtoull\fP() sau cu \fBstrtoul\fP(). .SH STANDARDE C23, POSIX.1\-2024. .SH ISTORIC .TP \fBstrtoul\fP() POSIX.1\-2001, C89, SVr4. .TP \fBstrtoull\fP() POSIX.1\-2001, C99. .TP „0b”, „0B” C23. glibc 2.38. (Nu există în POSIX.) .SH PRECAUȚII Deoarece \fBstrtoul\fP() poate returna în mod legitim 0 sau \fBULONG_MAX\fP (\fBULLONG_MAX\fP pentru \fBstrtoull\fP()) atât în caz de succes, cât și în caz de eșec, programul apelant ar trebui să stabilească \fIerrno\fP la 0 înainte de apel, iar apoi să determine dacă s\-a produs o eroare verificând dacă \fIerrno\fP are o valoare diferită de zero după apel. .SH ERORI .SS "Numere cu semn" Valorile negative sunt considerate intrări valide și sunt convertite în mod silențios în valoarea echivalentă \fI\%unsigned\ long\fP. .SS "Spațiu alb" Aceste funcții acceptă în mod silențios spațiile albe la început. .SS isalnum(3) Pentru a respinge spațiul alb și/sau un semn, apelați \fBisalnum\fP(3) înainte de \fBstrtoul\fP(). .SH EXEMPLE A se vedea exemplul de pe pagina de manual \fBstrtol\fP(3); utilizarea funcțiilor descrise în această pagină de manual este similară. .SH "CONSULTAȚI ȘI" \fBa64l\fP(3), \fBatof\fP(3), \fBatoi\fP(3), \fBatol\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoumax\fP(3) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .