src/cx/compare.h

Sat, 19 Oct 2024 13:45:49 +0200

author
Mike Becker <universe@uap-core.de>
date
Sat, 19 Oct 2024 13:45:49 +0200
changeset 933
40bf2f212d2a
parent 890
54565fd74e74
permissions
-rw-r--r--

add extern "C" to iterator.h

601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
1 /*
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
2 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
3 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
4 * Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
5 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
6 * Redistribution and use in source and binary forms, with or without
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
7 * modification, are permitted provided that the following conditions are met:
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
8 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
9 * 1. Redistributions of source code must retain the above copyright
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
10 * notice, this list of conditions and the following disclaimer.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
11 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
12 * 2. Redistributions in binary form must reproduce the above copyright
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
13 * notice, this list of conditions and the following disclaimer in the
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
14 * documentation and/or other materials provided with the distribution.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
15 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
17 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
20 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
21 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
22 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
23 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
24 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
25 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
26 * POSSIBILITY OF SUCH DAMAGE.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
27 */
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
28 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
29 * \file compare.h
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
30 * \brief A collection of simple compare functions.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
31 * \author Mike Becker
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
32 * \author Olaf Wintermann
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
33 * \copyright 2-Clause BSD License
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
34 */
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
35
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
36 #ifndef UCX_COMPARE_H
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
37 #define UCX_COMPARE_H
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
38
650
77021e06b1a8 fix code not compiling under windows+mingw
Mike Becker <universe@uap-core.de>
parents: 631
diff changeset
39 #include "common.h"
77021e06b1a8 fix code not compiling under windows+mingw
Mike Becker <universe@uap-core.de>
parents: 631
diff changeset
40
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
41 #ifdef __cplusplus
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
42 extern "C" {
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
43 #endif
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
44
786
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
45 #ifndef CX_COMPARE_FUNC_DEFINED
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
46 #define CX_COMPARE_FUNC_DEFINED
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
47 /**
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
48 * A comparator function comparing two collection elements.
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
49 */
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
50 typedef int(*cx_compare_func)(
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
51 const void *left,
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
52 const void *right
786
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
53 );
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
54 #endif // CX_COMPARE_FUNC_DEFINED
b0ebb3d88407 declare cx_compare_func in compare.h - fixes #344
Mike Becker <universe@uap-core.de>
parents: 762
diff changeset
55
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
56 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
57 * Compares two integers of type int.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
58 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
59 * @param i1 pointer to integer one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
60 * @param i2 pointer to integer two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
61 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
62 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
63 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
64 int cx_cmp_int(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
65
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
66 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
67 * Compares two integers of type long int.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
68 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
69 * @param i1 pointer to long integer one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
70 * @param i2 pointer to long integer two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
71 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
72 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
73 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
74 int cx_cmp_longint(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
75
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
76 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
77 * Compares two integers of type long long.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
78 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
79 * @param i1 pointer to long long one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
80 * @param i2 pointer to long long two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
81 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
82 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
83 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
84 int cx_cmp_longlong(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
85
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
86 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
87 * Compares two integers of type int16_t.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
88 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
89 * @param i1 pointer to int16_t one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
90 * @param i2 pointer to int16_t two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
91 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
92 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
93 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
94 int cx_cmp_int16(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
95
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
96 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
97 * Compares two integers of type int32_t.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
98 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
99 * @param i1 pointer to int32_t one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
100 * @param i2 pointer to int32_t two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
101 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
102 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
103 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
104 int cx_cmp_int32(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
105
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
106 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
107 * Compares two integers of type int64_t.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
108 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
109 * @param i1 pointer to int64_t one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
110 * @param i2 pointer to int64_t two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
111 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
112 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
113 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
114 int cx_cmp_int64(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
115
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
116 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
117 * Compares two integers of type unsigned int.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
118 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
119 * @param i1 pointer to unsigned integer one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
120 * @param i2 pointer to unsigned integer two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
121 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
122 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
123 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
124 int cx_cmp_uint(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
125
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
126 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
127 * Compares two integers of type unsigned long int.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
128 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
129 * @param i1 pointer to unsigned long integer one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
130 * @param i2 pointer to unsigned long integer two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
131 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
132 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
133 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
134 int cx_cmp_ulongint(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
135
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
136 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
137 * Compares two integers of type unsigned long long.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
138 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
139 * @param i1 pointer to unsigned long long one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
140 * @param i2 pointer to unsigned long long two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
141 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
142 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
143 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
144 int cx_cmp_ulonglong(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
145
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
146 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
147 * Compares two integers of type uint16_t.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
148 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
149 * @param i1 pointer to uint16_t one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
150 * @param i2 pointer to uint16_t two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
151 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
152 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
153 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
154 int cx_cmp_uint16(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
155
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
156 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
157 * Compares two integers of type uint32_t.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
158 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
159 * @param i1 pointer to uint32_t one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
160 * @param i2 pointer to uint32_t two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
161 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
162 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
163 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
164 int cx_cmp_uint32(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
165
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
166 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
167 * Compares two integers of type uint64_t.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
168 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
169 * @param i1 pointer to uint64_t one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
170 * @param i2 pointer to uint64_t two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
171 * @return -1, if *i1 is less than *i2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
172 * 1 if *i1 is greater than *i2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
173 */
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
174 int cx_cmp_uint64(const void *i1, const void *i2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
175
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
176 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
177 * Compares two real numbers of type float with precision 1e-6f.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
178 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
179 * @param f1 pointer to float one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
180 * @param f2 pointer to float two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
181 * @return -1, if *f1 is less than *f2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
182 * 1 if *f1 is greater than *f2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
183 */
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
184
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
185 int cx_cmp_float(const void *f1, const void *f2);
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
186
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
187 /**
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
188 * Compares two real numbers of type double with precision 1e-14.
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
189 *
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
190 * @param d1 pointer to double one
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
191 * @param d2 pointer to double two
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
192 * @return -1, if *d1 is less than *d2, 0 if both are equal,
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
193 * 1 if *d1 is greater than *d2
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
194 */
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
195 int cx_cmp_double(
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
196 const void *d1,
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
197 const void *d2
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
198 );
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
199
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
200 /**
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
201 * Compares the integer representation of two pointers.
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
202 *
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
203 * @param ptr1 pointer to pointer one (const intptr_t*)
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
204 * @param ptr2 pointer to pointer two (const intptr_t*)
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
205 * @return -1 if *ptr1 is less than *ptr2, 0 if both are equal,
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
206 * 1 if *ptr1 is greater than *ptr2
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
207 */
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
208 int cx_cmp_intptr(
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
209 const void *ptr1,
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
210 const void *ptr2
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
211 );
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
212
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
213 /**
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
214 * Compares the unsigned integer representation of two pointers.
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
215 *
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
216 * @param ptr1 pointer to pointer one (const uintptr_t*)
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
217 * @param ptr2 pointer to pointer two (const uintptr_t*)
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
218 * @return -1 if *ptr1 is less than *ptr2, 0 if both are equal,
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
219 * 1 if *ptr1 is greater than *ptr2
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
220 */
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
221 int cx_cmp_uintptr(
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
222 const void *ptr1,
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
223 const void *ptr2
631
406376e64fd8 tests for compare functions
Mike Becker <universe@uap-core.de>
parents: 605
diff changeset
224 );
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
225
762
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
226 /**
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
227 * Compares the pointers specified in the arguments without de-referencing.
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
228 *
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
229 * @param ptr1 pointer one
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
230 * @param ptr2 pointer two
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
231 * @return -1 if ptr1 is less than ptr2, 0 if both are equal,
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
232 * 1 if ptr1 is greater than ptr2
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
233 */
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
234 int cx_cmp_ptr(
890
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
235 const void *ptr1,
54565fd74e74 move all const keywords to the west - fixes #426
Mike Becker <universe@uap-core.de>
parents: 786
diff changeset
236 const void *ptr2
762
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
237 );
4523f6d42512 add cx_cmp_ptr() - fix #340
Mike Becker <universe@uap-core.de>
parents: 759
diff changeset
238
601
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
239 #ifdef __cplusplus
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
240 } // extern "C"
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
241 #endif
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
242
95ba6014041b add compare functions
Mike Becker <universe@uap-core.de>
parents:
diff changeset
243 #endif //UCX_COMPARE_H

mercurial