Function SDL_qsort_r
pub unsafe extern "C" fn SDL_qsort_r(
base: *mut c_void,
nmemb: usize,
size: usize,
compare: Option<unsafe extern "C" fn(_: *mut c_void, _: *const c_void, _: *const c_void) -> i32>,
userdata: *mut c_void,
)
Available on crate feature
dep_sdl3
only.Expand description
Sort an array, passing a userdata pointer to the compare function.
For example:
typedef enum {
sort_increasing,
sort_decreasing,
} sort_method;
typedef struct {
int key;
const char *string;
} data;
int SDLCALL compare(const void *userdata, const void *a, const void *b)
{
sort_method method = (sort_method)(uintptr_t)userdata;
const data *A = (const data *)a;
const data *B = (const data *)b;
if (A->key < B->key) {
return (method == sort_increasing) ? -1 : 1;
} else if (B->key < A->key) {
return (method == sort_increasing) ? 1 : -1;
} else {
return 0;
}
}
data values[] = {
{ 3, "third" }, { 1, "first" }, { 2, "second" }
};
SDL_qsort_r(values, SDL_arraysize(values), sizeof(values[0]), compare, (const void *)(uintptr_t)sort_increasing);
§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.userdata
: a pointer to pass to the compare function.
§Thread safety
It is safe to call this function from any thread.
§Availability
This function is available since SDL 3.2.0.