.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2022 Alejandro Colomar .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH scanf 3 "15 iunie 2024" "Pagini de manual de Linux 6.9.1" .SH NUME scanf, fscanf, vscanf, vfscanf \- conversia formatului FILE (fișierului) de intrare .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBint scanf(const char *restrict \fP\fIformat\fP\fB, ...);\fP \fBint fscanf(FILE *restrict \fP\fIstream\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP .P \fB#include \fP .P \fBint vscanf(const char *restrict \fP\fIformat\fP\fB, va_list \fP\fIap\fP\fB);\fP \fBint vfscanf(FILE *restrict \fP\fIstream\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, va_list \fP\fIap\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 \fBvscanf\fP(), \fBvfscanf\fP(): .nf _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L .fi .SH DESCRIERE Familia de funcții \fBscanf\fP() scanează datele de intrare formatate ca \fBsscanf\fP(3), dar citite dintr\-un \fIFILE\fP. Este foarte dificil de utilizat corect aceste funcții și este preferabil să se citească linii întregi cu \fBfgets\fP(3) sau \fBgetline\fP(3) și să se analizeze ulterior cu \fBsscanf\fP(3) sau cu funcții mai specializate, cum ar fi \fBstrtol\fP(3). .P Funcția \fBscanf\fP() citește datele de intrare din fluxul de intrare standard \fIstdin\fP, iar \fBfscanf\fP() citește datele de intrare din indicatorul de flux \fIstream\fP. .P Funcția \fBvfscanf\fP() este analogă cu \fBvfprintf\fP(3) și citește datele de intrare de la indicatorul de flux \fIstream\fP utilizând o listă de indicatori cu argument variabil (a se vedea \fBstdarg\fP(3). Funcția \fBvscanf\fP() este analogă cu \fBvprintf\fP(3) și citește de la intrarea standard. .SH "VALOAREA RETURNATĂ" În caz de reușită, aceste funcții returnează numărul de elemente de intrare care s\-au potrivit cu succes și au fost atribuite; acesta poate fi mai mic decât cel prevăzut sau chiar zero, în cazul unui eșec de potrivire inițială. .P Valoarea \fBEOF\fP este returnată dacă se ajunge la sfârșitul intrării înainte de prima conversie reușită sau de un eșec de potrivire. \fBEOF\fP este, de asemenea, returnată în cazul în care apare o eroare de citire, caz în care se activează indicatorul de eroare pentru flux (a se vedea \fBferror\fP(3)), iar \fIerrno\fP este configurată pentru a indica eroarea. .SH ERORI\-IEȘIRE .TP \fBEAGAIN\fP Descriptorul de fișier subiacent lui \fIstream\fP este marcat ca fiind neblocant, iar operațiunea de citire s\-ar bloca. .TP \fBEBADF\fP Descriptorul de fișier subiacentlui \fIstream\fP nu este valid sau nu este deschis pentru citire. .TP \fBEILSEQ\fP Secvența de octeți introdusă nu formează un caracter valid. .TP \fBEINTR\fP Operația de citire a fost întreruptă de un semnal; a se vedea \fBsignal\fP(7). .TP \fBEINVAL\fP Nu sunt suficiente argumente; sau \fIformat\fP este NULL. .TP \fBENOMEM\fP Memorie insuficientă. .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 \fBscanf\fP(), \fBfscanf\fP(), \fBvscanf\fP(), \fBvfscanf\fP() T} Siguranța firelor MT\-Safe locale .TE .SH STANDARDE C11, POSIX.1\-2008. .SH ISTORIC C99, POSIX.1\-2001. .SH AVERTISMENTE Aceste funcții îngreunează distincția dintre liniile noi și alte spații albe, ceea ce este deosebit de problematic în cazul intrărilor de tip „line\-buffered”, cum ar fi fluxul de intrare standard. .P Aceste funcții nu pot raporta erori după ultima specificație de conversie nesuprimată. .SH ERORI Este imposibil să se știe cu exactitate câte caractere au consumat aceste funcții din fluxul de intrare, deoarece ele raportează doar numărul de conversii reușite. De exemplu, dacă intrarea este "123\[rs]n\ a", \fIscanf(\[dq]%d\ %d\[dq], &a, &b)\fP va consuma cifrele, linia nouă și spațiul, dar nu și litera a. Acest lucru face dificilă recuperarea în cazul unei intrări nevalide. .SH "CONSULTAȚI ȘI" \fBfgets\fP(3), \fBgetline\fP(3), \fBsscanf\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 .