.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" References consulted: .\" Linux libc source code .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sun Jul 25 10:54:03 1993 by Rik Faith (faith@cs.unc.edu) .\" Fixed typo, aeb, 950823 .\" 2002-02-22, joey, mihtjel: Added strtoull() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH strtoul 3 "20 iulie 2023" "Pagini de manual de Linux 6.05.01" .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 REZUMAT .nf \fB#include \fP .PP \fBunsigned long strtoul(const char *restrict \fP\fInptr\fP\fB,\fP \fB char **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 **restrict \fP\fIendptr\fP\fB, int \fP\fIbază\fP\fB);\fP .fi .PP .RS -4 Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați \fBfeature_test_macros\fP(7)): .RE .PP \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. .PP Ș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ă \fIbază\fP este zero sau 16, șirul poate include apoi un prefix „0x”, iar numărul va fi citit în baza 16; în caz contrar, o \fIbază\fP zero este considerată ca fiind 10 (zecimal), cu excepția cazului în care următorul caracter este „0”, caz în care este considerat ca fiind 8 (octal). .PP 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). .PP Dacă \fIendptr\fP nu este NULL, \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 cazul special, dacă \fI*nptr\fP nu este „\e0”, dar \fI**endptr\fP este „\e0” la returnare, întregul șir este valid. .PP 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 .TP \fBEINVAL\fP (nu în C99) \fIbaza\fP dată conține o valoare neacceptată. .TP \fBERANGE\fP Valoarea rezultată a fost în afara intervalului. .PP 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 .sp 1 .SH STANDARDE C11, POSIX.1\-2008. .SH ISTORIC .TP \fBstrtoul\fP() POSIX.1\-2001, C89, SVr4. .TP \fBstrtoull\fP() POSIX.1\-2001, C99. .SH NOTE 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. .PP Î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ă). .PP BSD are de asemenea .PP .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 .PP 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(). .PP Valorile negative sunt considerate intrări valide și sunt convertite în mod silențios în valoarea echivalentă \fIunsigned long\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 .