| numerator(3scm) | Scheme Programmer's Manual | numerator(3scm) |
NAME
numerator, denominator, flnumerator, fldenominator - compute numerator and denominator
LIBRARY
(import (rnrs)) ;R6RS (import (rnrs base)) ;R6RS (import (scheme r5rs)) ;R7RS (import (scheme base)) ;R7RS (import (rnrs arithmetic flonums)) ;R6RS
SYNOPSIS
(denominator q) (numerator q) (fldenominator fl) (flnumerator fl)
DESCRIPTION
These procedures return the numerator or denominator of their argument.
The result is computed as if the argument was represented as a fraction in lowest terms. The denominator is always positive. The denominator of 0 is defined to be 1.
RETURN VALUES
Returns a single value; an integer with the same exactness as the argument.
EXAMPLES
(numerator (/ 6 4)) => 3 (denominator (/ 6 4)) => 2 (denominator (inexact (/ 6 4))) => 2.0 (numerator 5) => 5 (denominator 5) => 1
RATIONALE
These procedures, or their equivalents, are used internally in many arithmetic procedures. Since they must exist somewhere in the implementation it makes sense to provide them to the user.
COMPATIBILITY
These procedures work the same everywhere, except that R7RS implementations are allowed to not support all types of numbers.
ERRORS
This procedure can raise exceptions with the following condition types:
- &assertion (R6RS)
- The wrong number of arguments was passed or an argument was outside its domain. In particular, q must be a rational number and fl must be a flonum object.
- R7RS
- The assertions described above are errors. Implementations may signal an error, extend the procedure's domain of definition to include such arguments, or fail catastrophically.
SEE ALSO
rationalize(3scm), real-part(3scm), gcd(3scm), div-and-mod(3scm)
STANDARDS
R4RS, IEEE Scheme, R5RS, R6RS, R7RS
HISTORY
These procedures first appeared in R3RS. The flonum variants are new to R6RS's flonum library.
AUTHORS
This page is part of the scheme-manpages project. It includes materials from the RnRS documents. More information can be found at https://weinholt.se/scheme/manpages/.
| 2023-02-09 |