Display the source code in std/math.d from which this page was generated on github.

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Function `std.math.rint`

Rounds x to the nearest integer value, using the current rounding mode.


						
				real rint
				(
				

				  real x
				

				) pure nothrow @nogc @safe;
				

				

				double rint
				(
				

				  double x
				

				) pure nothrow @nogc @safe;
				

				

				float rint
				(
				

				  float x
				

				) pure nothrow @nogc @safe;

If the return value is not equal to x, the FE_INEXACT exception is raised.

nearbyint performs the same operation, but does not set the FE_INEXACT exception.

Example

version (IeeeFlagsSupport) resetIeeeFlags();
writeln(rint(0.4)); // 0
version (IeeeFlagsSupport) assert(ieeeFlags.inexact);

writeln(rint(0.5)); // 0
writeln(rint(0.6)); // 1
writeln(rint(100.0)); // 100

assert(isNaN(rint(real.nan)));
writeln(rint(real.infinity)); // real.infinity
writeln(rint(-real.infinity)); // -real.infinity

Authors

Walter Bright, Don Clugston, Conversion of CEPHES math library to D by Iain Buclaw and David Nadlinger

License

Boost License 1.0.