Where are MIN
and MAX
defined in C, if at all?
What is the best way to implement these, as generically and type safely as possible? (Compiler extensions/builtins for mainstream compilers preferred.)
Where are
MIN
andMAX
defined in C, if at all?
They aren't.
What is the best way to implement these, as generically and type safe as possible (compiler extensions/builtins for mainstream compilers preferred).
As functions. I wouldn't use macros like #define MIN(X, Y) (((X) < (Y)) ? (X) : (Y))
, especially if you plan to deploy your code. Either write your own, use something like standard fmax
or fmin
, or fix the macro using GCC's typeof (you get typesafety bonus too) in a GCC statement expression:
#define max(a,b) \
({ __typeof__ (a) _a = (a); \
__typeof__ (b) _b = (b); \
_a > _b ? _a : _b; })
Everyone says "oh I know about double evaluation, it's no problem" and a few months down the road, you'll be debugging the silliest problems for hours on end.
Note the use of __typeof__
instead of typeof
:
If you are writing a header file that must work when included in ISO C programs, write
__typeof__
instead oftypeof
.
warning: expression with side-effects multiply evaluated by macro
at the point of use...
decltype
keyword -- but even so, Visual Studio can't do compound statements in macros (and decltype
is C++ anyway), i.e. GCC's ({ ... })
syntax so I'm pretty sure it's not possible, anyway. I haven't looked at any other compilers regarding this issue, sorry Luther :S
Commented
Aug 10, 2010 at 6:08
MAX(someUpperBound, someRandomFunction())
to limit a random value to some upper bound. It was a terrible idea, but it also didn't even work, because the MAX
he was using had the double evaluation problem, so he ended up with a different random number than the one that was initially evaluated.
Commented
Aug 12, 2014 at 17:15
MIN(x++, y++)
the preprocessor will generate the following code (((x++) < (y++)) ? (x++) : (y++))
. So, x
and y
will be incremented twice.
It's also provided in the GNU libc (Linux) and FreeBSD versions of sys/param.h
, and has the definition provided by dreamlax.
On Debian:
$ uname -sr
Linux 2.6.11
$ cat /etc/debian_version
5.0.2
$ egrep 'MIN\(|MAX\(' /usr/include/sys/param.h
#define MIN(a,b) (((a)<(b))?(a):(b))
#define MAX(a,b) (((a)>(b))?(a):(b))
$ head -n 2 /usr/include/sys/param.h | grep GNU
This file is part of the GNU C Library.
On FreeBSD:
$ uname -sr
FreeBSD 5.5-STABLE
$ egrep 'MIN\(|MAX\(' /usr/include/sys/param.h
#define MIN(a,b) (((a)<(b))?(a):(b))
#define MAX(a,b) (((a)>(b))?(a):(b))
The source repositories are here:
openSUSE/Linux 3.1.0-1.2-desktop
/gcc version 4.6.2 (SUSE Linux)
too. :) Bad it's not portable.
There's a std::min
and std::max
in C++, but AFAIK, there's no equivalent in the C standard library. You can define them yourself with macros like
#define MAX(x, y) (((x) > (y)) ? (x) : (y))
#define MIN(x, y) (((x) < (y)) ? (x) : (y))
But this causes problems if you write something like MAX(++a, ++b)
.
#define MIN(A, B) ((A < B) ? A : B)
is not a flexible way, why???
#define MULT(x, y) x * y
. Then MULT(a + b, a + b)
expands to a + b * a + b
, which parses as a + (b * a) + b
due to precedence. That's not what the programmer probably intended.
@David Titarenco nailed it here, but let me at least clean it up a bit to make it look nice, and show both min()
and max()
together to make copying and pasting from here easier. :)
Update 25 Apr. 2020: I've also added a Section 3 to show how this would be done with C++ templates too, as a valuable comparison for those learning both C and C++, or transitioning from one to the other. I've done my best to be thorough and factual and correct to make this answer a canonical reference I can come back to again and again, and I hope you find it as useful as I do.
This technique is commonly used, well-respected by those who know how to use it properly, the "de facto" way of doing things, and fine to use if used properly, but buggy (think: double-evaluation side effect) if you ever pass expressions including variable assignment in to compare:
#define MAX(a,b) ((a) > (b) ? (a) : (b))
#define MIN(a,b) ((a) < (b) ? (a) : (b))
This technique avoids the above "double-evaluation" side effects and bugs, and is therefore considered the superior, safer, and "more modern" GCC C way to do this. Expect it to work with both the gcc and clang compilers, since clang is, by design, gcc-compatible (see the clang note at the bottom of this answer).
BUT: DO watch out for "variable shadowing" effects still, as statement expressions are apparently inlined and therefore do NOT have their own local variable scope!
#define max(a,b) \
({ \
__typeof__ (a) _a = (a); \
__typeof__ (b) _b = (b); \
_a > _b ? _a : _b; \
})
#define min(a,b) \
({ \
__typeof__ (a) _a = (a); \
__typeof__ (b) _b = (b); \
_a < _b ? _a : _b; \
})
Note that in gcc statement expressions, the last expression in the code block is what is "returned" from the expression, as though it was returned from a function. GCC's documentation says it this way:
The last thing in the compound statement should be an expression followed by a semicolon; the value of this subexpression serves as the value of the entire construct. (If you use some other kind of statement last within the braces, the construct has type void, and thus effectively no value.)
C++ Note: if using C++, templates are probably recommended for this type of construct instead, but I personally dislike templates and would probably use one of the above constructs in C++ anyway, as I frequently use and prefer C styles in embedded C++ as well.
This section added 25 Apr. 2020:
I've been doing a ton of C++ the past few months, and the pressure to prefer templates over macros, where able, in the C++ community is quite strong. As a result, I've been getting better at using templates, and want to put in the C++ template versions here for completeness and to make this a more canonical and thorough answer.
Here's what basic function template versions of max()
and min()
might look like in C++:
template <typename T>
T max(T a, T b)
{
return a > b ? a : b;
}
template <typename T>
T min(T a, T b)
{
return a < b ? a : b;
}
Do additional reading about C++ templates here: Wikipedia: Template (C++).
However, both max()
and min()
are already part of the C++ standard library, in the <algorithm>
header (#include <algorithm>
). In the C++ standard library they are defined slightly differently than I have them above. The default prototypes for std::max<>()
and std::min<>()
, for instance, in C++14, looking at their prototypes in the cplusplus.com links just above, are:
template <class T>
constexpr const T& max(const T& a, const T& b);
template <class T>
constexpr const T& min(const T& a, const T& b);
Note that the keyword typename
is an alias to class
(so their usage is identical whether you say <typename T>
or <class T>
), since it was later acknowledged after the invention of C++ templates, that the template type might be a regular type (int
, float
, etc.) instead of only a class type.
Here you can see that both of the input types, as well as the return type, are const T&
, which means "constant reference to type T
". This means the input parameters and return value are passed by reference instead of passed by value. This is like passing by pointers, and is more efficient for large types, such as class objects. The constexpr
part of the function modifies the function itself and indicates that the function must be capable of being evaluated at compile-time (at least if provided constexpr
input parameters), but if it cannot be evaluated at compile-time, then it defaults back to a run-time evaluation, like any other normal function.
The compile-time aspect of a constexpr
C++ function makes it kind-of C-macro-like, in that if compile-time evaluation is possible for a constexpr
function, it will be done at compile-time, same as a MIN()
or MAX()
macro substitution could possibly be fully evaluated at compile-time in C or C++ too. For additional references for this C++ template info, see below.
std::max()
If using C++, I'd like to add that the built-in std::max()
function in the <algorithm>
header file has a variety of forms. See the "Possible implementation" section on the documentation page at the cppreference.com community wiki (https://en.cppreference.com/w/cpp/algorithm/max) for 4 possible implementations for the 4 forms of std::max()
.
Normal usages include:
std::max(100, 200);
...but if you'd like to compare many numbers at once, you can use the 4th form, which accepts a std::initializer_list<T>
, like this:
Function declaration:
template< class T, class Compare >
constexpr T max( std::initializer_list<T> ilist, Compare comp );
Usage:
// Compare **3 or more numbers** by passing a curly-brace-initialized
// `std::initializer_list<>` to `std::max()`!:
std::max({100, 200, 300}); // result is 300
std::max({100, 200, 300, 400}); // result is 400
std::max({100, 200, 300, 400, 500}); // result is 500
std::max({100, 200, 300, 400, 500, 600}); // result is 600
// etc.
Clang note from Wikipedia:
[Clang] is designed to act as a drop-in replacement for the GNU Compiler Collection (GCC), supporting most of its compilation flags and unofficial language extensions.
std::max()
and std::min()
already do.
std::max()
and std::min()
already do, so you can understand how they work (to learn), 3) to learn C++ from C, since many people start with C and then need to learn C++ too, or vice versa, so having both the C and the C++ answer together is helpful for anyone who writes in both. Myself, for instance: I'm an embedded software engineer. Sometimes I work on C code bases, and I come here to copy and paste verbatim my macro or gcc statement expression answers, and sometimes I work in C++ code bases and read my notes here to remember templates.
Commented
Jul 1, 2020 at 22:02
Avoid non-standard compiler extensions and implement it as a completely type-safe macro in pure standard C (ISO 9899:2011).
Solution
#define GENERIC_MAX(x, y) ((x) > (y) ? (x) : (y))
#define ENSURE_int(i) _Generic((i), int: (i))
#define ENSURE_float(f) _Generic((f), float: (f))
#define MAX(type, x, y) \
(type)GENERIC_MAX(ENSURE_##type(x), ENSURE_##type(y))
Usage
MAX(int, 2, 3)
Explanation
The macro MAX creates another macro based on the type
parameter. This control macro, if implemented for the given type, is used to check that both parameters are of the correct type. If the type
is not supported, there will be a compiler error.
If either x or y is not of the correct type, there will be a compiler error in the ENSURE_
macros. More such macros can be added if more types are supported. I've assumed that only arithmetic types (integers, floats, pointers etc) will be used and not structs or arrays etc.
If all types are correct, the GENERIC_MAX macro will be called. Extra parenthesis are needed around each macro parameter, as the usual standard precaution when writing C macros.
Then there's the usual problems with implicit type promotions in C. The ?:
operator balances the 2nd and 3rd operand against each other. For example, the result of GENERIC_MAX(my_char1, my_char2)
would be an int
. To prevent the macro from doing such potentially dangerous type promotions, a final type cast to the intended type was used.
Rationale
We want both parameters to the macro to be of the same type. If one of them is of a different type, the macro is no longer type safe, because an operator like ?:
will yield implicit type promotions. And because it does, we also always need to cast the final result back to the intended type as explained above.
A macro with just one parameter could have been written in a much simpler way. But with 2 or more parameters, there is a need to include an extra type parameter. Because something like this is unfortunately impossible:
// this won't work
#define MAX(x, y) \
_Generic((x), \
int: GENERIC_MAX(x, ENSURE_int(y)) \
float: GENERIC_MAX(x, ENSURE_float(y)) \
)
The problem is that if the above macro is called as MAX(1, 2)
with two int
, it will still try to macro-expand all possible scenarios of the _Generic
association list. So the ENSURE_float
macro will get expanded too, even though it isn't relevant for int
. And since that macro intentionally only contains the float
type, the code won't compile.
To solve this, I created the macro name during the pre-processor phase instead, with the ## operator, so that no macro gets accidentally expanded.
Examples
#include <stdio.h>
#define GENERIC_MAX(x, y) ((x) > (y) ? (x) : (y))
#define ENSURE_int(i) _Generic((i), int: (i))
#define ENSURE_float(f) _Generic((f), float: (f))
#define MAX(type, x, y) \
(type)GENERIC_MAX(ENSURE_##type(x), ENSURE_##type(y))
int main (void)
{
int ia = 1, ib = 2;
float fa = 3.0f, fb = 4.0f;
double da = 5.0, db = 6.0;
printf("%d\n", MAX(int, ia, ib)); // ok
printf("%f\n", MAX(float, fa, fb)); // ok
//printf("%d\n", MAX(int, ia, fa)); compiler error, one of the types is wrong
//printf("%f\n", MAX(float, fa, ib)); compiler error, one of the types is wrong
//printf("%f\n", MAX(double, fa, fb)); compiler error, the specified type is wrong
//printf("%f\n", MAX(float, da, db)); compiler error, one of the types is wrong
//printf("%d\n", MAX(unsigned int, ia, ib)); // wont get away with this either
//printf("%d\n", MAX(int32_t, ia, ib)); // wont get away with this either
return 0;
}
GENERIC_MAX
macro is a bad idea by the way, you only have to try GENERIC_MAX(var++, 7)
to find out why :-) Nowadays (especially with heavily optimising/inlining compilers), macros should pretty much be relegated to the simple forms only. The function-like ones are better as functions and the value-group ones better as enumerations.
Commented
Sep 27, 2019 at 11:43
++
is mixed with other things in the same expression - well, that horrible coding style is their actual problem. It would however be possible to copy each parameter into a compound literal to avoid the multiple evaluations problem: ENSURE_##type( (type){x} )
MAX(float, fa, fb)
differs from MAX(float, fa, fb)
when one of fa, fb
is NAN.
Commented
May 22, 2023 at 14:29
fmax
etc functions at least since C99.
This is a late answer, due to a fairly recent development. Since the OP accepted the answer that relies on a non-portable GCC (and clang) extension typeof
- or __typeof__
for 'clean' ISO C - there's a better solution available as of gcc-4.9.
#define max(x,y) ( \
{ __auto_type __x = (x); __auto_type __y = (y); \
__x > __y ? __x : __y; })
The obvious benefit of this extension is that each macro argument is only expanded once, unlike the __typeof__
solution.
__auto_type
is a limited form of C++11's auto
. It cannot (or should not?) be used in C++ code, though there's no good reason not to use the superior type inference capabilities of auto
when using C++11.
That said, I assume there are no issues using this syntax when the macro is included in an extern "C" { ... }
scope; e.g., from a C header. AFAIK, this extension has not found its way info clang
clang
started supporting __auto_type
around 2016 (see patch).
c-preprocessor
tag. A function is not guaranteed to be inlined even with said keyword, unless using something like gcc's __always_inline__
attribute.
Commented
Oct 2, 2019 at 5:06
({ ... })
extension. I don't think it's any more portable than the version with typeof
(with or without underscores).
I don't think that they are standardised macros. There are standardised functions for floating point already, fmax
and fmin
(and fmaxf
for floats, and fmaxl
for long doubles).
You can implement them as macros as long as you are aware of the issues of side-effects/double-evaluation.
#define MAX(a,b) ((a) > (b) ? a : b)
#define MIN(a,b) ((a) < (b) ? a : b)
In most cases, you can leave it to the compiler to determine what you're trying to do and optimise it as best it can. While this causes problems when used like MAX(i++, j++)
, I doubt there is ever much need in checking the maximum of incremented values in one go. Increment first, then check.
I wrote this version that works for MSVC, GCC, C, and C++.
#if defined(__cplusplus) && !defined(__GNUC__)
# include <algorithm>
# define MIN std::min
# define MAX std::max
//# define TMIN(T, a, b) std::min<T>(a, b)
//# define TMAX(T, a, b) std::max<T>(a, b)
#else
# define _CHOOSE2(binoper, lexpr, lvar, rexpr, rvar) \
({ \
decltype(lexpr) lvar = (lexpr); \
decltype(rexpr) rvar = (rexpr); \
lvar binoper rvar ? lvar : rvar; \
})
# define _CHOOSE_VAR2(prefix, unique) prefix##unique
# define _CHOOSE_VAR(prefix, unique) _CHOOSE_VAR2(prefix, unique)
# define _CHOOSE(binoper, lexpr, rexpr) \
_CHOOSE2( \
binoper, \
lexpr, _CHOOSE_VAR(_left, __COUNTER__), \
rexpr, _CHOOSE_VAR(_right, __COUNTER__) \
)
# define MIN(a, b) _CHOOSE(<, a, b)
# define MAX(a, b) _CHOOSE(>, a, b)
#endif
If you need min/max in order to avoid an expensive branch, you shouldn't use the ternary operator, as it will compile down to a jump. Bit Twiddling Hacks describes a useful method for implementing a min/max function without branching.
int x; // we want to find the minimum of x and y int y; int r; // the result goes here r = y ^ ((x ^ y) & -(x < y)); // min(x, y)
To find the maximum, use:
r = x ^ ((x ^ y) & -(x < y)); // max(x, y)
Quick and dirty versions:
If you know that
INT_MIN <= x - y <= INT_MAX
, then you can use the following, which are faster because(x - y)
only needs to be evaluated once.r = y + ((x - y) & ((x - y) >> (sizeof(int) * CHAR_BIT - 1))); // min(x, y) r = x - ((x - y) & ((x - y) >> (sizeof(int) * CHAR_BIT - 1))); // max(x, y)
It's worth pointing out I think that if you define min
and max
with the ternary operation such as
#define MIN(a,b) (((a)<(b))?(a):(b))
#define MAX(a,b) (((a)>(b))?(a):(b))
then to get the same result for the special case of fmin(-0.0,0.0)
and fmax(-0.0,0.0)
you need to swap the arguments
fmax(a,b) = MAX(a,b)
fmin(a,b) = MIN(b,a)
fmin(3.0,NaN)==fmin(NaN,3.0)==fmax(3.0,NaN)==fmax(NaN,3.0)==3.0
Looks like Windef.h
(a la #include <windows.h>
) has max
and min
(lower case) macros, that also suffer from the "double evaluation" difficulty, but they're there for those that don't want to re-roll their own :)
<?, >?, <?=, >?=
In a very old version of GCC there were the operators <?, >?
(see here, here it was in C++ but I think it also applied as a C extension back then)
I have also seen the operators <?=, >?=
corresponding to the assignment statements.
The operands were evaluated once and even allowed for a very short assignment statement. Its very short compared to common min/max assignments. There is nothing that can top this.
Those were a shorthand for the following:
min(a, b) === a < b ? a : b === a <? b;
max(a, b) === a > b ? a : b === a >? b;
a = min(a, b); === if(b < a) a = b; === a <?= b;
a = max(a, b); === if(b > a) a = b; === a >?= b;
Finding the minimum is very concise:
int find_min(const int* ints, int num_ints)
{
assert(num_ints > 0);
int min = ints[0];
for(int i = 1; i < num_ints; ++i)
min <?= ints[i];
return min;
}
I hope this might be some day brought back to GCC, because I think these operators are genious.
\/
(max) operators in older C
A simple solution as the other answers suggest would be a macro along the lines of:
#define max(a, b) ((a) > (b) ? (a) : (b))
However this can cause unexpected results and unnecessary (re)computation if a
and b
are complex expressions (with side effects) rather than just variables.
The question did ask for compiler-specific extensions so as the other answers also suggest, a safer option would be to use GCC statement expressions and __typeof__
.
#define max(a, b) ({ __typeof__(a) _a = (a); __typeof__(b) _b = (b); _a > _b ? _a : _b; })
This solution is great if you have GCC. But will not work at all otherwise.
A template function would be even better if you are using C++. But the question is tagged c so a C++ only answer does not apply to all cases here.
I would like to offer a portable solution. Since the C library already has functions ending in l
and ll
for larger integer types, we could define our own min
and max
the same way, to match the functions found in the library, such as abs
/absl
/absll
and div
/divl
/divll
.
static inline int min(const int a, const int b) {
return a < b ? a : b;
}
static inline int max(const int a, const int b) {
return a > b ? a : b;
}
static inline long minl(const long a, const long b) {
return a < b ? a : b;
}
static inline long maxl(const long a, const long b) {
return a > b ? a : b;
}
static inline long long minll(const long long a, const long long b) {
return a < b ? a : b;
}
static inline long long maxll(const long long a, const long long b) {
return a > b ? a : b;
}
This solution is a good substitute for GCC extensions or C++ only features, and is safer than macros. We do not define fmin
and fmax
and their variants for floating point types because those already exist.
I know the guy said "C"... But if you have the chance, use a C++ template:
template<class T> T min(T a, T b) { return a < b ? a : b; }
Type safe, and no problems with the ++ mentioned in other comments.
in gcc, you can use this:
#define max(a,b) \
({ __typeof__ (a) _a = (a); \
__typeof__ (b) _b = (b); \
_a > _b ? _a : _b; })
in msvc, you can use this:
#define SMART_MIN(x, y) \
([&]() -> decltype(x) { \
decltype(x) _min1 = (x); \
decltype(y) _min2 = (y); \
return _min1 < _min2 ? _min1 : _min2; \
})()
in this way, can make sure x, y won't be calculated 2 times
The maximum of two integers a
and b
is (int)(0.5((a+b)+abs(a-b)))
. This may also work with (double)
and fabs(a-b)
for doubles (similar for floats)
The simplest way is to define it as a global function in a .h
file, and call it whenever you want, if your program is modular with lots of files. If not, double MIN(a,b){return (a<b?a:b)}
is the simplest way.
min(x++, y++)
, x and y are incremented once or twice if I use thismin
.