scanf(3)                   Library Functions Manual                   scanf(3)

NUME
       scanf, fscanf, vscanf, vfscanf - conversia formatului FILE
       (fi<?>ierului) de intrare

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <stdio.h>

       int scanf(const char *restrict format, ...);
       int fscanf(FILE *restrict stream,
                  const char *restrict format, ...);

       #include <stdarg.h>

       int vscanf(const char *restrict format, va_list ap);
       int vfscanf(FILE *restrict stream,
                  const char *restrict format, va_list ap);

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

       vscanf(), vfscanf():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

DESCRIERE
       Familia de func<?>ii scanf() scaneaza datele de intrare formatate ca
       sscanf(3), dar citite dintr-un FILE. Este foarte dificil de utilizat
       corect aceste func<?>ii <?>i este preferabil sa se citeasca linii
       intregi cu fgets(3) sau getline(3) <?>i sa se analizeze ulterior cu
       sscanf(3) sau cu func<?>ii mai specializate, cum ar fi strtol(3).

       Func<?>ia scanf() cite<?>te datele de intrare din fluxul de intrare
       standard stdin, iar fscanf() cite<?>te datele de intrare din
       indicatorul de flux stream.

       Func<?>ia vfscanf() este analoga cu vfprintf(3) <?>i cite<?>te datele
       de intrare de la indicatorul de flux stream utilizand o lista de
       indicatori cu argument variabil (a se vedea stdarg(3). Func<?>ia
       vscanf() este analoga cu vprintf(3) <?>i cite<?>te de la intrarea
       standard.

VALOAREA RETURNATA
       In caz de reu<?>ita, aceste func<?>ii returneaza numarul de elemente de
       intrare care s-au potrivit cu succes <?>i au fost atribuite; acesta
       poate fi mai mic decat cel prevazut sau chiar zero, in cazul unui
       e<?>ec de potrivire ini<?>iala.

       Valoarea EOF este returnata daca se ajunge la sfar<?>itul intrarii
       inainte de prima conversie reu<?>ita sau de un e<?>ec de potrivire.
       EOF este, de asemenea, returnata in cazul in care apare o eroare de
       citire, caz in care se activeaza indicatorul de eroare pentru flux (a
       se vedea ferror(3)), iar errno este configurata pentru a indica
       eroarea.

ERORI-IE<?>IRE
       EAGAIN Descriptorul de fi<?>ier subiacent lui stream este marcat ca
              fiind neblocant, iar opera<?>iunea de citire s-ar bloca.

       EBADF  Descriptorul de fi<?>ier subiacentlui stream nu este valid sau
              nu este deschis pentru citire.

       EILSEQ Secven<?>a de octe<?>i introdusa nu formeaza un caracter valid.

       EINTR  Opera<?>ia de citire a fost intrerupta de un semnal; a se vedea
              signal(7).

       EINVAL Nu sunt suficiente argumente; sau format este NULL.

       ENOMEM Memorie insuficienta.

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

       +-------------------------------+---------------------+----------------+
       |Interfa<?>a                    | Atribut             | Valoare        |
       +-------------------------------+---------------------+----------------+
       |scanf(), fscanf(), vscanf(),   | Siguran<?>a firelor | MT-Safe locale |
       |vfscanf()                      |                     |                |
       +-------------------------------+---------------------+----------------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       C99, POSIX.1-2001.

AVERTISMENTE
       Aceste func<?>ii ingreuneaza distinc<?>ia dintre liniile noi <?>i alte
       spa<?>ii albe, ceea ce este deosebit de problematic in cazul intrarilor
       de tip ,,line-buffered", cum ar fi fluxul de intrare standard.

       Aceste func<?>ii nu pot raporta erori dupa ultima specifica<?>ie de
       conversie nesuprimata.

ERORI
       Este imposibil sa se <?>tie cu exactitate cate caractere au consumat
       aceste func<?>ii din fluxul de intrare, deoarece ele raporteaza doar
       numarul de conversii reu<?>ite. De exemplu, daca intrarea este
       "123\n a", scanf("%d %d", &a, &b) va consuma cifrele, linia noua <?>i
       spa<?>iul, dar nu <?>i litera a. Acest lucru face dificila recuperarea
       in cazul unei intrari nevalide.

CONSULTA<?>I <?>I
       fgets(3), getline(3), sscanf(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.18
                              21 septembrie 2025                      scanf(3)