real-part(3scm)

πŸ“¦ version 0-unstable-2024-02, in nixpkgs unstable

πŸ’– real-part(3scm) β€” real & imaginary parts, from the Scheme Programmer's Manual ✨

πŸŽ€ NAME πŸŽ€

real-part, imag-part β€” real and imaginary parts of a complex number. yes bestie, that's literally the whole name section.

πŸ“š LIBRARY πŸ“š

Okay so these are the import lines, depending on which Scheme flavor you're living in:

(import (rnrs))                     ;R6RS
(import (rnrs base))                ;R6RS
(import (scheme r5rs))              ;R7RS
(import (scheme complex))           ;R7RS, optional library

Pick your fighter, but keep the imports exact. πŸ’…

✨ SYNOPSIS ✨

(real-part z)
(imag-part z)

Two calls, that's it. No cap. πŸ¦‹

πŸ¦‹ DESCRIPTION πŸ¦‹

If z is the complex number a+bi, then the real-part procedure returns a and imag-part returns b. literally the real one and the imaginary one, bestie.

🧚 IMPLEMENTATION NOTES 🧚

See the notes in make-rectangular(3scm). that's the whole note β€” go read that page for the tea.

πŸŽ€ RETURN VALUES πŸŽ€

These procedures return a single value, a real number. one value. real number. slay.

🌈 EXAMPLES 🌈

Okay bestie, examples time:

(real-part 1.1+2.2i)  =>  1.1   ;approximately

(imag-part 1.1+2.2i)  =>  2.2   ;approximately

(real-part -2+3i)  =>  -2  or  -2.0

(imag-part -2+3i)  =>  3  or  3.0

(imag-part 42)  =>  0  or  0.0

🫢 COMPATIBILITY 🫢

All R6RS implementations support complex numbers. Implementations of the other RnRS reports may or may not support complex numbers. In such cases these procedures will be missing. so if you can't find them, it's not you, it's the implementation πŸ’€

πŸ’€ 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.
  • 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.

β€œcatastrophically” is doing a lot of work there, bestie.

πŸ‘‘ SEE ALSO πŸ‘‘

iykyk 🫢

⭐ STANDARDS ⭐

R4RS, IEEE Scheme, R5RS, R6RS, R7RS. standards queen behavior.

🌸 HISTORY 🌸

These procedures first appeared in R2RS, which got them from Common Lisp, where they are called realpart and imagpart. history? more like herstory, but make it Lisp.

πŸ’œ AUTHORS πŸ’œ

This page is part of the scheme-manpages project. It includes materials from the RnRS documents. More information can be found at https://github.com/schemedoc/manpages/. periodt.


xoxo, your Scheme bestie πŸ’– β€” this one's from the Scheme Programmer's Manual, dated 2022-04-07, page real-part(3scm). πŸŽ€

πŸ“¦ where this page comes from