NAME¶

SDL_qsort - Sort an array.

HEADER FILE¶

Defined in SDL3/SDL_stdinc.h

SYNOPSIS¶

#include "SDL3/SDL.h"

void SDL_qsort(void *base, size_t nmemb, size_t size, SDL_CompareCallback compare);

DESCRIPTION¶

For example:

typedef struct {


    int key;


    const char *string;
} data;
int SDLCALL compare(const void *a, const void *b)
{


    const data *A = (const data *)a;


    const data *B = (const data *)b;


    if (A->n < B->n) {


        return -1;


    } else if (B->n < A->n) {


        return 1;


    } else {


        return 0;


    }
}
data values[] = {


    { 3, "third" }, { 1, "first" }, { 2, "second" }
};
SDL_qsort(values, SDL_arraysize(values), sizeof(values[0]), compare);
    

FUNCTION PARAMETERS¶

base

a pointer to the start of the array.

nmemb

the number of elements in the array.

size

the size of the elements in the array.

compare

a function used to compare elements in the array.

THREAD SAFETY¶

It is safe to call this function from any thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

•(3), SDL_bsearch(3), •(3), SDL_qsort_r(3)