roundup

Section: C Library Functions (3)
Updated: 2023-01-19
Index Return to Main Contents
 

NAME

roundup - round up in steps  

LIBRARY

Standard C library (libc)  

SYNOPSIS

#include <sys/param.h>

roundup(x, step);
 

DESCRIPTION

This macro rounds x to the nearest multiple of step that is not less than x.

It is typically used for rounding up a pointer to align it or increasing a buffer to be allocated.

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.  

RETURN VALUE

This macro returns the rounded value.  

STANDARDS

This nonstandard macro is present in glibc and some BSDs.  

CAVEATS

The arguments may be evaluated more than once.

x should be nonnegative, and step should be positive.

If x + step would overflow or wrap around, the behavior is undefined.  

SEE ALSO

ceil(3), floor(3), lrint(3), rint(3), lround(3), round(3)


 

Index

NAME
LIBRARY
SYNOPSIS
DESCRIPTION
RETURN VALUE
STANDARDS
CAVEATS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 17:10:24 GMT, May 18, 2024