diff options
author | Neil Jerram <neil@ossau.uklinux.net> | 2002-03-16 00:27:25 +0000 |
---|---|---|
committer | Neil Jerram <neil@ossau.uklinux.net> | 2002-03-16 00:27:25 +0000 |
commit | 387d418c555b23f4637bbc7e6ff0566435aae30d (patch) | |
tree | 1e34a3bc89e5d06a71149197ea4453c00b04b96a /doc/ref/scheme-data.texi | |
parent | b193d130d8cb56e459e07515c7fec0373d4d26e9 (diff) | |
download | guile-387d418c555b23f4637bbc7e6ff0566435aae30d.tar.gz |
* Manual updates on hooks and features.
* Fix scm_t_c_hookype_t corruption.
Diffstat (limited to 'doc/ref/scheme-data.texi')
-rwxr-xr-x | doc/ref/scheme-data.texi | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/doc/ref/scheme-data.texi b/doc/ref/scheme-data.texi index c9f54b246..1c46a7004 100755 --- a/doc/ref/scheme-data.texi +++ b/doc/ref/scheme-data.texi @@ -714,7 +714,11 @@ called with one argument @var{z1}, 1/@var{z1} is returned. @c begin (texi-doc-string "guile" "abs") @deffn {Scheme Procedure} abs x +@deffnx {C Function} scm_abs (x) Return the absolute value of @var{x}. + +@var{x} must be a number with zero imaginary part. To calculate the +magnitude of a complex number, use @code{magnitude} instead. @end deffn @c begin (texi-doc-string "guile" "max") @@ -747,6 +751,18 @@ Round the number @var{x} towards minus infinity. Round the number @var{x} towards infinity. @end deffn +For the @code{truncate} and @code{round} procedures, the Guile library +exports equivalent C functions, but taking and returning arguments of +type @code{double} rather than the usual @code{SCM}. + +@deftypefn {C Function} double scm_truncate (double x) +@deftypefnx {C Function} double scm_round (double x) +@end deftypefn + +For @code{floor} and @code{ceiling}, the equivalent C functions are +@code{floor} and @code{ceil} from the standard mathematics library +(which also take and return @code{double} arguments). + @node Scientific @subsection Scientific Functions @@ -955,6 +971,43 @@ Return the hyperbolic arccosine of @var{x}. Return the hyperbolic arctangent of @var{x}. @end deffn +For the hyperbolic arc-functions, the Guile library exports C functions +corresponding to these Scheme procedures, but taking and returning +arguments of type @code{double} rather than the usual @code{SCM}. + +@deftypefn {C Function} double scm_asinh (double x) +@deftypefnx {C Function} double scm_acosh (double x) +@deftypefnx {C Function} double scm_atanh (double x) +Return the hyperbolic arcsine, arccosine or arctangent of @var{x} +respectively. +@end deftypefn + +For all the other Scheme procedures above, except @code{expt} and +@code{atan2} (whose entries specifically mention an equivalent C +function), the equivalent C functions are those provided by the standard +mathematics library. The mapping is as follows. + +@multitable {xx} {Scheme Procedure} {C Function} +@item @tab Scheme Procedure @tab C Function + +@item @tab @code{$abs} @tab @code{fabs} +@item @tab @code{$sqrt} @tab @code{sqrt} +@item @tab @code{$sin} @tab @code{sin} +@item @tab @code{$cos} @tab @code{cos} +@item @tab @code{$tan} @tab @code{tan} +@item @tab @code{$asin} @tab @code{asin} +@item @tab @code{$acos} @tab @code{acos} +@item @tab @code{$atan} @tab @code{atan} +@item @tab @code{$exp} @tab @code{exp} +@item @tab @code{$log} @tab @code{log} +@item @tab @code{$sinh} @tab @code{sinh} +@item @tab @code{$cosh} @tab @code{cosh} +@item @tab @code{$tanh} @tab @code{tanh} +@end multitable + +@noindent +Naturally, these C functions expect and return @code{double} arguments. + @node Bitwise Operations @subsection Bitwise Operations |