Tue, 28 Mar 2023 21:00:33 +0200
allow NULL for allocator and comparator
universe@483 | 1 | /* |
universe@483 | 2 | * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. |
universe@483 | 3 | * |
universe@483 | 4 | * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved. |
universe@483 | 5 | * |
universe@483 | 6 | * Redistribution and use in source and binary forms, with or without |
universe@483 | 7 | * modification, are permitted provided that the following conditions are met: |
universe@483 | 8 | * |
universe@483 | 9 | * 1. Redistributions of source code must retain the above copyright |
universe@483 | 10 | * notice, this list of conditions and the following disclaimer. |
universe@483 | 11 | * |
universe@483 | 12 | * 2. Redistributions in binary form must reproduce the above copyright |
universe@483 | 13 | * notice, this list of conditions and the following disclaimer in the |
universe@483 | 14 | * documentation and/or other materials provided with the distribution. |
universe@483 | 15 | * |
universe@483 | 16 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
universe@483 | 17 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
universe@483 | 18 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
universe@483 | 19 | * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE |
universe@483 | 20 | * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
universe@483 | 21 | * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
universe@483 | 22 | * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
universe@483 | 23 | * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
universe@483 | 24 | * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
universe@483 | 25 | * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
universe@483 | 26 | * POSSIBILITY OF SUCH DAMAGE. |
universe@483 | 27 | */ |
universe@483 | 28 | |
universe@483 | 29 | /** |
universe@483 | 30 | * \file common.h |
universe@483 | 31 | * |
universe@483 | 32 | * \brief Common definitions and feature checks. |
universe@483 | 33 | * |
universe@483 | 34 | * \author Mike Becker |
universe@483 | 35 | * \author Olaf Wintermann |
universe@483 | 36 | * \version 3.0 |
universe@483 | 37 | * \copyright 2-Clause BSD License |
universe@485 | 38 | * |
universe@485 | 39 | * \mainpage UAP Common Extensions |
universe@485 | 40 | * Library with common and useful functions, macros and data structures. |
universe@485 | 41 | * <p> |
universe@485 | 42 | * Latest available source:<br> |
universe@485 | 43 | * <a href="https://sourceforge.net/projects/ucx/files/">https://sourceforge.net/projects/ucx/files/</a> |
universe@485 | 44 | * </p> |
universe@485 | 45 | * |
universe@485 | 46 | * <p> |
universe@485 | 47 | * Repositories:<br> |
universe@485 | 48 | * <a href="https://sourceforge.net/p/ucx/code">https://sourceforge.net/p/ucx/code</a> |
universe@485 | 49 | * - or - |
universe@485 | 50 | * <a href="https://develop.uap-core.de/hg/ucx">https://develop.uap-core.de/hg/ucx</a> |
universe@485 | 51 | * </p> |
universe@485 | 52 | * |
universe@485 | 53 | * <h2>LICENCE</h2> |
universe@485 | 54 | * |
universe@485 | 55 | * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved. |
universe@485 | 56 | * |
universe@485 | 57 | * Redistribution and use in source and binary forms, with or without |
universe@485 | 58 | * modification, are permitted provided that the following conditions are met: |
universe@485 | 59 | * |
universe@485 | 60 | * 1. Redistributions of source code must retain the above copyright |
universe@485 | 61 | * notice, this list of conditions and the following disclaimer. |
universe@485 | 62 | * |
universe@485 | 63 | * 2. Redistributions in binary form must reproduce the above copyright |
universe@485 | 64 | * notice, this list of conditions and the following disclaimer in the |
universe@485 | 65 | * documentation and/or other materials provided with the distribution. |
universe@485 | 66 | * |
universe@485 | 67 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
universe@485 | 68 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
universe@485 | 69 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
universe@485 | 70 | * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE |
universe@485 | 71 | * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
universe@485 | 72 | * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
universe@485 | 73 | * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
universe@485 | 74 | * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
universe@485 | 75 | * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
universe@485 | 76 | * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
universe@485 | 77 | * POSSIBILITY OF SUCH DAMAGE. |
universe@483 | 78 | */ |
universe@483 | 79 | |
universe@483 | 80 | #ifndef UCX_COMMON_H |
universe@483 | 81 | #define UCX_COMMON_H |
universe@483 | 82 | |
universe@483 | 83 | /** Major UCX version as integer constant. */ |
universe@483 | 84 | #define UCX_VERSION_MAJOR 3 |
universe@483 | 85 | |
universe@483 | 86 | /** Minor UCX version as integer constant. */ |
universe@483 | 87 | #define UCX_VERSION_MINOR 0 |
universe@483 | 88 | |
universe@483 | 89 | /** Version constant which ensures to increase monotonically. */ |
universe@483 | 90 | #define UCX_VERSION (((UCX_VERSION_MAJOR)<<16)|UCX_VERSION_MINOR) |
universe@483 | 91 | |
universe@484 | 92 | #include <stdlib.h> |
universe@484 | 93 | #include <stddef.h> |
universe@487 | 94 | #include <stdbool.h> |
universe@650 | 95 | #include <stdint.h> |
universe@483 | 96 | |
universe@545 | 97 | /** |
universe@545 | 98 | * Function pointer compatible with fwrite-like functions. |
universe@545 | 99 | */ |
universe@545 | 100 | typedef size_t (*cx_write_func)( |
universe@545 | 101 | void const *, |
universe@545 | 102 | size_t, |
universe@545 | 103 | size_t, |
universe@545 | 104 | void * |
universe@545 | 105 | ); |
universe@545 | 106 | |
universe@483 | 107 | #ifdef _WIN32 |
universe@651 | 108 | |
universe@650 | 109 | #ifdef __MINGW32__ |
universe@650 | 110 | #include <sys/types.h> |
universe@650 | 111 | #endif // __MINGW32__ |
universe@651 | 112 | |
universe@628 | 113 | #else // !_WIN32 |
universe@493 | 114 | |
universe@483 | 115 | #include <sys/types.h> |
universe@493 | 116 | |
universe@628 | 117 | #endif // _WIN32 |
universe@483 | 118 | |
universe@493 | 119 | #ifndef __GNUC__ |
universe@503 | 120 | /** |
universe@503 | 121 | * Removes GNU C attributes where they are not supported. |
universe@503 | 122 | */ |
universe@493 | 123 | #define __attribute__(x) |
universe@493 | 124 | #endif |
universe@493 | 125 | |
universe@628 | 126 | #endif // UCX_COMMON_H |