basename(3)                Library Functions Manual                basename(3)

NUME
       basename, dirname - analizeaza componentele numelui rutei

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <libgen.h>

       char *dirname(char *ruta);
       char *basename(char *ruta);

DESCRIERE
       Aten<?>ie: exista doua func<?>ii diferite basename(); a se vedea mai
       jos.

       Func<?>iile dirname() <?>i basename() descompun un <?>ir de nume de
       ruta cu termina<?>ie nula in componentele director <?>i nume de
       fi<?>ier. In cazul obi<?>nuit, dirname() returneaza <?>irul pana la
       ,,/" final, dar fara a-l include, iar basename() returneaza componenta
       care urmeaza dupa ,,/" final. Caracterele ,,/" de la sfar<?>it nu sunt
       considerate ca facand parte din numele de ruta.

       Daca ruta nu con<?>ine o bara oblica, dirname() returneaza <?>irul
       ,,.", in timp ce basename() returneaza o copie a rutei. Daca ruta este
       <?>irul ,,/", atunci atat dirname(), cat <?>i basename() returneaza
       <?>irul ,,/". Daca ruta este un indicator nul sau indica un <?>ir gol,
       atunci atat dirname(), cat <?>i basename() returneaza <?>irul ,,.".

       Concatenand <?>irul returnat de dirname(), un ,,/" <?>i <?>irul
       returnat de basename() se ob<?>ine un nume de ruta complet.

       Atat dirname(), cat <?>i basename() pot modifica con<?>inutul rutei,
       astfel incat poate fi de dorit sa se transfere o copie atunci cand se
       apeleaza una dintre aceste func<?>ii.

       Aceste func<?>ii pot returna indicatori catre memoria alocata static,
       care poate fi suprascrisa de apelurile ulterioare. Alternativ, ele pot
       returna un indicator catre o parte din ruta, astfel incat <?>irul la
       care face referire ruta sa nu fie modificat sau eliberat pana cand
       indicatorul returnat de func<?>ie nu mai este necesar.

       Urmatoarea lista de exemple (preluata din SUSv2) prezinta <?>irurile de
       caractere returnate de dirname() <?>i basename() pentru diferite rute:

              ruta       dirname   basename
              /usr/lib   /usr      lib
              /usr/      /         usr
              usr        .         usr
              /          /         /
              .          .         .
              ..         .         ..

VALOAREA RETURNATA
       Atat dirname(), cat <?>i basename() returneaza indicatori catre
       <?>iruri de caractere cu termina<?>ie nula; (nu pasa<?>i ace<?>ti
       indicatori la free(3)).

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

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |basename(), dirname()                 | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
VERSIUNI
       Exista doua versiuni diferite ale basename() - versiunea POSIX descrisa
       mai sus <?>i versiunea GNU, care se ob<?>ine dupa definirea acesteia:

               #define _GNU_SOURCE         /* Consulta<?>i feature_test_macros(7) */
           #include <string.h>

       Versiunea GNU nu-<?>i modifica niciodata argumentul <?>i returneaza
       <?>irul gol atunci cand ruta are o bara oblica la sfar<?>it <?>i, in
       special, atunci cand este ,,/". Nu exista o versiune GNU a dirname().

       Cu glibc, se ob<?>ine versiunea POSIX a basename() atunci cand
       <libgen.h> este inclus, iar in caz contrar, versiunea GNU.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001.

ERORI
       In implementarea glibc, versiunile POSIX ale acestor func<?>ii modifica
       argumentul ruta <?>i genereaza o eroare de segmentare atunci cand sunt
       apelate cu un <?>ir static, cum ar fi ,,/usr/".

       Inainte de glibc 2.2.1, versiunea glibc a dirname() nu gestiona corect
       numele de ruta cu caractere ,,/" la sfar<?>it <?>i genera o eroare de
       segmentare daca primea un argument NULL.

EXEMPLE
       Urmatorul fragment de cod demonstreaza utilizarea basename() <?>i
       dirname():
           char *dirc, *basec, *bname, *dname;
           char *path = "/etc/passwd";

           dirc = strdup(path);
           basec = strdup(path);
           dname = dirname(dirc);
           bname = basename(basec);
           printf("dirname=%s, basename=%s\n", dname, bname);

CONSULTA<?>I <?>I
       basename(1), dirname(1)

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.06 31 octombrie 2023                   basename(3)