qsort(3)

NUME
qsort, qsort_r - sortează o matrice

BIBLIOTECA
Biblioteca C standard (libc, -lc)

SINOPSIS
#include <stdlib.h>

void qsort(void base[.size * .n], size_t n, size_t size,
           typeof(int (const void [.size], const void [.size]))
               *compar);
void qsort_r(void base[.size * .n], size_t n, size_t size,
           typeof(int (const void [.size], const void [.size], void *))
               *compar,
           void *arg);

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

qsort_r():
    _GNU_SOURCE

DESCRIERE
Funcția qsort() sortează o matrice cu n elemente de dimensiunea size. Argumentul base indică începutul matricei.

Conținutul matricei este sortat în ordine crescătoare în conformitate cu o funcție de comparație indicată de compar, care este apelată cu două argumente care indică obiectele care sunt comparate.

Funcția de comparare trebuie să returneze un număr întreg mai mic, egal sau mai mare decât zero dacă primul argument este considerat a fi mai mic, egal sau mai mare decât al doilea. În cazul în care doi membri se compară ca fiind egali, ordinea lor în matricea sortată este nedefinită.

Funcția qsort_r() este identică cu qsort(), cu excepția faptului că funcția de comparație compar primește un al treilea argument. Un indicator este transmis funcției de comparare prin arg. În acest fel, funcția de comparare nu trebuie să utilizeze variabile globale pentru a trece prin argumente arbitrare și, prin urmare, este reentrantă și poate fi utilizată în siguranță în fire de execuție.

VALOAREA RETURNATĂ
Funcțiile qsort() și qsort_r() nu returnează nicio valoare.

ATRIBUTE
Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).
Interfață | Atribut | Valoare
qsort(), qsort_r() | Siguranța firelor | MT-Safe

STANDARDE

qsort()
    C11, POSIX.1-2008.

ISTORIC

qsort()
    POSIX.1-2001, C89, SVr4, 4.3BSD.

qsort_r()
    glibc 2.8.

NOTE
Pentru a compara șiruri de caractere C, funcția de comparare poate apela strcmp(3), după cum se arată în exemplul de mai jos.

EXEMPLE
Pentru un exemplu de utilizare, a se vedea exemplul de la bsearch(3).

Un alt exemplu este următorul program, care sortează șirurile de caractere date în argumentele din linia de comandă:

    #include <stdio.h>
    #include <stdlib.h>
    #include <string.h>

    static int
    cmpstringp(const void *p1, const void *p2)
    {
        /* Argumentele reale ale acestei funcții sunt " indicatori la
           indicatorii către char", dar argumentele strcmp(3) sunt "indicatori".
           către char", de aceea următoarele sunt convertite și dereferențiate. */

        return strcmp(*(const char **) p1, *(const char **) p2);
    }

    int
    main(int argc, char *argv[])
    {
        if (argc < 2) {
            fprintf(stderr, "Utilizare: %s <șir>...\n", argv[0]);
            exit(EXIT_FAILURE);
        }

        qsort(&argv[1], argc - 1, sizeof(char *), cmpstringp);

        for (size_t j = 1; j < argc; j++)
            puts(argv[j]);
        exit(EXIT_SUCCESS);
    }

CONSULTAȚI ȘI
sort(1), alphasort(3), strcmp(3), versionsort(3)

TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.