Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

sin(3) Guardian Native C Library Calls Reference Manual
NAME
sin - Computes the trigonometric sine function
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL
G-series native OSS processes: /G/system/sysnn/zcresrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL
H-series OSS processes: /G/system/zdllnnn/zcredll
SYNOPSIS
#include <math.h>
double sin(
double x);
PARAMETERS
x is the value for which the trigonometric sine function is to be computed.
DESCRIPTION
The sin() function computes the sine of x, measured in radians.
NOTES
The sin() function loses accuracy when passed a large value for the x parameter.
This function supports both IEEE Std 754-1985 floating-point and Tandem floating-point values
in the native environment. IEEE values can include NaN and infinity, and the sign of 0.0 (zero)
can be either positive or negative. Refer to the fp_class(3) reference page for a description of
IEEE value classes.
Guardian functions are available to convert between floating-point formats. Refer to the Guar-
dian Programmer’s Guide for a discussion of floating-point conversions.
RETURN VALUES
The sin() function returns the sine of its parameter.
For IEEE floating-point values, if the value of x is NaN, NaN is returned. If the value of x is
positive or negative infinity,NaN is returned and errno is set to [EDOM].
If the correct result would cause underflow, 0.0 (zero) is returned.
ERRORS
If any of the following conditions occurs, the sin() function sets errno to the corresponding
value:
[EDOM] The value of x is infinite.
RELATED INFORMATION
Functions: acos(3), acosh(3), asin(3), asinh(3), atan(3), atanh(3), atan2(3), cos(3), cosh(3),
fp_class(3), isnan(3), sinh(3), tan(3), tanh(3).
Files: float(4), math(4).
STANDARDS CONFORMANCE
This function conforms with the XPG4 Version 2 specification with extensions when used for
IEEE floating-point data. This function conforms with the XPG4 Version 2 specification without
extensions when used for Tandem floating-point data.
The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
The following features are affected in the HP implementation:
• For IEEE floating-point data, when the value of x is infinite, NaN is returned instead of
0.0 (zero).
6−26 Hewlett-Packard Company 527192-005