summaryrefslogtreecommitdiffstats
path: root/man3/roundup.3
blob: d21949e1488ff02736fdf7a20b5c16db9f9636c7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
.\" Copyright (C) 2023 Alejandro Colomar <alx@kernel.org>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.TH roundup 3 2023-03-30 "Linux man-pages 6.05.01"
.SH NAME
roundup \- round up in steps
.SH LIBRARY
Standard C library
.RI ( libc )
.SH SYNOPSIS
.nf
.B #include <sys/param.h>
.PP
.BI roundup( x ", " step );
.fi
.SH DESCRIPTION
This macro rounds
.I x
to the nearest multiple of
.I step
that is not less than
.IR x .
.PP
It is typically used for
rounding up a pointer to align it or
increasing a buffer to be allocated.
.PP
This API is not designed to be generic,
and doesn't work in some cases
that are not important for the typical use cases described above.
See CAVEATS.
.SH RETURN VALUE
This macro returns the rounded value.
.SH STANDARDS
None.
.SH CAVEATS
The arguments may be evaluated more than once.
.PP
.I x
should be nonnegative,
and
.I step
should be positive.
.PP
If
.I x + step
would overflow or wrap around,
the behavior is undefined.
.SH SEE ALSO
.BR ceil (3),
.BR floor (3),
.BR lrint (3),
.BR rint (3),
.BR lround (3),
.BR round (3)