blender-archive/source/blender/blenlib/BLI_sort.h

/* SPDX-License-Identifier: GPL-2.0-or-later
 * Copyright 2013 Blender Foundation. All rights reserved. */

#pragma once

/** \file
 * \ingroup bli
 */

#include <stdlib.h>

/* glibc 2.8+ */
#if defined(__GLIBC__) && (__GLIBC__ > 2 || (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 8))
#  define BLI_qsort_r qsort_r
#endif

/** Quick sort (re-entrant). */
typedef int (*BLI_sort_cmp_t)(const void *a, const void *b, void *ctx);

void BLI_qsort_r(void *a, size_t n, size_t es, BLI_sort_cmp_t cmp, void *thunk)
#ifdef __GNUC__
    __attribute__((nonnull(1, 5)))
#endif
    ;
File headers: SPDX License migration Use a shorter/simpler license convention, stops the header taking so much space. Follow the SPDX license specification: https://spdx.org/licenses - C/C++/objc/objc++ - Python - Shell Scripts - CMake, GNUmakefile While most of the source tree has been included - `./extern/` was left out. - `./intern/cycles` & `./intern/atomic` are also excluded because they use different header conventions. doc/license/SPDX-license-identifiers.txt has been added to list SPDX all used identifiers. See P2788 for the script that automated these edits. Reviewed By: brecht, mont29, sergey Ref D14069 2022-02-11 09:07:11 +11:00			`/* SPDX-License-Identifier: GPL-2.0-or-later`
			`* Copyright 2013 Blender Foundation. All rights reserved. */`
Use reentrant qsort() in particle codes Particle system code used global variable to sort hair by orig index, which is not safe for threading at all. Replaced this with usage of reentrant version of qsort, which is now implemented in BLI. It was moved from recast navigation code to BLI, so more areas could use it (if needed). -- svn merge -r59086:59087 ^/branches/soc-2013-depsgraph_mt 2013-08-19 10:40:47 +00:00
			`#pragma once`

doxygen: add newline after \file While \file doesn't need an argument, it can't have another doxy command after it. 2019-02-18 08:08:12 +11:00			`/** \file`
			`* \ingroup bli`
Use reentrant qsort() in particle codes Particle system code used global variable to sort hair by orig index, which is not safe for threading at all. Replaced this with usage of reentrant version of qsort, which is now implemented in BLI. It was moved from recast navigation code to BLI, so more areas could use it (if needed). -- svn merge -r59086:59087 ^/branches/soc-2013-depsgraph_mt 2013-08-19 10:40:47 +00:00			`*/`

Use gnu-libc arg order for BLI_sort_r When building on gnu-libc don't use our own implementation. 2014-06-25 04:01:38 +10:00			`#include <stdlib.h>`

Fix T42226: Glibc <= 2.8 fails to build 2014-10-15 09:23:43 +02:00			`/* glibc 2.8+ */`
			`#if defined(__GLIBC__) && (__GLIBC__ > 2 \|\| (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 8))`
Use gnu-libc arg order for BLI_sort_r When building on gnu-libc don't use our own implementation. 2014-06-25 04:01:38 +10:00			`# define BLI_qsort_r qsort_r`
			`#endif`

Docs: use doxygen formatting for BLI Differentiate doc-strings from title/section text. 2021-12-20 19:01:14 +11:00			`/** Quick sort (re-entrant). */`
Use gnu-libc arg order for BLI_sort_r When building on gnu-libc don't use our own implementation. 2014-06-25 04:01:38 +10:00			`typedef int (BLI_sort_cmp_t)(const void a, const void b, void ctx);`
Use reentrant qsort() in particle codes Particle system code used global variable to sort hair by orig index, which is not safe for threading at all. Replaced this with usage of reentrant version of qsort, which is now implemented in BLI. It was moved from recast navigation code to BLI, so more areas could use it (if needed). -- svn merge -r59086:59087 ^/branches/soc-2013-depsgraph_mt 2013-08-19 10:40:47 +00:00
Correction to last commit 2014-06-25 04:22:14 +10:00			`void BLI_qsort_r(void a, size_t n, size_t es, BLI_sort_cmp_t cmp, void thunk)`
set nonnull args for BLI_qsort_r 2013-08-21 20:45:51 +00:00			`#ifdef __GNUC__`
			`__attribute__((nonnull(1, 5)))`
			`#endif`
			`;`