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

ManualsBrandsHP ManualsServerHP NonStop G-Series

Guardian Native C

Library Calls

Reference Manual

Abstract

This manual describes the HP C for NonStop servers run-time library available to

TNS/R or TNS/E native programs in the Guardian environment.

Product Version

N.A.

Supported Release Version Updates (RVUs)

This manual supports G06.28 and H06.04 and all subsequent G-series and H-series

release version updates until otherwise indicated in a replacement publication.

Part Number Published

527192-005 February 2006

Summary of content (655 pages)

PAGE 1
Guardian Native C Library Calls Reference Manual Abstract This manual describes the HP C for NonStop servers run-time library available to TNS/R or TNS/E native programs in the Guardian environment. Product Version N.A. Supported Release Version Updates (RVUs) This manual supports G06.28 and H06.04 and all subsequent G-series and H-series release version updates until otherwise indicated in a replacement publication.
PAGE 2
Document History Part Number Product Version Published 527192-005 527192-004 527192-003 N/A N/A N/A February 2006 September 2005 July 2005 New editions incorporate any updates issued since the previous edition.
PAGE 3
Contents _____________________________ What is New in This Manual . . . . . . . . . . . . . . . . . . . . xiii Changed Functions . . . . . . . . . . . . . . . . . . . xiii About This Manual . . . . . . . . . . . . . . . . . . . . . . xv . . . . . . . . . . . . . . . . . . . . . . xv Document Usage . . . . . . . . . . . . . . . . . . . . xvi Reference Page Format . . . . . . . . . . . .
PAGE 4
cosh . . . ctime . . . cuserid . . . dec_to_longlong difftime . . div . . . . dlclose . . . dlerror . . . dlopen . . . dlresultcode . dlsym . . . drand48 . . ecvt . . . . edfseek . . . edftell . . . endgrent . . endpwent . . erand48 . . erf . . . . erfc . . . . exit . . . . exp . . . . expm1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 5
Guardian Native C Library Calls Reference Manual free . . . . freopen . . . freopen_guardian freopen_oss . frexp . . . fscanf . . . fseek . . . fsetpos . . . ftell . . . . ftime . . . ftok . . . . fwrite . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 3. Guardian Native C Library Calls gamma . . . . . . . . gcvt . . . . . . . . . get_assign_msg . . . . . get_assign_msg_by_name . . getc . . . . . . . . . getchar . . . . . . . . getdate . . . . . . . . getenv . . . . . . . . getgrent . . . .
PAGE 6
Contents isdigit . isgraph . islower . isnan . isprint . ispunct . isspace . isupper . iswalnum iswalpha iswcntrl iswctype iswdigit iswgraph iswlower iswprint iswpunct iswspace iswupper iswxdigit isxdigit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 4. Guardian Native C Library Calls j0 . . . . . . . . . j1 . . . . . . . . . jn . . . . . . . . . jrand48 . . . . . . . . l64a . . . . . . . . . labs . . . . . . . . .
PAGE 7
Guardian Native C Library Calls Reference Manual memmove memset . _min . mktime . modf . mrand48 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 5. Guardian Native C Library Calls nextafter . . . . . . . nl_langinfo . . . . . . nrand48 . . . . . . . __ns_backup_fopen . . . . __ns_fget_file_open_state . . __ns_fget_file_state . . . . __ns_fopen_special . . . . __ns_fset_file_state . . . . __ns_start_backup . . . . perror . . . . . . . . pow . .
PAGE 8
Contents setpwent . setstate . . setvbuf . . signal . . sin . . . sinh . . . sprintf . . sqrt . . . srand . . srand48 . srandom . sscanf . . strcasecmp strcat . . strchr . . strcmp . . strcoll . . strcpy . . strcspn . . strdup . . strerror . . strfmon . . strftime . strlen . . strncasecmp strncat . . strncmp . strncpy . . strpbrk . . strptime . strrchr . . strspn . . strstr . . strtod . . strtok . . strtol . . strtoll . . strtoul . . strtoull . . strxfrm . . sysconf . . system . . . . . . . . . . . . . . .
PAGE 9
Guardian Native C Library Calls Reference Manual tmpnam_guardian tmpnam_oss . toascii . . . _tolower . . tolower . . . _toupper . . toupper . . . towlower . . towupper . . tsearch . . . twalk . . . tzset . . . ungetc . . . ungetwc . . unordered . . va_arg . . . va_end . . . valloc . . . va_start . . vfprintf . . . vprintf . . . vsprintf . . wcscat . . . wcschr . . . wcscmp . . wcscpy . . . wcscspn . . wcsftime . . wcsncat . . wcsncmp . . wcsncpy . . wcspbrk . . wcsrchr . . wcsspn . . . wcstod . . . wcstok .
PAGE 10
Contents Permuted Index Index . 527192-005 . . . . . . . . . . . . . . . . . . . . . . . . . Pindex-1 . . . . . . . . . . . . . . . . . . . . . . .
PAGE 11
Guardian Native C Library Calls Reference Manual LIST OF TABLES Table 2−1. Values of File-Related Constants for Open Files . . . . . . . . . . . . 2-36 Table 6−1. Default Values for Monetary Formatting . . . . . . . . . . . 6-58 . . . . . . . . . . 6-58 . . Table 6−2. Example Output from s t r f m o n ( xi .
PAGE 12
What is New in This Manual This section describes changes made to the Guardian Native C Library Calls Reference Manual since the 527192-004 edition.
PAGE 13
Guardian Native C Library Calls Reference Manual The description of heap_check_always(3) was changed to indicate that the value of 1 (instead of any nonzero value) for the switch parameter enables automatic checking. This change resolves Genesis solution 10-051010-1940.
PAGE 14
About This Manual The Guardian Native C Library Calls Reference Manual contains reference pages for the functions in the Guardian TNS/R and TNS/E native C run-time libraries. The native C run-time library can only be used by native programs. Refer to the Guardian TNS C Library Calls Reference Manual for information about the Guardian TNS C run-time library. Refer to the Open System Services Library Calls Reference Manual for information about C library calls in the OSS environment.
PAGE 15
Guardian Native C Library Calls Reference Manual Document Usage This manual is built from the online manual reference (man) pages that are part of the HP NonStop Open System Services (OSS) product. The reference pages document the behavior of C run-time library calls made from: • Programs compiled for the Guardian environment that run as native processes. • Programs compiled for the OSS environment that run as native processes.
PAGE 16
About This Manual CAUTIONS Information on possible system damage or data corruption as a result of using the function in a specific way. RETURN VALUES Indication of successful or unsuccessful completion when the function is invoked. ERRORS Error conditions under which the function might fail, and the errno value associated with each condition. FILES Files related to the function, except for any header files listed under the SYNOPSIS heading.
PAGE 17
Guardian Native C Library Calls Reference Manual Bold Bold words or characters represent system elements that you must use literally, such as commands, flags, and pathnames. Italic Italic words or characters represent variable values that you must supply. Constant width Examples and information that the system displays appear in the constant width typeface. [ ] Brackets enclose optional items in format and syntax descriptions. | A vertical bar separates items in a list of choices. ...
PAGE 18
Section 1. Guardian Native C Library Calls (a - e) This section contains reference pages documenting library calls with English names beginning with the letter a through the letter e that are included in the Guardian native C run-time libraries. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 19
a64l(3) Guardian Native C Library Calls Reference Manual NAME a64l - Converts a radix-64 ASCII string to a 32-bit integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include long a64l(const char *s); PARAMETERS s Is a pointer to a string in radix-64 ASCII notation.
PAGE 20
Guardian Native C Library Calls (a - e) abort(3) NAME abort - Generates a software signal to end the current process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 21
_abs(3) Guardian Native C Library Calls Reference Manual NAME _abs - Expands absolute value of its argument LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include arith_type _abs ( arith_type expr ); PARAMETERS arith_type Any arithmetic type can be specified. expr Specifies an expression to be expanded to an absolute value. DESCRIPTION The _abs( ) macro evaluates to the absolute value of its argument.
PAGE 22
Guardian Native C Library Calls (a - e) abs(3) NAME abs - Computes absolute value of an integer 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 int abs( int i); PARAMETERS i Specifies an integer. DESCRIPTION The abs( ) function returns the absolute value of its integer operand.
PAGE 23
acos(3) Guardian Native C Library Calls Reference Manual NAME acos - Computes the inverse trigonometric cosine 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 double acos( double x); PARAMETERS x Is the value for which the inverse trigonometric cosine function is to be computed.
PAGE 24
Guardian Native C Library Calls (a - e) acos(3) The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following feature is affected in the HP implementation: • 527192-005 For IEEE floating-point values, errno is not set to [EDOM] when the value of x is NaN.
PAGE 25
acosh(3) Guardian Native C Library Calls Reference Manual NAME acosh - Computes the inverse hyperbolic cosine 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 double acosh( double x); PARAMETERS x Is the value for which the inverse hyperbolic cosine function is to be computed.
PAGE 26
Guardian Native C Library Calls (a - e) alarm(3) NAME alarm - Sets or changes the timeout value for interval timers LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include unsigned int alarm( unsigned int seconds); PARAMETERS seconds Specifies the number of real-time seconds before the timer expires.
PAGE 27
asctime(3) Guardian Native C Library Calls Reference Manual NAME asctime - Converts broken-down time into a date and time string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 28
Guardian Native C Library Calls (a - e) asin(3) NAME asin - Computes the inverse 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 double asin( double x); PARAMETERS x Is the value for which the inverse trigonometric sine function is to be computed.
PAGE 29
asin(3) Guardian Native C Library Calls Reference Manual The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 1−12 • When used for IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 30
Guardian Native C Library Calls (a - e) asinh(3) NAME asinh - Computes the inverse hyperbolic 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 double asinh( double x); PARAMETERS x Is the value for which the inverse hyperbolic sine function is to be computed.
PAGE 31
assert(3) Guardian Native C Library Calls Reference Manual NAME assert - Inserts program diagnostics LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void assert ( int expression); PARAMETERS expression Specifies an expression that is evaluated as TRUE or FALSE. This expression is evaluated in the same manner as a C language if control statement. DESCRIPTION The assert( ) macro inserts diagnostics into programs.
PAGE 32
Guardian Native C Library Calls (a - e) atan2(3) NAME atan2 - Computes the inverse trigonometric tangent function of y/x 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
PAGE 33
atan2(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point format data. This function conforms to 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.
PAGE 34
Guardian Native C Library Calls (a - e) atan(3) NAME atan - Computes the inverse trigonometric tangent 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 double atan( double x); PARAMETERS x Is the value for which the inverse trigonometric tangent function is to be computed.
PAGE 35
atanh(3) Guardian Native C Library Calls Reference Manual NAME atanh - Computes the inverse hyperbolic tangent 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 double atanh( double x); PARAMETERS x Is the value for which the inverse hyperbolic tangent function is to be computed.
PAGE 36
Guardian Native C Library Calls (a - e) atanh(3) STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 527192-005 • When used for IEEE floating-point values, this function does not set errno to [EDOM] when the value of x is NaN. • When used for Tandem floating-point values, this function does not return the value NaN when an invalid parameter is passed.
PAGE 37
atexit(3) Guardian Native C Library Calls Reference Manual NAME atexit - Provides for cleanup on process termination LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include
PAGE 38
Guardian Native C Library Calls (a - e) atof(3) NAME atof - Converts a character string to a double-precision floating-point value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include double atof( const char *nptr); PARAMETERS nptr Points to the character string to be converted.
PAGE 39
atof(3) Guardian Native C Library Calls Reference Manual NOTES 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.
PAGE 40
Guardian Native C Library Calls (a - e) atoi(3) NAME atoi - Converts a character string to an integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int atoi( const char *nptr); PARAMETERS nptr Points to the character string to convert.
PAGE 41
atol(3) Guardian Native C Library Calls Reference Manual NAME atol - Converts a character string to a long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long int atol( const char *nptr); PARAMETERS nptr Points to the character string to convert.
PAGE 42
Guardian Native C Library Calls (a - e) atoll(3) NAME atoll - Converts a character string to a long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long long int atoll ( const char *nptr ); PARAMETERS nptr Points to the character string to convert.
PAGE 43
bcmp(3) Guardian Native C Library Calls Reference Manual NAME bcmp - Compares two areas of memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZI18NSRL G-series native OSS processes: /G/system/sysnn/zi18nsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int bcmp( const void *s1, const void *s2, size_t n); PARAMETERS s1 Is a pointer to the first area to be compared.
PAGE 44
Guardian Native C Library Calls (a - e) bcopy(3) NAME bcopy - Copies an area of memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZI18NSRL G-series native OSS processes: /G/system/sysnn/zi18nsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void bcopy( const void *s1, void *s2, size_t n); PARAMETERS s1 Is a pointer to the area to be copied.
PAGE 45
bsearch(3) Guardian Native C Library Calls Reference Manual NAME bsearch - Performs a binary search LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 46
Guardian Native C Library Calls (a - e) bzero(3) NAME bzero - Zeroes an area of memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void bzero( void *s, size_t n); PARAMETERS s Is a pointer to the area to be zeroed. n Is the number of bytes to zero.
PAGE 47
calloc(3) Guardian Native C Library Calls Reference Manual NAME calloc - Allocates memory in an array 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 #include
PAGE 48
Guardian Native C Library Calls (a - e) cbrt(3) NAME cbrt - Computes the cube root of a floating-point number 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 double cbrt( double x); PARAMETERS x Is the value whose cube root is to be computed.
PAGE 49
ceil(3) Guardian Native C Library Calls Reference Manual NAME ceil - Rounds floating-point numbers to floating-point integers 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 double ceil( double x); PARAMETERS x Specifies the double value to be rounded.
PAGE 50
Guardian Native C Library Calls (a - e) chvol(3) NAME chvol - Changes default volume and subvolume names used to qualify partial Guardian filenames LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL For G-series OSS native processes: /G/system/sysnn/zcrtlsrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL For H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 51
clearerr(3) Guardian Native C Library Calls Reference Manual NAME clearerr - Clears indicators on a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void clearerr( FILE *stream); PARAMETERS stream Specifies the input or output stream to be cleared.
PAGE 52
Guardian Native C Library Calls (a - e) clock(3) NAME clock - Reports processor time used LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include clock_t clock(void); DESCRIPTION The clock( ) function reports the amount of processor time used by the calling process.
PAGE 53
confstr(3) Guardian Native C Library Calls Reference Manual NAME confstr - Determines the current value of a specified system variable defined by a string value LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include
PAGE 54
Guardian Native C Library Calls (a - e) confstr(3) ERRORS If the specified name value does not have a system-defined value, the confstr( ) function returns a value of 0 (zero) and leaves the errno value unchanged. If the specified name value is invalid, the value 0 (zero) is returned, and errno is set to [EINVAL]. [EINVAL] The value of the name parameter is invalid. RELATED INFORMATION Functions: pathconf(3), sysconf(3).
PAGE 55
copysign(3) Guardian Native C Library Calls Reference Manual NAME copysign - Returns x with the sign of y LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL For G-series OSS native processes: /G/system/sysnn/zcrtlsrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL For H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include double copysign( double x, double y ); PARAMETERS x Specifies a double-precision floating-point value.
PAGE 56
Guardian Native C Library Calls (a - e) cos(3) NAME cos - Computes the trigonometric cosine 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 double cos( double x); PARAMETERS x Is the value for which the trigonometric cosine function is to be computed.
PAGE 57
cos(3) 1−40 Guardian Native C Library Calls Reference Manual • For IEEE floating-point values, errno is not set to 0.0 (zero) when the value of x is positive or negative infinity. • errno is not set to [ERANGE] when the return value would cause underflow.
PAGE 58
Guardian Native C Library Calls (a - e) cosh(3) NAME cosh - Computes the hyperbolic cosine 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 double cosh( double x); PARAMETERS x Is the value for which the hyperbolic cosine function is to be computed.
PAGE 59
ctime(3) Guardian Native C Library Calls Reference Manual NAME ctime - Converts time since the Epoch into a date and time string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *ctime( const time_t *timer); PARAMETERS timer Points to a variable that specifies a time value in seconds.
PAGE 60
Guardian Native C Library Calls (a - e) cuserid(3) NAME cuserid - Gets the username associated with the real user ID of the current process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 61
cuserid(3) Guardian Native C Library Calls Reference Manual [EIO] A disk process or file system input or output error occurred. Data might have been lost during the transfer. [ENOCRE] The calling process does not use the Common Run-Time Environment (CRE) but requested a service that requires CRE (the static area cannot be allocated in the calling process). [ENOMEM] There is insufficient user memory to complete the call. RELATED INFORMATION Functions: getlogin(2), getpwent(3).
PAGE 62
Guardian Native C Library Calls (a - e) dec_to_longlong(3) NAME dec_to_longlong - Converts SQL DECIMAL value stored in a C array of decimal to a C long long value LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRESRL For G-series OSS native processes: /G/system/sysnn/zcresrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCREDLL For H-series OSS processes: /G/systemzdllsnnn/zcredll SYNOPSIS #include
PAGE 63
difftime(3) Guardian Native C Library Calls Reference Manual NAME difftime - Computes the difference between two calendar times LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include double difftime( time_t time1, time_t time2 ); PARAMETERS time1 Specifies a time value expressed in seconds.
PAGE 64
Guardian Native C Library Calls (a - e) div(3) NAME div - Divides integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include div_t div ( int numerator, int denominator); PARAMETERS numerator Specifies an integer. denominator Specifies an integer.
PAGE 65
dlclose(3) Guardian Native C Library Calls Reference Manual NAME dlclose - Invalidates a dynamic-link library handle and unloads any dynamically loaded library LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 66
Guardian Native C Library Calls (a - e) dlclose(3) RETURN VALUES Upon successful invalidation of the library handle, the function returns the value 0 (zero). Otherwise, a nonzero value is returned and the dlerror( ) or dlresultcode( ) function should be called immediately to determine the problem. ERRORS The dlclose( ) function does not set the errno variable. Error information is available through the dlerror( ) or dlresultcode( ) function.
PAGE 67
dlerror(3) Guardian Native C Library Calls Reference Manual NAME dlerror - Returns an explanation of a previous dynamic-link library error LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 68
Guardian Native C Library Calls (a - e) dlerror(3) ERRORS The dlerror( ) function does not set the errno variable. RELATED INFORMATION Functions: dlclose(3), dlopen(3), dlresultcode(3), dlsym(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification.
PAGE 69
dlopen(3) Guardian Native C Library Calls Reference Manual NAME dlopen - Opens a dynamic-link library loadfile from a running process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 70
Guardian Native C Library Calls (a - e) dlopen(3) RTLD_VERBOSE(n) Specifies the amount and kind of debugging information to provide on the home terminal or standard error file when an error occurs: 0 Perform the default behavior 1 Do not list warning or error messages on the home terminal or the standard error file 2 List warning and error messages 3 List warning and error messages and files loaded 4 List warning and error messages, files loaded, and symbol resolution 5 List warning and error
PAGE 71
dlopen(3) Guardian Native C Library Calls Reference Manual Symbol controls within the loadfiles affect a call to dlopen( ); that is, the library designated by object_pathname and each library it requires can be localized, globalized, or semi-globalized itself, and its symbols are resolved accordingly. dlopen( ) does not load licensed libraries. Controlling the Loader Search Path Users can specify the search path used to find libraries without fully qualified file names.
PAGE 72
Guardian Native C Library Calls (a - e) 4. Locations specified by -rld_l at link time (the value of rpath) 5. Default locations: dlopen(3) On OSS: /lib:/usr/lib:/usr/local/lib:/G/SYSTEM/ZDLL On Guardian: $SYSTEM.ZDLL Environment Variables and Runtime Searches At run time, users can modify the path list specified at link time. For OSS programs, the loadtime path lists can be specified using the following environment variables: _RLD_LIB_PATH=object_pathname[:object_pathname]...
PAGE 73
dlopen(3) Guardian Native C Library Calls Reference Manual For Guardian programs, the class MAP DEFINE =_RLDVERBOSE performs the equivalent action. For example: ADD DEFINE =_RLDVERBOSE, CLASS MAP, FILE #4 Disposing of Unresolved Symbols Users can specify an option to the ld or eld linker to control disposition of unresolved symbols in a loadfile.
PAGE 74
Guardian Native C Library Calls (a - e) dlopen(3) In the case of an error, a summary message can be retrieved by a call to dlerror( ). RELATED INFORMATION Commands: eld(1), ld(1). Functions: dlclose(3), dlerror(3), dlresultcode(3), dlsym(3). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification.
PAGE 75
dlresultcode(3) Guardian Native C Library Calls Reference Manual NAME dlresultcode - Returns the error code for the most recent call to dlopen(), dlclose(), or dlsym() LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 76
Guardian Native C Library Calls (a - e) dlresultcode(3) 7 The process phase changed unexpectedly while running initialization or termination functions, or constructors or destructors for global instances of classes. This error-detail can be generated only by a call to dlopen( ) or dlclose( ). 8 The RTLD_NOLOAD option was passed to dlopen( ), but the library specified by the object_pathname value of that function had not been loaded. ERRORS dlresultcode( ) does not set errno.
PAGE 77
dlsym(3) Guardian Native C Library Calls Reference Manual NAME dlsym - Obtains the address of an external symbol in a dynamic-link library LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZRLDSRL G-series native OSS processes: /G/system/sysnn/zrldsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 78
Guardian Native C Library Calls (a - e) dlsym(3) someData *theData; // pointer to structure // variable "theData" in "mydll" dlHandle handle; // handle from loading "mydll" handle = dlopen("mydll",RTLD_NOW); if (! handle) ... // error handling theFunction = (someFunction_p)dlsym(handle,"theFunction"); if (! theFunction) ... //error handling theData = (someData*)dlsym(handle,"theData"); if (! theData) ...
PAGE 79
drand48(3) Guardian Native C Library Calls Reference Manual NAME drand48 - Generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 80
Guardian Native C Library Calls (a - e) drand48(3) RETURN VALUES The drand48( ) function returns nonnegative, double-precision, floating-point values. RELATED INFORMATION Functions: erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), nrand48(3), rand(3), seed48(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 81
ecvt(3) Guardian Native C Library Calls Reference Manual NAME ecvt - Converts a floating-point number to a string 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 char *ecvt( double value, int ndigit, int *decpt, int *sign ); PARAMETERS value Is the floating-point number to be converted.
PAGE 82
Guardian Native C Library Calls (a - e) ecvt(3) RELATED INFORMATION Functions: fcvt(3), fp_class(3), gcvt(3), sprintf(3). STANDARDS CONFORMANCE The ecvt( ) function is defined in the XPG4 Version 2 specification.
PAGE 83
edfseek(3) Guardian Native C Library Calls Reference Manual NAME edfseek - Sets the file-position indicator of an Edit file opened for ANSI I/O LIBRARY For G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL For G-series OSS native processes: /G/system/sysnn/zcrtlsrl For H-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL For H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 84
Guardian Native C Library Calls (a - e) edfseek(3) the file. For absolute positioning (using pos_base value SEEK_SET), pos is the Edit line number multiplied by 1000. For example, 23000L corresponds to line 23, and 44120L corresponds to line 44.12. Using absolute positioning, edfseek( ) sets the file position to the specified line if and only if the specified line exists in the file.
PAGE 85
edftell(3) Guardian Native C Library Calls Reference Manual NAME edftell - Retrieves the file-position indicator of an Edit file opened for ANSI I/O LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long edftell ( FILE *stream); PARAMETERS stream denotes an Edit file opened for ANSI I/O.
PAGE 86
Guardian Native C Library Calls (a - e) endgrent(3) NAME endgrent - Closes the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include void endgrent(void); DESCRIPTION The getgrent( ), getgrgid( ), getgrnam( ), setgrent( ), and endgrent( ) functions are used to access group attributes.
PAGE 87
endpwent(3) Guardian Native C Library Calls Reference Manual NAME endpwent - Closes the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include void endpwent(void); DESCRIPTION The endpwent( ) function normally closes the user authentication database.
PAGE 88
Guardian Native C Library Calls (a - e) erand48(3) NAME erand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 89
erand48(3) Guardian Native C Library Calls Reference Manual IEEE value classes. Guardian functions are available to convert between floating-point formats. Refer to the Guardian Programmer’s Guide for a discussion of floating-point conversions. RETURN VALUES The erand48( ) function returns nonnegative, double-precision, floating-point values. RELATED INFORMATION Functions: drand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), nrand(3), rand(3), seed48(3), srand48(3).
PAGE 90
Guardian Native C Library Calls (a - e) erf(3) NAME erf - Computes the error 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 double erf( double x); PARAMETERS x Specifies the double value for which the error function is to be computed.
PAGE 91
erfc(3) Guardian Native C Library Calls Reference Manual NAME erfc - Computes the complementary error 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 double erfc( double x); PARAMETERS x Specifies the double value for which the complementary error function is to be computed.
PAGE 92
Guardian Native C Library Calls (a - e) exit(3) NAME exit - Terminates a process LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void exit( int status); PARAMETERS status Indicates the status of the process.
PAGE 93
exp(3) Guardian Native C Library Calls Reference Manual NAME exp - Computes the exponential 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 double exp( double x); PARAMETERS x Specifies the power to which the base of the natural logarithms (e) is to be raised.
PAGE 94
Guardian Native C Library Calls (a - e) exp(3) The XPG4 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527192-005 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 95
expm1(3) Guardian Native C Library Calls Reference Manual NAME expm1 - Computes the exponential function minus 1.0 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 double expm1( double x); PARAMETERS x Is the power to which the base of the natural logarithms (e) is to be raised.
PAGE 96
Section 2. Guardian Native C Library Calls (f) This section contains reference pages documenting library calls with English names beginning with the letter f that are included in the Guardian native C run-time libraries. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 97
fabs(3) Guardian Native C Library Calls Reference Manual NAME fabs - Computes the floating-point absolute value 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 double fabs( double x); PARAMETERS x Specifies the double value whose absolute value is to be computed.
PAGE 98
Guardian Native C Library Calls (f) fclose(3) NAME fclose - Closes a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fclose ( FILE *stream); PARAMETERS stream Specifies the output or update stream.
PAGE 99
fclose(3) Guardian Native C Library Calls Reference Manual [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. RELATED INFORMATION Functions: close(2), exit(2), fflush(3), fopen(3), setbuf(3).
PAGE 100
Guardian Native C Library Calls (f) fcvt(3) NAME fcvt - Converts a floating-point number to a string 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 char *fcvt( double value, int ndigit, int *decpt, int *sign ); PARAMETERS value Specifies the floating-point number to be converted.
PAGE 101
fcvt(3) Guardian Native C Library Calls Reference Manual RETURN VALUES The fcvt( ) function returns a pointer to a null-terminated string representation of value. ERRORS No errors are returned. This function does not set errno. RELATED INFORMATION Functions: ecvt(3), fp_class(3), gcvt(3), sprintf(3). STANDARDS CONFORMANCE The fcvt( ) function is defined in the XPG4 Version 2 specification.
PAGE 102
Guardian Native C Library Calls (f) fdopen(3) NAME fdopen - Associates a stream with a file descriptor LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 103
fdopen(3) Guardian Native C Library Calls Reference Manual ignored. All output is written at the end of the file and the file pointer is repositioned to the end of the output. If two separate processes open the same file for append, each process can write freely to the file without destroying the output being written by the other. The output from the two processes is intermixed in the order in which it is written to the file.
PAGE 104
Guardian Native C Library Calls (f) feof(3) NAME feof - Tests EOF on a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int feof( FILE *stream); PARAMETERS stream Specifies the input stream.
PAGE 105
ferror(3) Guardian Native C Library Calls Reference Manual NAME ferror - Tests the error indicator on a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ferror( FILE *stream); PARAMETERS stream Specifies the input or output stream.
PAGE 106
Guardian Native C Library Calls (f) fflush(3) NAME fflush - Flushes a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fflush( FILE *stream); PARAMETERS stream Specifies the output or update stream.
PAGE 107
fflush(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: close(2), exit(2), fclose(3), fopen(3), setbuf(3). STANDARDS CONFORMANCE The [ENXIO] errno value is not defined in the POSIX standards. It is an optional extension defined in the XPG4 version 2 specification.
PAGE 108
Guardian Native C Library Calls (f) ffs(3) NAME ffs - Finds first bit set LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int ffs(int i); PARAMETERS i is an integer to examined.
PAGE 109
fgetc(3) Guardian Native C Library Calls Reference Manual NAME fgetc - Gets a character from a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fgetc( FILE *stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 110
Guardian Native C Library Calls (f) fgetc(3) RELATED INFORMATION Functions: getc(3), getchar(3), gets(3), getwc(3), putc(3), read(2). STANDARDS CONFORMANCE The [ENXIO] errno value is an extension to the POSIX standard and an optional extension in the XPG4 Version 2 specification.
PAGE 111
fgetpos(3) Guardian Native C Library Calls Reference Manual NAME fgetpos - Reposition the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fgetpos( FILE *stream, fpos_t *position); PARAMETERS stream Specifies the I/O stream.
PAGE 112
Guardian Native C Library Calls (f) fgets(3) NAME fgets - Gets a string from a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *fgets( char *string, int n, FILE *stream); PARAMETERS string Points to a string to receive bytes.
PAGE 113
fgets(3) [ENOMEM] Guardian Native C Library Calls Reference Manual Insufficient memory is available for the operation. Any error encountered during the underlying call to the read( ) function can cause this function to return the corresponding errno value reported by the read( ) function.
PAGE 114
Guardian Native C Library Calls (f) fgetwc(3) NAME fgetwc - Gets a wide character from a a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t fgetwc( FILE *stream); PARAMETERS stream Specifies the input data.
PAGE 115
fgetws(3) Guardian Native C Library Calls Reference Manual NAME fgetws - Gets a wide character string from a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *fgetws( wchar_t *string, int number, FILE *stream); PARAMETERS wstring Points to a string to receive characters.
PAGE 116
Guardian Native C Library Calls (f) fileno(3) NAME fileno - Maps a stream pointer to a file descriptor LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fileno( FILE *stream); PARAMETERS stream Specifies the input stream.
PAGE 117
finite(3) Guardian Native C Library Calls Reference Manual NAME finite - Tests whether a floating-point number is infinite 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 int finite( double x); PARAMETERS x Specifies a double-precision IEEE floating-point value.
PAGE 118
Guardian Native C Library Calls (f) floor(3) NAME floor - Rounds floating-point numbers to floating-point integers 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 double floor( double x); PARAMETERS x Specifies the double value to be rounded.
PAGE 119
fmod(3) Guardian Native C Library Calls Reference Manual NAME fmod - Computes the modulo remainder of a division operation 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 double fmod( double x, double y ); PARAMETERS x Specifies the double value that is the numerator of the division.
PAGE 120
Guardian Native C Library Calls (f) fmod(3) RELATED INFORMATION Functions: abs(3), ceil(3), fabs(3), floor(3), fp_class(3), isnan(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point values. This function conforms to the XPG4 Version 2 specification without extensions when used for Tandem floating-point values. The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
PAGE 121
fopen(3) Guardian Native C Library Calls Reference Manual NAME fopen - Opens a file stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the fopen( ) function: fopen_oss( ) and fopen_guardian( ).
PAGE 122
Guardian Native C Library Calls (f) fopen_guardian(3) NAME fopen_guardian - Opens a stream (Guardian fopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 123
fopen_guardian(3) Guardian Native C Library Calls Reference Manual rb Opens a C binary file for reading. wb Creates a new C binary file for writing, or opens and truncates a C binary file to zero length. ab Appends (opens a C binary file for writing at the end of the file, or creates a C binary file for writing). rb+ Opens a C binary file for update (reading and writing). wb+ Truncates or creates a C binary file for update.
PAGE 124
Guardian Native C Library Calls (f) fopen_guardian(3) Explicit calls to the fopen_oss( ) and fopen_guardian( ) variants in source code are only made when the behavior of one environment is desired from the other environment. fopen_oss( ) is functionally identical to the fopen( ) function of the OSS environment. It is the same as setting systype oss at compile-time. systype oss is the default setting for c89 in the OSS environment and on UNIX workstations.
PAGE 125
fopen_oss(3) Guardian Native C Library Calls Reference Manual NAME fopen_oss - Opens a stream (OSS fopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 126
Guardian Native C Library Calls (f) fopen_oss(3) the end of the file. When you open a file for append (that is, when the mode parameter is a or a+), it is impossible to overwrite information already in the file. You can use the fseek( ) function to reposition the file pointer to any position in the file, but when output is written to the file, the current file pointer is ignored. All output is written at the end of the file and the file pointer is repositioned to the end of the output.
PAGE 127
fopen_oss(3) Guardian Native C Library Calls Reference Manual [EINTR] The function was interrupted by a signal that was caught. [EINVAL] The mode parameter is not a valid mode. [EISDIR] The named file is a directory and mode requires write access. [EMFILE] The OPEN_MAX file descriptors are currently open in the calling process. [ENAMETOOLONG] The length of the path string exceeds PATH_MAX or a pathname component is longer than NAME_MAX. [ENFILE] Too many files are currently open in the processor.
PAGE 128
Guardian Native C Library Calls (f) fopen_std_file(3) NAME fopen_std_file - Opens standard input, standard output, or standard error file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 129
fpathconf(3) Guardian Native C Library Calls Reference Manual NAME fpathconf - Gets file configuration attributes for an open file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include
PAGE 130
Guardian Native C Library Calls (f) PATH_MAX fpathconf(3) Is the maximum number of bytes in a pathname (including a terminating null). The value returned is the maximum length of a relative pathname when the specified file is a directory. Value of name: _PC_PATH_MAX PIPE_BUF Is the maximum number of bytes guaranteed to be written atomically. This attribute is applicable only to a pipe or FIFO file. The value returned applies to the referenced object.
PAGE 131
fpathconf(3) Guardian Native C Library Calls Reference Manual The following table shows the values the fpathconf( ) function returns for the symbolic constants defined in the unistd.h file that correspond to the name parameter: Table 2−1.
PAGE 132
Guardian Native C Library Calls (f) • [EIO] fpathconf(3) The filedes parameter specifies an AF_INET or AF_INET6 socket or an unbound AF_UNIX socket. An input or output error occurred. The device holding the file might be in the down state, or both processors that provide access to the device might have failed. [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment.
PAGE 133
fpathconf(3) Guardian Native C Library Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: • 2−38 The errno values [EFSBAD], [EIO], [EISGUARDIAN], [ENETDOWN], [ENOROOT], [ENXIO], and [EWRONGID] can be returned by the fpathconf( ) function.
PAGE 134
Guardian Native C Library Calls (f) fp_class(3) NAME fp_class - Returns the class of a floating-point value 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 int fp_class( double x); PARAMETERS x Specifies a double-precision IEEE floating-point value.
PAGE 135
fp_class(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: isnan(3). STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification and provides features of the IEEE Std 754-1985 that are implementation-defined.
PAGE 136
Guardian Native C Library Calls (f) fprintf(3) NAME fprintf - Prints formatted output to an output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fprintf ( FILE *stream, const char *format [, value] . . .
PAGE 137
fprintf(3) Guardian Native C Library Calls Reference Manual • + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero).
PAGE 138
Guardian Native C Library Calls (f) • fprintf(3) An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
PAGE 139
fprintf(3) 2−44 Guardian Native C Library Calls Reference Manual x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 140
Guardian Native C Library Calls (f) fprintf(3) S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 141
fprintf(3) Guardian Native C Library Calls Reference Manual ERRORS The fprintf( ) function fails if stream is unbuffered, or if stream’s buffer needed to be flushed and the function call caused an underlying write( ) or lseek( ) function to be invoked. In addition, if the fprintf( ) function fails, errno is set to one of the following values: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation.
PAGE 142
Guardian Native C Library Calls (f) fputc(3) NAME fputc - Writes a byte to a specified output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fputc( int c, FILE *stream); PARAMETERS c Specifies the character to be written. stream Points to the file structure of an open file.
PAGE 143
fputc(3) Guardian Native C Library Calls Reference Manual In addition, if any of the following conditions occur, the fputc( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing.
PAGE 144
Guardian Native C Library Calls (f) fputs(3) NAME fputs - Writes a string to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fputs( const char *string, FILE *stream); PARAMETERS string Points to a string to be written to output.
PAGE 145
fputs(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient storage space available. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
PAGE 146
Guardian Native C Library Calls (f) fputwc(3) NAME fputwc - Writes a wide character to a specified stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t fputwc( wint_t c, FILE *stream); PARAMETERS c Specifies the wide character to be written. stream Points to the output data.
PAGE 147
fputwc(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient storage space is available. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
PAGE 148
Guardian Native C Library Calls (f) fputws(3) NAME fputws - Writes a wide-character string to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fputws( wchar_t *string, FILE *stream); PARAMETERS string Points to a string to be written to output.
PAGE 149
fputws(3) Guardian Native C Library Calls Reference Manual [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
PAGE 150
Guardian Native C Library Calls (f) fread(3) NAME fread - Reads input from a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include size_t fread( void ∗ pointer, size_t size, size_t num_items, FILE ∗ stream); PARAMETERS pointer Points to an array.
PAGE 151
fread(3) Guardian Native C Library Calls Reference Manual [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the input stream and the process would be delayed in the read operation. [EBADF] The file descriptor underlying the input stream is not a valid file descriptor open for reading. [EINTR] The read operation was interrupted by a signal that was caught, and no data was transferred.
PAGE 152
Guardian Native C Library Calls (f) free(3) NAME free - Releases allocated memory 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 #include void free( void ∗ pointer); PARAMETERS pointer Points to the block of memory that was returned by a memory allocation function.
PAGE 153
freopen(3) Guardian Native C Library Calls Reference Manual NAME freopen - Opens a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the freopen( ) function: freopen_oss( ) and freopen_guardian( ).
PAGE 154
Guardian Native C Library Calls (f) freopen_guardian(3) NAME freopen_guardian - Opens a stream (Guardian freopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 155
freopen_guardian(3) Guardian Native C Library Calls Reference Manual r+ Opens a text file for update (reading and writing). w+ Truncates or creates a text file for update. a+ Appends (opens a text file for update, writing at the end of the file, or creates a text file for writing). rb Opens a C binary file for reading. wb Creates a new C binary file for writing, or opens and truncates a C binary file to zero length.
PAGE 156
Guardian Native C Library Calls (f) freopen_guardian(3) freopen_oss( ) is functionally identical to the freopen( ) function of the OSS environment. It is the same as setting systype oss at compile-time. systype oss is the default setting for c89 in the OSS environment and on UNIX workstations. freopen_guardian( ) is functionally identical to the freopen( ) function of the Guardian environment. It is the same as setting systype guardian at compile-time.
PAGE 157
freopen_oss(3) Guardian Native C Library Calls Reference Manual NAME freopen_oss - Opens a stream (OSS freopen( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 158
Guardian Native C Library Calls (f) freopen_oss(3) w+ Truncates or creates a file for update. a+ Appends (opens a file for update, writing at the end of the file, or creates a file for writing). The OSS version of freopen( ) does not distinguish between text and binary files. Specifying a value of mode that consists of a r, w, or a followed by a b indicates a binary file. When you open a file for update, you can perform both input and output operations on the resulting stream.
PAGE 159
freopen_oss(3) Guardian Native C Library Calls Reference Manual [EINTR] The function was interrupted by a signal that was caught. [EINVAL] The mode parameter is not a valid mode. [EISDIR] The named file is a directory and mode requires write access. [EMFILE] The OPEN_MAX file descriptors are currently open in the calling process. [ENAMETOOLONG] The length of the path string exceeds PATH_MAX or a pathname component is longer than NAME_MAX.
PAGE 160
Guardian Native C Library Calls (f) frexp(3) NAME frexp - Breaks a floating-point number into a fraction and a power of 2 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
PAGE 161
frexp(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fp_class(3), isnan(3), ldexp(3), modf(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point format data. This function conforms to the XPG4 Version 2 specification without extensions when used for Tandem floating-point data. The XPG4 Version 2 specification allows certain features to be defined by the implementing vendor.
PAGE 162
Guardian Native C Library Calls (f) fscanf(3) NAME fscanf - Converts formatted input read from an input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fscanf( FILE *stream, const char *format [, *pointer] . . . ); PARAMETERS stream Specifies the input stream.
PAGE 163
fscanf(3) Guardian Native C Library Calls Reference Manual • Maximum width—if the conversion specification includes a maximum width and the field is not terminated by white space or an invalid character, then when that maximum width is reached in the input stream, the field is terminated. Conversion Specifications Each conversion specification in the format parameter has the following syntax: %[digit$][*][width][sizecode]convcode • The character % (percent sign) or %digit$.
PAGE 164
Guardian Native C Library Calls (f) • fscanf(3) A conversion code character convcode that specifies the type of conversion to be applied: % Accepts a single % (percent sign) input at this point; no assignment is done. c Accepts a single character or a series of characters. If there is either no width or a width of 1 in the conversion specification, one character is accepted and the corresponding pointer parameter should be a type char pointer.
PAGE 165
fscanf(3) Guardian Native C Library Calls Reference Manual o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer. p Matches an unsigned hexadecimal integer, the same as the %p conversion of the printf( ) function. The corresponding pointer parameter must be a pointer to a pointer to void. s Accepts a string of characters. The input field ends with a white-space character.
PAGE 166
Guardian Native C Library Calls (f) fscanf(3) The conversion code convcode indicates how to interpret the input field. The corresponding pointer must usually be of a restricted type. You should not specify the pointer parameter for a suppressed field. fscanf( ) processing ends at either the end of the input file, at the end of the conversion specifications, or when an input character conflicts with a conversion specification.
PAGE 167
fscanf(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3), sscanf(3). STANDARDS CONFORMANCE The [EILSEQ] and [EINVAL] errno values are extensions to the POSIX standards defined in the XPG4 Version 2 specification. The POSIX standards leave some features to the implementing vendor to define.
PAGE 168
Guardian Native C Library Calls (f) fseek(3) NAME fseek - Repositions the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fseek( FILE ∗ stream, long int offset, int whence); PARAMETERS stream Specifies the I/O stream.
PAGE 169
fseek(3) Guardian Native C Library Calls Reference Manual Information About Guardian EDIT Files If called from a native process, the fseek( ) function can operate on Guardian EDIT files (type 101 files). The behavior of this function differs according to whether the file is opened with a Guardian connection or with an OSS connection.
PAGE 170
Guardian Native C Library Calls (f) fseek(3) [EIO] The process is a member of a background process group attempting to write to its controlling terminal, the TOSTOP signal is set, the process is neither ignoring nor blocking SIGTTOU, and the process group of the process is orphaned. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device.
PAGE 171
fsetpos(3) Guardian Native C Library Calls Reference Manual NAME fsetpos - Repositions the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int fsetpos( FILE *stream, const fpos_t *position); PARAMETERS stream Specifies the I/O stream.
PAGE 172
Guardian Native C Library Calls (f) ftell(3) NAME ftell - Reports the position the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long int ftell( FILE ∗ stream); PARAMETERS stream Specifies the I/O stream.
PAGE 173
ftell(3) Guardian Native C Library Calls Reference Manual ERRORS If the following conditions occur, the ftell( ) function sets errno to the corresponding value: [EBADF] The file descriptor underlying the stream parameter is not a valid file descriptor. [ESPIPE] An illegal attempt was made to get set the file position of a pipe or FIFO. RELATED INFORMATION Functions: fgetpos(3), fopen(3), fseek(3), fsetpos(3), lseek(2), rewind(3).
PAGE 174
Guardian Native C Library Calls (f) ftime(3) NAME ftime - Gets date and time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ftime( struct timeb *tp); PARAMETERS tp Points to the timeb structure.
PAGE 175
ftok(3) Guardian Native C Library Calls Reference Manual NAME ftok - Generates an OSS interprocess communication (IPC) key LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include key_t ftok( const char *path_name, int id); PARAMETERS path_name Specifies the pathname of an existing file.
PAGE 176
Guardian Native C Library Calls (f) ftok(3) • The current working directory is assigned from the VOLUME attribute of the Guardian environment =_DEFAULTS DEFINE. • The use of static memory by the process increases slightly. These effects occur only when the first of the set of functions is called. The effects are not cumulative. NOTES The id parameter should be a single-byte character to ensure portability. CAUTIONS It is important for each installation to define standards for forming keys.
PAGE 177
ftok(3) Guardian Native C Library Calls Reference Manual • The specified file is on a remote HP NonStop server node and communication with the remote name server has been lost. [ENOTDIR] A component of the pathname pointed to by the path_name parameter is not a directory. [ENXIO] The caller’s current working directory or the root directory is not mounted. [EOSSNOTRUNNING] The program attempted an operation on an object in the OSS environment while a required system process was not running.
PAGE 178
Guardian Native C Library Calls (f) fwrite(3) NAME fwrite - Writes to an output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include size_t fwrite( const void ∗ pointer, size_t size, size_t num_items, FILE ∗ stream); PARAMETERS pointer Points to an array.
PAGE 179
fwrite(3) Guardian Native C Library Calls Reference Manual [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size.
PAGE 180
Section 3. Guardian Native C Library Calls (g - i) This section contains reference pages documenting library calls with English names beginning with the letter g through the letter i that are included in the Guardian native C run-time libraries. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 181
gamma(3) Guardian Native C Library Calls Reference Manual NAME gamma - Computes the logarithm of the gamma 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 double gamma( double x); extern int signgam; PARAMETERS x Specifies a positive double value.
PAGE 182
Guardian Native C Library Calls (g - i) gamma(3) RETURN VALUES Upon successful completion, the gamma( ) function returns the logarithmic gamma of x. For IEEE floating-point values, if the value of x is NaN, NaN is returned. If the value of x is positive infinity, NaN is returned. If the value of x is negative infinity, HUGE_VAL is returned and errno is set to [EDOM]. If the value of x is 0.0 (zero), HUGE_VAL is returned and errno is set to [EDOM].
PAGE 183
gcvt(3) Guardian Native C Library Calls Reference Manual NAME gcvt - Converts a floating-point number to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/sysnn/zcrtldll SYNOPSIS #include char *gcvt( double value, int ndigit, char *buf ); PARAMETERS value Specifies the floating-point number to be converted.
PAGE 184
Guardian Native C Library Calls (g - i) gcvt(3) RELATED INFORMATION Functions: ecvt(3), fcvt(3), fp_class(3), sprintf(3). STANDARDS CONFORMANCE The gcvt( ) function is defined in the XPG4 Version 2 specification.
PAGE 185
get_assign_msg(3) Guardian Native C Library Calls Reference Manual NAME get_assign_msg - Retrieves a specified assign message LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 186
Guardian Native C Library Calls (g - i) get_assign_msg(3) short access_spec; short record_size; short block_size; } assign_msg_type; In the type assign_msg_type, the structure members provide the following information: msg_code value of -2 for an ASSIGN message. logical_unit_name name of logical unit used in program and consists of program unit and file name.
PAGE 187
get_assign_msg_by_name(3) Guardian Native C Library Calls Reference Manual NAME get_assign_msg_by_name - Retrieves assign message by logical-unit name LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 188
Guardian Native C Library Calls (g - i) getc(3) NAME getc - Gets a character from a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int getc( FILE ∗ stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 189
getc(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. Any error encountered during the underlying call to the read( ) function can cause this function to return the corresponding errno value reported by the read( ) function.
PAGE 190
Guardian Native C Library Calls (g - i) getchar(3) NAME getchar - Gets a character from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int getchar(void); PARAMETERS None.
PAGE 191
getchar(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fgetc(3), getc(3), gets(3), getwc(3), putc(3), read(2). STANDARDS CONFORMANCE The [ENXIO] errno value is an extension to the POSIX standard and an optional extension in the XPG4 Version 2 specification.
PAGE 192
Guardian Native C Library Calls (g - i) getdate(3) NAME getdate - Converts user format date and time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include struct tm *getdate(const char *string); extern int getdate_err; PARAMETERS string Is a pointer to a string containing date/time information.
PAGE 193
getdate(3) Guardian Native C Library Calls Reference Manual %p Matches the equivalent of AM or PM in the current locale. %R Matches an appropriate representation of time for the current locale. In the POSIX locale, this is the same as %H%M. %r Matches an appropriate representation of time in the current locale’s equivalent of AM/PM notation. In the POSIX locale, this is the same as %I%M%S%p. %S Matches the seconds (00 to 61). Note that there is an allowance for two leap seconds.
PAGE 194
Guardian Native C Library Calls (g - i) getdate(3) • When the input string contains no hour, no minutes, and no seconds, the getdate( ) function assumes the current hour, minute, and second. • When the input string contains no date, the getdate( ) function assumes today if the given hour is greater than the current hour and assumes tomorrow if it is less. NOTES The getdate( ) function uses the getdate_err external variable to return error values.
PAGE 195
getenv(3) Guardian Native C Library Calls Reference Manual NAME getenv - Returns the value of an environment variable 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 char *getenv( const char *name); PARAMETERS name Specifies the name of an environment variable.
PAGE 196
Guardian Native C Library Calls (g - i) getgrent(3) NAME getgrent - Gets group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 197
getgrent(3) Guardian Native C Library Calls Reference Manual NOTES The data returned by the getgrent( ) function is stored in a static area and is overwritten on subsequent calls to the getgrent( ) function. If the data needs to be saved, it must be copied. Each string pointed to by a char * field of the group structure must be copied separately; an application should not assume that the strings are contiguously located within the structure.
PAGE 198
Guardian Native C Library Calls (g - i) getgrgid(3) NAME getgrgid - Gets group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 199
getgrgid(3) Guardian Native C Library Calls Reference Manual The gr_passwd field is provided for compatibility with some versions of UNIX, but it always contains a null string. NOTES The data returned by the getgrgid( ) function is stored in a static area and is overwritten on subsequent calls to the getgrgid( ) or getgrnam( ) function. An application should not rely on the data fields being stored contiguously.
PAGE 200
Guardian Native C Library Calls (g - i) getgrnam(3) NAME getgrnam - Gets group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 201
getgrnam(3) Guardian Native C Library Calls Reference Manual The gr_passwd field is provided for compatibility with some versions of UNIX, but it always contains a null string. NOTES The data returned by the getgrnam( ) function is stored in a static area and is overwritten on subsequent calls to the getgrgid( ) or getgrnam( ) function. An application should not rely on the data fields being stored contiguously.
PAGE 202
Guardian Native C Library Calls (g - i) get_max_assign_msg_ordinal(3) NAME get_max_assign_msg_ordinal - Determines number of active assign messages for a process 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
PAGE 203
getopt(3) Guardian Native C Library Calls Reference Manual NAME getopt - Gets flag letters from the argument vector LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 204
Guardian Native C Library Calls #define ARGS (g - i) getopt(3) "r:w:f:s" { int int int int c, errflg = 0; readers = 1, writers = 1; freeBufs = 1; doStats = FALSE; optarg = NULL; while (!errflg && (c = getopt(argc, argv, ARGS)) != -1) switch (c) { case ’r’ : readers = atoi(optarg); break; case ’w’ : writers = atoi(optarg); break; case ’f’ : freeBufs = atoi(optarg); break; case ’s’ : doStats = TRUE; break; default : errflg++; } NOTES The external int optopt variable is set to the real flag found in th
PAGE 205
getopt(3) Guardian Native C Library Calls Reference Manual • The argv[optind] result points to the - (dash) string. The getopt( ) function does increment optind if the result of argv[optind] points to the -- (dash dash) string. RELATED INFORMATION Commands: getopt(1).
PAGE 206
Guardian Native C Library Calls (g - i) get_param_by_name(3) NAME get_param_by_name - Retrieves value of a parameter by parameter name LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 207
get_param_msg(3) Guardian Native C Library Calls Reference Manual NAME get_param_msg - Retrieves the param message LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 208
Guardian Native C Library Calls (g - i) get_param_msg(3) RELATED INFORMATION Functions: get_assign_msg(3), get_assign_msg_by_name(3), get_max_assign_msg_ordinal(3), get_param_by_name(3), get_startup_msg(3). STANDARDS CONFORMANCE The get_param_msg( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 209
getpwent(3) Guardian Native C Library Calls Reference Manual NAME getpwent - Gets user attribute information from the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 210
Guardian Native C Library Calls (g - i) getpwent(3) Use From the Guardian Environment The getpwent( ) function can be used by a Guardian process when the process has been compiled using the #define _XOPEN_SOURCE_EXTENDED 1 feature-test macro or an equivalent compiler command option. NOTES All information generated by the getpwent( ) function is stored in a static area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 211
getpwnam(3) Guardian Native C Library Calls Reference Manual NAME getpwnam - Gets user attribute information from the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 212
Guardian Native C Library Calls (g - i) getpwnam(3) OSS user authentication database functions do not leave the database open between calls. Authentication records for user aliases follow regular user authentication records in the database. NOTES All information generated by the getpwnam( ) function is stored in a static area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 213
getpwuid(3) Guardian Native C Library Calls Reference Manual NAME getpwuid - Gets user attribute information from the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 214
Guardian Native C Library Calls (g - i) getpwuid(3) OSS user authentication database functions do not leave the database open between calls. Authentication records for user aliases follow regular user authentication records in the database. NOTES All information generated by the getpwuid( ) function is stored in a static area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 215
gets(3) Guardian Native C Library Calls Reference Manual NAME gets - Gets a string from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char ∗ gets( char ∗ string); PARAMETERS string Points to a string to receive bytes.
PAGE 216
Guardian Native C Library Calls [ENOMEM] (g - i) gets(3) Insufficient memory is available for the operation. Any error encountered during the underlying call to the read( ) function can cause this function to return the corresponding errno value reported by the read( ) function.
PAGE 217
get_startup_msg(3) Guardian Native C Library Calls Reference Manual NAME get_startup_msg - Retrieves the process startup message LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 218
Guardian Native C Library Calls (g - i) get_startup_msg(3) char volume[8]; char subvolume[8]; char file[8]; } parts; } outfile; char param[530]; } startup_msg_type; In the type startup_msg_type, the structure members provide the following information: msg_code message type; -1 means a startup message. defaults default volume and subvolume names. infile volume, subvolume, and file name of input file. outfile volume, subvolume, and file name of output file. param[530] text of message.
PAGE 219
get_startup_msg(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The get_startup_msg( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 220
Guardian Native C Library Calls (g - i) getw(3) NAME getw - Gets a word from an input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int getw( FILE *stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 221
getw(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fgetc(3), getc(3), getchar(3), gets(3), getwc(3), putc(3). STANDARDS CONFORMANCE The [ENXIO] errno value is an extension to the POSIX standard and an optional extension in the XPG4 specification.
PAGE 222
Guardian Native C Library Calls (g - i) getwc(3) NAME getwc - Gets a wide character from a specified input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t getwc( FILE *stream); PARAMETERS stream Specifies the input data.
PAGE 223
getwchar(3) Guardian Native C Library Calls Reference Manual NAME getwchar - Gets a wide character from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t getwchar(void); PARAMETERS None.
PAGE 224
Guardian Native C Library Calls (g - i) getws(3) NAME getws - Gets a wide character string from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *getws( wchar_t *string); PARAMETERS wstring Points to a string to receive characters.
PAGE 225
gfileno(3) Guardian Native C Library Calls Reference Manual NAME gfileno - Maps a stream pointer to a Guardian file number LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int gfileno( FILE *stream); PARAMETERS stream Specifies the open stream.
PAGE 226
Guardian Native C Library Calls (g - i) gmtime(3) NAME gmtime - Converts time since the Epoch to broken-down Coordinated Universal Time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 227
hcreate(3) Guardian Native C Library Calls Reference Manual NAME hcreate - Initializes a hash table LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int hcreate( size_t nel); PARAMETERS nel Specifies an estimate of the maximum number of entries that the hash table will contain.
PAGE 228
Guardian Native C Library Calls (g - i) hdestroy(3) NAME hdestroy - Removes a hash table LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void hdestroy(void); PARAMETERS None. DESCRIPTION The hsearch( ), hcreate( ), and hdestroy( ) functions are used to manage hash table operations.
PAGE 229
heap_check(3) Guardian Native C Library Calls Reference Manual NAME heap_check - Checks the consistency of the run-time heap 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 void heap_check(void); PARAMETERS None.
PAGE 230
Guardian Native C Library Calls (g - i) heap_check_always(3) NAME heap_check_always - Controls whether the run-time heap consistency is checked automatically 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
PAGE 231
heap_min_block_size(3) Guardian Native C Library Calls Reference Manual NAME heap_min_block_size - Specifies the minimum block size to attempt to use when allocating from the heap LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 232
Guardian Native C Library Calls (g - i) hsearch(3) NAME hsearch - Searches a hash table LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include ENTRY *hsearch( ENTRY item, ACTION action); PARAMETERS item Identifies a structure of the type ENTRY as defined in the search.h header file.
PAGE 233
hsearch(3) [ESRCH] Guardian Native C Library Calls Reference Manual The search failed. RELATED INFORMATION Functions: bsearch(3), hcreate(3), hdestroy(3), lsearch(3), tsearch(3), qsort(3).
PAGE 234
Guardian Native C Library Calls (g - i) hypot(3) NAME hypot - Computes the Euclidean distance 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 double hypot( double x, double y ); PARAMETERS x Specifies a double value. y Specifies a double value.
PAGE 235
hypot(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 3−56 • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 236
Guardian Native C Library Calls (g - i) ilogb(3) NAME ilogb - Computes the radix-independent exponent as an integer 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/sysnn/zcredll SYNOPSIS #include int ilogb( double x); PARAMETERS x Specifies the value for which the exponent is to be calculated.
PAGE 237
index(3) Guardian Native C Library Calls Reference Manual NAME index - Scans string for a first occurrence of a character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/sysnn/zcredll SYNOPSIS #include char *index ( const char *s, int c); PARAMETERS s Is a pointer to the string to be scanned.
PAGE 238
Guardian Native C Library Calls (g - i) initstate(3) NAME initstate - Initialize random number generator LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *initstate ( unsigned int seed, char *state, size_t size); PARAMETERS seed Is an unsigned int used to initialize a state array.
PAGE 239
isalnum(3) Guardian Native C Library Calls Reference Manual NAME isalnum - Tests for an alphanumeric character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isalnum( int c); PARAMETERS c Specifies the character to be tested.
PAGE 240
Guardian Native C Library Calls (g - i) isalpha(3) NAME isalpha - Tests for alphabetic character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isalpha( int c); PARAMETERS c Specifies the character to be tested.
PAGE 241
isascii(3) Guardian Native C Library Calls Reference Manual NAME isascii - Tests for ASCII character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isascii( int c); PARAMETERS c Specifies the character to be tested.
PAGE 242
Guardian Native C Library Calls (g - i) isatty(3) NAME isatty - Tests for a terminal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int isatty( int filedes); PARAMETERS filedes Specifies an open file descriptor.
PAGE 243
iscntrl(3) Guardian Native C Library Calls Reference Manual NAME iscntrl - Tests for control character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iscntrl( int c); PARAMETERS c Specifies the character to be tested.
PAGE 244
Guardian Native C Library Calls (g - i) isdigit(3) NAME isdigit - Tests for a digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isdigit( int c); PARAMETERS c Specifies the character to be tested.
PAGE 245
isgraph(3) Guardian Native C Library Calls Reference Manual NAME isgraph - Tests for a graphic character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isgraph( int c); PARAMETERS c Specifies the character to be tested.
PAGE 246
Guardian Native C Library Calls (g - i) islower(3) NAME islower - Test for lowercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int islower( int c); PARAMETERS c Specifies the character to be tested.
PAGE 247
isnan(3) Guardian Native C Library Calls Reference Manual NAME isnan - Tests whether a value is NaN (not a number) 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 int isnan( double x); PARAMETERS x Specifies a double-precision floating-point value.
PAGE 248
Guardian Native C Library Calls (g - i) isprint(3) NAME isprint - Tests for printable character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isprint( int c); PARAMETERS c Specifies the character to be tested.
PAGE 249
ispunct(3) Guardian Native C Library Calls Reference Manual NAME ispunct - Test for a punctuation character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ispunct( int c); PARAMETERS c Specifies the character to be tested.
PAGE 250
Guardian Native C Library Calls (g - i) isspace(3) NAME isspace - Tests for a white space character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isspace( int c); PARAMETERS c Specifies the character to be tested.
PAGE 251
isupper(3) Guardian Native C Library Calls Reference Manual NAME isupper - Test for an uppercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isupper( int c); PARAMETERS c Specifies the character to be tested.
PAGE 252
Guardian Native C Library Calls (g - i) iswalnum(3) NAME iswalnum - Tests for an alphanumeric wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswalnum( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 253
iswalpha(3) Guardian Native C Library Calls Reference Manual NAME iswalpha - Tests for an alphabetic wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswalpha( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 254
Guardian Native C Library Calls (g - i) iswcntrl(3) NAME iswcntrl - Tests for a wide control character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswcntrl( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 255
iswctype(3) Guardian Native C Library Calls Reference Manual NAME iswctype - Determines the properties of a wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswctype( wint_t wc, wctype_t wc_prop); PARAMETERS wc Specifies the wide character to be tested.
PAGE 256
Guardian Native C Library Calls (g - i) iswdigit(3) NAME iswdigit - Tests for a wide digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/ZDLLnnn/zcrtldll SYNOPSIS #include int iswdigit( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 257
iswgraph(3) Guardian Native C Library Calls Reference Manual NAME iswgraph - Tests for wide graphic character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswgraph( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 258
Guardian Native C Library Calls (g - i) iswlower(3) NAME iswlower - Tests for a wide lowercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswlower( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 259
iswprint(3) Guardian Native C Library Calls Reference Manual NAME iswprint - Tests for a printable wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswprint( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 260
Guardian Native C Library Calls (g - i) iswpunct(3) NAME iswpunct - Tests for a wide punctuation character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswpunct( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 261
iswspace(3) Guardian Native C Library Calls Reference Manual NAME iswspace - Test for a wide white-space character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswspace( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 262
Guardian Native C Library Calls (g - i) iswupper(3) NAME iswupper - Tests for a wide uppercase character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswupper( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 263
iswxdigit(3) Guardian Native C Library Calls Reference Manual NAME iswxdigit - Tests for a wide hexadecimal-digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int iswxdigit( wint_t wc); PARAMETER wc Specifies a wide character for testing.
PAGE 264
Guardian Native C Library Calls (g - i) isxdigit(3) NAME isxdigit - Tests for a hexadecimal digit character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int isxdigit( int c); PARAMETERS c Specifies the character to be tested.
PAGE 265
Section 4. Guardian Native C Library Calls (j - m) This section contains reference pages documenting library calls with English names beginning with the letter j through the letter m that are included in the Guardian native C run-time libraries. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 266
j0(3) Guardian Native C Library Calls Reference Manual NAME j0 - Computes the Bessel function of the first kind, of order 0 (zero) 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 double j0( double x); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 267
Guardian Native C Library Calls • 527192-005 (j - m) j0(3) errno is not set to [ERANGE] when underflow occurs.
PAGE 268
j1(3) Guardian Native C Library Calls Reference Manual NAME j1 - Computes the Bessel function of the first kind, of order 1 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 double j1( double x); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 269
Guardian Native C Library Calls • 527192-005 (j - m) j1(3) errno is not set to [ERANGE] when underflow occurs.
PAGE 270
jn(3) Guardian Native C Library Calls Reference Manual NAME jn - Computes the Bessel function of the first kind, of order n 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 double jn( int n, double x); PARAMETERS n Is an integer value specifying the order number.
PAGE 271
Guardian Native C Library Calls (j - m) jn(3) STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 527192-005 • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 272
jrand48(3) Guardian Native C Library Calls Reference Manual NAME jrand48 - Generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 273
Guardian Native C Library Calls (j - m) jrand48(3) Guardian functions are available to convert between floating-point formats. Refer to the Guardian Programmer’s Guide for a discussion of floating-point conversions. RETURN VALUES The jrand48( ) function returns signed long integers uniformly distributed over the range $-2 sup 31˜<=˜y˜<˜2 sup 31$. RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), lcong48(3), lrand48(3), mrand48(3), nrand48(3), rand(3), seed48(3), srand48(3).
PAGE 274
l64a(3) Guardian Native C Library Calls Reference Manual NAME l64a - Converts a 32-bit integer to a radix-64 ASCII string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *l64a(long value); PARAMETERS value Is a long value to be converted to radix-64 ASCII notation.
PAGE 275
Guardian Native C Library Calls (j - m) labs(3) NAME labs - Computes absolute value of long integer 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 long labs( long i); PARAMETERS i Specifies a long integer.
PAGE 276
lcong48(3) Guardian Native C Library Calls Reference Manual NAME lcong48 - Sets rule to generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 277
Guardian Native C Library Calls (j - m) lcong48(3) STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 278
ldexp(3) Guardian Native C Library Calls Reference Manual NAME ldexp - Multiplies a floating-point number by a power of 2 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 double ldexp( double value, int exp ); PARAMETERS value Specifies the value to be multiplied by a power of 2.
PAGE 279
Guardian Native C Library Calls (j - m) ldexp(3) STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point data. This function conforms to 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.
PAGE 280
ldiv(3) Guardian Native C Library Calls Reference Manual NAME ldiv - Divides long integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include ldiv_t ldiv ( long numerator, long denominator); PARAMETERS numerator Specifies a long integer. denominator Specifies a long integer.
PAGE 281
Guardian Native C Library Calls (j - m) lfind(3) NAME lfind - Performs a linear search LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 282
lgamma(3) Guardian Native C Library Calls Reference Manual NAME lgamma - Computes the logarithm of the gamma 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 double lgamma( double x); extern int signgam; PARAMETERS x Specifies a positive double value.
PAGE 283
Guardian Native C Library Calls (j - m) lgamma(3) RETURN VALUES Upon successful completion, the lgamma( ) function returns the logarithmic gamma of x. For IEEE floating-point values, if the value of x is NaN, NaN is returned. If the value of x is positive infinity, NaN is returned. If the value of x is negative infinity, HUGE_VAL is returned and errno is set to [EDOM]. If the value of x is 0.0 (zero), HUGE_VAL is returned and errno is set to [EDOM].
PAGE 284
lldiv(3) Guardian Native C Library Calls Reference Manual NAME lldiv - Divides long long integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include lldiv_t lldiv ( long long numerator, long long denominator); PARAMETERS numerator Specifies a long long integer.
PAGE 285
Guardian Native C Library Calls (j - m) localeconv(3) NAME localeconv - Retrieves locale-dependent formatting parameters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include struct lconv *localeconv(void); PARAMETERS None.
PAGE 286
localeconv(3) Guardian Native C Library Calls Reference Manual char *mon_grouping A string whose elements indicate the size of each group of digits in formatted monetary quantities. char *positive_sign The string used to indicate a nonnegative formatted monetary quantity. char *negative_sign The string used to indicate a negative formatted monetary quantity.
PAGE 287
Guardian Native C Library Calls (j - m) localeconv(3) _TANDEM_SOURCE, do not specify the leading two underscore characters. The elements of grouping and mon_grouping are interpreted according to the following: CHAR_MAX No further grouping is to be performed. 0 The previous element is to be repeatedly used for the remainder of the digits. other The integer value is the number of digits that comprise the current group.
PAGE 288
localtime(3) Guardian Native C Library Calls Reference Manual NAME localtime - Converts time since the Epoch to broken-down local time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 289
Guardian Native C Library Calls (j - m) log10(3) NAME log10 - Computes the base 10 logarithm 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 double log10( double x); PARAMETERS x Specifies a double value. DESCRIPTION The log10( ) function computes the base 10 logarithm of x.
PAGE 290
log10(3) Guardian Native C Library Calls Reference Manual The XPG4 specification leaves some features to the implementing vendor to define. The following feature is affected in the HP implementation: • 4−26 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 291
Guardian Native C Library Calls (j - m) log1p(3) NAME log1p - Computes the natural logarithm function of 1.0 plus x 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 double log1p( double x); PARAMETERS x Is the value for which the natural logarithm is to be calculated.
PAGE 292
log(3) Guardian Native C Library Calls Reference Manual NAME log - Computes the natural logarithm 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 double log( double x); PARAMETERS x Specifies a double value. DESCRIPTION The log( ) function computes the natural logarithm of x.
PAGE 293
Guardian Native C Library Calls (j - m) log(3) The XPG4 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527192-005 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 294
logb(3) Guardian Native C Library Calls Reference Manual NAME logb - Computes the radix-independent exponent as a floating-point number 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 double logb( double x); PARAMETERS x Specifies the value for which the exponent is to be calculated.
PAGE 295
Guardian Native C Library Calls (j - m) logb(3) RELATED INFORMATION Functions: fp_class(3), ilogb(3), isnan(3). STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527192-005 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 296
longjmp(3) Guardian Native C Library Calls Reference Manual NAME longjmp - Performs a nonlocal goto LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include void longjmp( jmp_buf env, int value); PARAMETERS env Specifies the address of a jmp_buf structure containing the environment to be restored.
PAGE 297
Guardian Native C Library Calls (j - m) longjmp(3) This condition might also cause unexpected process termination. If the procedure has been exited, the results are unpredictable. RETURN VALUES After the longjmp( ) function is finished, program execution continues as if the corresponding call of the setjmp( ) function had just returned the value specified by the value parameter.
PAGE 298
longlong_to_dec(3) Guardian Native C Library Calls Reference Manual NAME longlong_to_dec - Converts a C long long value to a SQL DECIMAL value and stores it in a C array of type decimal 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
PAGE 299
Guardian Native C Library Calls (j - m) longlong_to_dec(3) 2 Indicates that the ary_size parameter had an invalid value. An invalid value is less than zero or greater than 19. 3 Indicates that ll_val was negative, but sign_type was 0 (zero). (This is a request for conversion to an unsigned SQL DECIMAL value.) 4 Indicates that the sign_type parameter had an invalid value.
PAGE 300
lrand48(3) Guardian Native C Library Calls Reference Manual NAME lrand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 301
Guardian Native C Library Calls (j - m) lrand48(3) RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), mrand48(3), nrand(3), rand(3), seed48(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 302
lsearch(3) Guardian Native C Library Calls Reference Manual NAME lsearch - Performs a linear search and update LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 303
Guardian Native C Library Calls (j - m) lsearch(3) RELATED INFORMATION Functions: bsearch(3), hsearch(3), find(3), tsearch(3), qsort(3).
PAGE 304
malloc(3) Guardian Native C Library Calls Reference Manual NAME malloc - Allocates memory 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 #include void ∗ malloc( size_t size); PARAMETERS size Specifies the number of bytes of memory to be allocated.
PAGE 305
Guardian Native C Library Calls (j - m) malloc_pages(3) NAME malloc_pages - Provides a memory page allocator LIBRARY H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include #include void *malloc_pages ( size_t size ); PARAMETERS size Specifies the number of bytes of memory to be allocated.
PAGE 306
_max(3) Guardian Native C Library Calls Reference Manual NAME _max - Expands the greater of its two arguments LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include arith_type _max( arith_type expr1, arith_type expr2); PARAMETERS arith_type Specifies the type of expr1, expr2, and the return value. Any arithmetic type can be specified. However, they must all be of the same type. expr1 Is an expression.
PAGE 307
Guardian Native C Library Calls (j - m) mblen(3) NAME mblen - Determines the length in bytes of a multibyte character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int mblen ( const char *mbs, size_t n); PARAMETERS mbs Points to a multibyte character string.
PAGE 308
mblen(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: mbtowc(3), wctomb(3), mbstowcs(3), wcstombs(3).
PAGE 309
Guardian Native C Library Calls (j - m) mbstowcs(3) NAME mbstowcs - Converts a multibyte character string to a wide character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 310
mbtowc(3) Guardian Native C Library Calls Reference Manual NAME mbtowc - Converts a multibyte character to a wide character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int mbtowc ( wchar_t *pwc, const char *s, size_t n); PARAMETERS pwc Points to the wide character variable location.
PAGE 311
Guardian Native C Library Calls • (j - m) mbtowc(3) If the character encoding is not shift-state dependent, mbtowc( ) returns a value of 0 (zero). The return value is never greater than the value specified by the n parameter or the value of the MB_CUR_MAX macro. ERRORS If the following condition occurs, the mbtowc ) function sets errno to the corresponding value. [EILSEQ] The s parameter points to an invalid multibyte character or a multibyte character with more the n bytes.
PAGE 312
memccpy(3) Guardian Native C Library Calls Reference Manual NAME memccpy - Copies characters sequentially in memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void *memccpy( void *s1, void *s2, int c, size_t n); PARAMETERS s1 Points to the location of a destination string.
PAGE 313
Guardian Native C Library Calls (j - m) memchr(3) NAME memchr - Finds a character byte in memory 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 void *memchr( const void *s, int c, size_t n); PARAMETERS s Points to the location of a string. c Specifies a byte for which to search.
PAGE 314
memcmp(3) Guardian Native C Library Calls Reference Manual NAME memcmp - Compares characters in memory 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 int memcmp( const void *s1, const void *s2, size_t n); PARAMETERS s1 Points to the location of a destination string.
PAGE 315
Guardian Native C Library Calls (j - m) memcpy(3) NAME memcpy - Copies a character in memory 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 void *memcpy( void *s1, const void *s2, size_t n); PARAMETERS s1 Points to the location of a destination string.
PAGE 316
memmove(3) Guardian Native C Library Calls Reference Manual NAME memmove - Copies characters with overlapping areas in memory 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 void *memmove( void *s1, const void *s2, size_t n); PARAMETERS s1 Points to the location of a destination string.
PAGE 317
Guardian Native C Library Calls (j - m) memset(3) NAME memset - Sets characters in memory 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 void *memset( void *s, int c, size_t n); PARAMETERS s Points to the location of a string. c Specifies a byte for which c is the target of the copy.
PAGE 318
_min(3) Guardian Native C Library Calls Reference Manual NAME _min - Expands the lesser of its two arguments LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include arith_type _min( arith_type expr1, arith_type expr2); PARAMETERS arith_type Specifies the type of expr1, expr2, and the return value. Any arithmetic type can be specified, but all must be of the same type. This is an optional parameter. expr1 Is an expression.
PAGE 319
Guardian Native C Library Calls (j - m) mktime(3) NAME mktime - Converts broken-down time into time since the Epoch LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include time_t mktime( struct tm *timeptr ); PARAMETERS timeptr Points to a type tm structure that contains the broken-down time.
PAGE 320
mktime(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, the mktime( ) function returns the specified time since the Epoch as a value of type time_t. On error, or whenever the time since the Epoch cannot be represented, this function returns the value (time_t)-1 and sets errno to indicate the error. The value returned is affected by the setting of the TZ environment variable and calls to the tzset( ) function.
PAGE 321
Guardian Native C Library Calls (j - m) modf(3) NAME modf - Breaks a floating-point number into integral and fractional parts 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
PAGE 322
modf(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification with extensions when used for IEEE floating-point format data. This function conforms to 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.
PAGE 323
Guardian Native C Library Calls (j - m) mrand48(3) NAME mrand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 324
mrand48(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), nrand48(3), rand(3), seed48(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 325
Section 5. Guardian Native C Library Calls (n - r) This section contains reference pages documenting library calls with English names beginning with the letter n through the letter r that are included in the Guardian native C run-time libraries. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 326
nextafter(3) Guardian Native C Library Calls Reference Manual NAME nextafter - Computes the next representable double-precision floating-point number 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 double nextafter( double x, double y ); PARAMETERS x Is a double-precision floating-point number.
PAGE 327
Guardian Native C Library Calls (n - r) nextafter(3) ERRORS If any of the following conditions occurs, the nextafter( ) function sets errno to the corresponding value: [ERANGE] The return value would cause an overflow. RELATED INFORMATION Functions: fp_class(3). STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define.
PAGE 328
nl_langinfo(3) Guardian Native C Library Calls Reference Manual NAME nl_langinfo - Provides national language information LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *nl_langinfo( nl_item item); PARAMETERS item Specifies constant names and values.
PAGE 329
Guardian Native C Library Calls (n - r) nrand48(3) NAME nrand48 - Generates uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 330
nrand48(3) Guardian Native C Library Calls Reference Manual Guardian functions are available to convert between floating-point formats. Refer to the Guardian Programmer’s Guide for a discussion of floating-point conversions. RETURN VALUES The nrand48( ) function returns signed long integers uniformly distributed over the range $0˜<=˜y<˜2 sup 31$. RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), rand(3), seed48(3), srand48(3).
PAGE 331
Guardian Native C Library Calls (n - r) __ns_backup_fopen(3) NAME __ns_backup_fopen - Performs a backup open for a file opened in the primary process LIBRARY G-series native nonPIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS G-series native PIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS2 H-series native Guardian processes: $SYSTEM.ZDLLnnn.CRTLNSE SYNOPSIS #include
PAGE 332
__ns_backup_fopen(3) Guardian Native C Library Calls Reference Manual An error detected in the backup process is not automatically sent to the primary process. User code must handle such processing. RELATED INFORMATION Functions: __ns_fget_file_open_state(3), __ns_fget_file_state(3), __ns_fopen_special(3), __ns_fset_file_state(3), __ns_start_backup(3). STANDARDS CONFORMANCE The __ns_backup_fopen( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 333
Guardian Native C Library Calls (n - r) __ns_fget_file_open_state(3) NAME __ns_fget_file_open_state - Returns file open state information for a file opened for ANSI I/O LIBRARY G-series native nonPIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS G-series native PIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS2 H-series native Guardian processes: $SYSTEM.ZDLLnnn.CRTLNSE SYNOPSIS #include
PAGE 334
__ns_fget_file_open_state(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: __ns_backup_fopen(3), __ns_fget_file_state(3), __ns_fopen_special(3), __ns_fset_file_state(3), __ns_start_backup(3). STANDARDS CONFORMANCE The __ns_fget_file_open_state( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 335
Guardian Native C Library Calls (n - r) __ns_fget_file_state(3) NAME __ns_fget_file_state - Returns the file state information for a file opened for ANSI I/O LIBRARY G-series native nonPIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS G-series native PIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS2 H-series native Guardian processes: $SYSTEM.ZDLLnnn.CRTLNSE SYNOPSIS #include
PAGE 336
__ns_fget_file_state(3) Guardian Native C Library Calls Reference Manual — Ignore the effects of unflushed buffers, if the unflushed buffer contents are not critical to the application. — Disable buffering with the setvbuf( ) or setbuf( ) function. Refer to the Guardian Programmers Guide for complete details on active backup programming in C. RETURN VALUES Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned.
PAGE 337
Guardian Native C Library Calls (n - r) __ns_fopen_special(3) NAME __ns_fopen_special - Opens an ANSI I/O file to a specified sync depth LIBRARY G-series native nonPIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS G-series native PIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS2 H-series native Guardian processes: $SYSTEM.ZDLLnnn.CRTLNSE SYNOPSIS #include
PAGE 338
__ns_fopen_special(3) Guardian Native C Library Calls Reference Manual Access Mode Values The possible values of the string access_mode are: r Open an existing text file for read-only access. w Create a text file (or truncate an existing text file to length zero) and open it for write-only access. a Create a text file (or open an existing text file) and open it for append (write at the end of the file) access. r+ Open an existing text file for update access (reading and writing).
PAGE 339
Guardian Native C Library Calls (n - r) __ns_fopen_special(3) RELATED INFORMATION Functions: __ns_backup_fopen(3), __ns_fget_file_open_state(3), __ns_fget_file_state(3), __ns_fset_file_state(3), __ns_start_backup(3). STANDARDS CONFORMANCE The __ns_fopen_special( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 340
__ns_fset_file_state(3) Guardian Native C Library Calls Reference Manual NAME __ns_fset_file_state - Sets the file state information for a file opened for ANSI I/O LIBRARY G-series native nonPIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS G-series native PIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS2 H-series native Guardian processes: $SYSTEM.ZDLLnnn.CRTLNSE SYNOPSIS #include
PAGE 341
Guardian Native C Library Calls (n - r) __ns_fset_file_state(3) — Disable buffering with the setvbuf( ) or setnbuf( ) function. Refer to the Guardian Programmer’s Guide for complete details on active backup programming in C. RETURN VALUES Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned.
PAGE 342
__ns_start_backup(3) Guardian Native C Library Calls Reference Manual NAME __ns_start_backup - Creates a backup process for the primary process LIBRARY G-series native nonPIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS G-series native PIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS2 H-series native Guardian processes: $SYSTEM.ZDLLnnn.CRTLNSE SYNOPSIS #include
PAGE 343
Guardian Native C Library Calls (n - r) __ns_start_backup(3) DESCRIPTION The __ns_start_backup( ) function creates a backup process for the primary process. This function can be called within Guardian processes only. When used in a program compiled by the TNS compiler, this function can be called by Guardian modules (modules compiled for the Guardian environment) only. This function is called from the primary process to create and initialize the backup process.
PAGE 344
__ns_start_backup(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: __ns_backup_fopen(3), __ns_fget_file_open_state(3), __ns_fget_file_state(3), __ns_fopen_special(3), __ns_fset_file_state(3). STANDARDS CONFORMANCE The __ns_start_backup( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 345
Guardian Native C Library Calls (n - r) perror(3) NAME perror - Writes a message explaining a function error LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 346
pow(3) Guardian Native C Library Calls Reference Manual NAME pow - Computes the power 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 double pow( double x, double y ); PARAMETERS x Specifies a double value. y Specifies a double value.
PAGE 347
Guardian Native C Library Calls 527192-005 (n - r) pow(3) • If the value of y is NaN, NaN is returned. • If the value of x is 0.0 (zero) and the value of y is negative, positive or negative HUGE_VAL is returned and errno is set to [EDOM]. • If the value of x is 0.0 (zero) and the value of y is greater than 0.0 (zero), positive or negative 0.0 (zero) is returned. • If the value of x is less than 0.0 (zero) and the value of y is not an integral value, NaN is returned and errno is set to [EDOM].
PAGE 348
pow(3) Guardian Native C Library Calls Reference Manual • If the value of x is positive or negative 0.0 (zero) and the value of y is not an odd integral value but is greater than 0.0 (zero), positive 0.0 (zero) is returned. ERRORS If any of the following conditions occurs, the pow( ) function sets errno to the corresponding value: [EDOM] [ERANGE] One of the following conditions exists: • The value of x is negative and the value of y is nonintegral. • The value of x is 0.
PAGE 349
Guardian Native C Library Calls (n - r) printf(3) NAME printf - Prints formatted output to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int printf ( const char *format [, value] . . .
PAGE 350
printf(3) Guardian Native C Library Calls Reference Manual • + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero).
PAGE 351
Guardian Native C Library Calls • (n - r) printf(3) An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
PAGE 352
printf(3) 5−28 Guardian Native C Library Calls Reference Manual x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 353
Guardian Native C Library Calls (n - r) printf(3) S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 354
printf(3) Guardian Native C Library Calls Reference Manual ERRORS The printf( ) function fails if the standard output stream is unbuffered, or if the buffer needed to be flushed and the function call caused an underlying write( ) or lseek( ) function to be invoked. In addition, if the printf( ) function fails, errno is set to one of the following values: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation.
PAGE 355
Guardian Native C Library Calls (n - r) putc(3) NAME putc - Writes a byte to a specified output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putc( int c, FILE *stream); PARAMETERS c Specifies the character to be written. stream Points to the file structure of an open file.
PAGE 356
putc(3) Guardian Native C Library Calls Reference Manual ERRORS The putc( ) function fails if: • The stream parameter is not open for writing. • The output file size cannot be increased. • The stream is unbuffered • The stream’s buffer needed to be flushed and the function call caused an underlying write( ) or lseek( ) to be invoked and this underlying operation fails.
PAGE 357
Guardian Native C Library Calls (n - r) putchar(3) NAME putchar - Writes a byte to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putchar( int c); PARAMETERS c Specifies the character to be written.
PAGE 358
putchar(3) Guardian Native C Library Calls Reference Manual In addition, if any of the following conditions occur, the putchar( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing.
PAGE 359
Guardian Native C Library Calls (n - r) putenv(3) NAME putenv - Sets an environment variable 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 int putenv( const char *string); PARAMETERS string Points to a string of the form name=value.
PAGE 360
putenv(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The putenv( ) function behavior in Guardian processes is an HP extension to the XPG4 Version 2 specification.
PAGE 361
Guardian Native C Library Calls (n - r) puts(3) NAME puts - Writes a string to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int puts( const char *string); PARAMETERS string Points to a string to be written to output.
PAGE 362
puts(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient storage space available. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a nonexistent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
PAGE 363
Guardian Native C Library Calls (n - r) putw(3) NAME putw - Writes a word to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putw( int w, FILE *stream); PARAMETERS stream Points to the file structure of an open file. w Specifies the word to be written.
PAGE 364
putw(3) Guardian Native C Library Calls Reference Manual [EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size. [EINTR] The write operation was interrupted by a signal that was caught, and no data was transferred.
PAGE 365
Guardian Native C Library Calls (n - r) putwc(3) NAME putwc - Writes a wide character to a specified stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t putwc( wint_t c, FILE *stream); PARAMETERS c Specifies the wide character to be written. stream Points to the output data.
PAGE 366
putwc(3) Guardian Native C Library Calls Reference Manual [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. [EILSEQ] The wide character code specified by the c parameter does not correspond to a valid character.
PAGE 367
Guardian Native C Library Calls (n - r) putws(3) NAME putws - Writes a wide-character string to the standard output stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int putws( wchar_t *string); PARAMETERS string Points to a string to be written to output.
PAGE 368
putws(3) Guardian Native C Library Calls Reference Manual [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. RELATED INFORMATION Functions: fputws(3), gets(3), getws(3), wcstombs(3), printf(3), putc(3), puts(3), putwc(3).
PAGE 369
Guardian Native C Library Calls (n - r) qsort(3) NAME qsort - Sorts a table in place LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void qsort ( void *base, size_t nmemb, size_t size, int (*compar)(const void *, const void *) ); PARAMETERS base Points to the first entry in the table.
PAGE 370
qsort(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: bsearch(3), tsearch(3).
PAGE 371
Guardian Native C Library Calls (n - r) raise(3) NAME raise - Sends a signal to the calling process LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int raise( int signal); PARAMETERS signal Specifies a signal number.
PAGE 372
raise(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 5−48 The raise( ) function can return the errno value [ENOTOSS].
PAGE 373
Guardian Native C Library Calls (n - r) rand(3) NAME rand - Returns pseudorandom numbers 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 int rand (void); DESCRIPTION The rand( ) function returns successive pseudorandom numbers in the range from 0 (zero) to RAND_MAX.
PAGE 374
random(3) Guardian Native C Library Calls Reference Manual NAME random - Generates random numbers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include long random(void); PARAMETERS None.
PAGE 375
Guardian Native C Library Calls (n - r) realloc(3) NAME realloc - Reallocates memory 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 #include void ∗ realloc( void ∗ pointer, size_t size); PARAMETERS size Specifies the number of bytes of memory.
PAGE 376
re_comp(3) Guardian Native C Library Calls Reference Manual NAME re_comp - Compiles regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 377
Guardian Native C Library Calls (n - r) re_comp(3) Within the bracketed string, a minus sign (-) can be used to specify a range of consecutive ASCII characters. For example, [0-9] is the same as [0123456789]. If, however, the minus sign is the first character (following any initial "ˆ") or the last character within the bracketed string, it loses this special meaning.
PAGE 378
re_comp(3) Guardian Native C Library Calls Reference Manual RETURN VALUES When the re_comp( ) function successfully converts the string pointed to by the re_string parameter, it returns a null pointer. Otherwise, it returns a pointer to an error message string.
PAGE 379
Guardian Native C Library Calls (n - r) re_exec(3) NAME re_exec - Executes regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 380
re_exec(3) Guardian Native C Library Calls Reference Manual minus sign is the first character (following any initial "ˆ") or the last character within the bracketed string, it loses this special meaning. When a right square bracket is the first character (following any initial "ˆ") within a bracketed string, it has no special meaning and simply matches itself. When the ",", "*", "[", or "\" characters appear within a bracketed string, they have no special meaning and simply match themselves.
PAGE 381
Guardian Native C Library Calls (n - r) re_exec(3) ERRORS The re_exec( ) function does not return error values. RELATED INFORMATION Functions: re_comp(3), regcmp(3), regexec(3). STANDARDS CONFORMANCE The re_exec( ) function is defined in the XPG4 Version 2 specification.
PAGE 382
regcmp(3) Guardian Native C Library Calls Reference Manual NAME regcmp - Compiles regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *regcmp(const char *string1, ... /*, (char *)0 */); PARAMETERS string1, ...
PAGE 383
Guardian Native C Library Calls (n - r) regcmp(3) NOTES The behavior of this function in locales other than POSIX is undefined. This function can be called by native processes only. CAUTIONS Be sure to free space that the malloc( ) function has reserved for compiled regular expressions once it is no longer needed. If this is not done, there is a risk of running out of memory. RETURN VALUES On successful completion, the regcmp( ) function returns a pointer to the compiled regular expression.
PAGE 384
regcomp(3) Guardian Native C Library Calls Reference Manual NAME regcomp, regerror, regexec, regfree - Perform regular expression matching LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 385
Guardian Native C Library Calls (n - r) regcomp(3) subexpressions (delimited by a $ (backslash left parenthesis) and $ (backslash right parenthesis) pair in basic regular expressions, or ( ) (parentheses) in extended regular expressions) to the number found in the pattern parameter. preg The structure that contains the compiled basic or extended regular expression. errcode Identifies the error code. errbuf Points to the buffer where regerror( ) stores the message text.
PAGE 386
regcomp(3) Guardian Native C Library Calls Reference Manual of the end of the substring. Subexpression i begins at the ith matched open parenthesis, counting from 1. The 0 (zero) element of the array corresponds to the entire pattern. Unused elements of the pmatch parameter, up to the value pmatch[nmatch-1], are filled with -1.
PAGE 387
Guardian Native C Library Calls (n - r) regcomp(3) EXAMPLES 1. The following example demonstrates how the REG_NOTBOL flag can be used with the regexec( ) function to find all substrings in a line that match a pattern supplied by a user. The main( ) function in the example accepts two input strings from the user. The match( ) function in the example uses regcomp( ) and regexec( ) to search for matches. #include #include #include #include #include
PAGE 388
regcomp(3) Guardian Native C Library Calls Reference Manual if (error == REG_NOMATCH) { printf("No matches in string\n"); return; } else if (error != 0) { msize = regerror(error, &preg, message, SLENGTH); printf("%s\n", message); if (msize > SLENGTH) printf("Additional text lost\n"); return; }; count = 1; start_search = string + pmatch.rm_eo; while (error == 0) { error = regexec(&preg, start_search, 1, &pmatch, REG_NOTBOL); start_search = start_search + pmatch.
PAGE 389
Guardian Native C Library Calls (n - r) regcomp(3) matches_tocheck = preg.
PAGE 390
regcomp(3) Guardian Native C Library Calls Reference Manual REG_EBRACE The use of a pair of \{ (backslash left brace) and \} (backslash right brace) or { } (braces) is unbalanced. REG_EBRACK The use of [] (square brackets) is unbalanced. REG_ECOLLATE There is an unusable collating element referenced. REG_ECTYPE There is an unusable character class type referenced. REG_EESCAPE There is a trailing \ (backslash) in the pattern.
PAGE 391
Guardian Native C Library Calls (n - r) regerror(3) NAME regerror - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 392
regex(3) Guardian Native C Library Calls Reference Manual NAME regex - Executes regular expressions LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *regex(const char *re, const char *subject, char *se0, ...
PAGE 393
Guardian Native C Library Calls (n - r) regex(3) (...)$n Returns the value of the enclosed regular expression (subexpression). The value is stored in the location pointed to by the n+1th parameter in the se0, ... list where n is a single digit. If there are fewer than n parameters in this list, the behavior of regex( ) is undefined. A maximum of ten enclosed regular expressions are allowed. (...) Groups a regular expression.
PAGE 394
regexec(3) Guardian Native C Library Calls Reference Manual NAME regexec - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 395
Guardian Native C Library Calls (n - r) regfree(3) NAME regfree - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 396
remainder(3) Guardian Native C Library Calls Reference Manual NAME remainder - Computes the remainder of a division operation 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 double remainder( double x, double y ); PARAMETERS x Is a double-precision floating-point number.
PAGE 397
Guardian Native C Library Calls • (n - r) remainder(3) The value of the x parameter is positive or negative infinity. RELATED INFORMATION Functions: fp_class(3), isnan(3). STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527192-005 For IEEE floating-point values, this function does not set errno to [EDOM] if the value of x or y is NaN.
PAGE 398
remove(3) Guardian Native C Library Calls Reference Manual NAME remove - Removes a file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the remove( ) function: remove_oss( ) and remove_guardian( ).
PAGE 399
Guardian Native C Library Calls (n - r) remove_guardian(3) NAME remove_guardian - Removes a file (Guardian remove( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 400
remove_oss(3) Guardian Native C Library Calls Reference Manual NAME remove_oss - Removes a file (OSS remove( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 401
Guardian Native C Library Calls (n - r) remove_oss(3) NOTES If the file operated upon by the remove( ) function has multiple links, the link count in the file is decremented. If the file operated upon is a symbolic link, it is not deleted. All special files, including symbolic links, are processed as if they were directories; because a symbolic link is not a directory, the attempt to remove it (or the file it points to) fails.
PAGE 402
rewind(3) Guardian Native C Library Calls Reference Manual NAME rewind - Repositions the file pointer of a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void rewind( FILE ∗ stream); PARAMETERS stream Specifies the I/O stream.
PAGE 403
Guardian Native C Library Calls (n - r) rewind(3) RELATED INFORMATION Functions: fgetpos(3), fopen(3), fseek(3), lseek(2), fsetpos(3), ftell(3). STANDARDS CONFORMANCE The [ENXIO] errno value is not specified in the POSIX standards. It is an extension defined in the XPG4 version 2 specification.
PAGE 404
rindex(3) Guardian Native C Library Calls Reference Manual NAME rindex - Scans string for last occurrence of a character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *rindex ( const char *s, int c); PARAMETERS s Is a pointer to the string to be scanned.
PAGE 405
Guardian Native C Library Calls (n - r) rint(3) NAME rint - Rounds floating-point numbers to nearest integral value 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 double rint( double x); PARAMETERS x Is the double-precision floating-point value to be rounded.
PAGE 406
rint(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 5−82 For IEEE floating-point values, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 407
Section 6. Guardian Native C Library Calls (s) This section contains reference pages documenting library calls with English names beginning with the letter s that are included in the Guardian native C run-time libraries. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 408
scalb(3) Guardian Native C Library Calls Reference Manual NAME scalb - Computes exponent of a radix-independent floating-point number 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 double scalb( double x, double n ); PARAMETERS x Is the value to be multiplied. n Is the exponent of the radix.
PAGE 409
Guardian Native C Library Calls (s) scalb(3) STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527192-005 This function does not set errno to [EDOM] if the value of x or n is NaN.
PAGE 410
scanf(3) Guardian Native C Library Calls Reference Manual NAME scanf - Converts formatted input read from the standard input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int scanf( const char *format [, *pointer] . . . ); PARAMETERS format Specifies the format conversion.
PAGE 411
Guardian Native C Library Calls (s) scanf(3) Conversion Specifications Each conversion specification in the format parameter has the following syntax: %[digit$][*][width][sizecode]convcode • The character % (percent sign) or %digit$. The scanf( ) function can handle a format string that enables the system to process an element of the input stream for storage at a specific pointer location.
PAGE 412
scanf(3) Guardian Native C Library Calls Reference Manual c Accepts a single character or a series of characters. If there is either no width or a width of 1 in the conversion specification, one character is accepted and the corresponding pointer parameter should be a type char pointer. If there is a width greater than 1, the indicated number of characters are accepted and the corresponding pointer parameter should be an array of type char. The normal skip over white space is suppressed.
PAGE 413
Guardian Native C Library Calls (s) scanf(3) s Accepts a string of characters. The input field ends with a white-space character. If width is given, the corresponding pointer parameter refers to a character array and the indicated number of type char values are read. A string of type char values is written to the array. The array must be large enough to contain the output string with a terminating null byte appended. S Accepts a string of characters. The input field ends with a white-space character.
PAGE 414
scanf(3) Guardian Native C Library Calls Reference Manual Unless there is a match in the conversion specification, trailing white space (including a newline character) is not read. The success of literal matches and suppressed assignments cannot be directly determined. The scanf( ) function returns the number of successfully matched and assigned input items. NOTES This function supports both IEEE Std 754-1985 floating-point and Tandem floating-point values in the native environment.
PAGE 415
Guardian Native C Library Calls (s) scanf(3) The following are HP extensions to the XPG4 Version 2 specification: 527192-005 • The conversion code character L followed by a d, i, n, o, or x conversion code character indicates that the receiving variable is treated as a long long, which is a 64-bit integer data type. • The conversion specifier ll followed by a d, i, n, o, or x indicates that the argument will be treated as an unsigned long long, which is a 64-bit integer data type.
PAGE 416
seed48(3) Guardian Native C Library Calls Reference Manual NAME seed48 - Sets rule to generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 417
Guardian Native C Library Calls (s) seed48(3) RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand48(3), lcong48(3), lrand48(3), mrand48(3), nrand48(3), rand(3), srand48(3). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 418
setbuf(3) Guardian Native C Library Calls Reference Manual NAME setbuf - Assigns buffering to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void setbuf( FILE *stream, char *buffer); PARAMETERS stream Specifies the input/output stream. buffer Points to a character array.
PAGE 419
Guardian Native C Library Calls (s) setgrent(3) NAME setgrent - Resets the group name key to get group information from the group database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 420
setjmp(3) Guardian Native C Library Calls Reference Manual NAME setjmp - Saves the current execution context LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes:implicit libraries SYNOPSIS #include int setjmp( jmp_buf env); PARAMETERS env Specifies the address of the jmp_buf structure in which to save the current environment.
PAGE 421
Guardian Native C Library Calls (s) setlocale(3) NAME setlocale - Changes or queries the program’s current locale LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *setlocale( int category, const char *locale); PARAMETERS category Specifies the category of the locale to set or query.
PAGE 422
setlocale(3) Guardian Native C Library Calls Reference Manual C Specifies the minimal environment for C-language translation. If setlocale( ) is not invoked, the C locale is the default. Operational behavior within the C locale is defined separately for each interface function that is affected by the locale string. POSIX Equivalent to C. NULL Used to direct setlocale( ) to query the current internationalized environment and return the name of the locale; does not change the locale.
PAGE 423
Guardian Native C Library Calls (s) 3. setlocale(3) The following subroutine queries and saves the existing international environment, then explicitly sets the locale to the C locale, performs some operations in the C locale, and finally, restores the locale to the saved environment. The main program typically uses setlocale( ) to set the international environment to the locale specified by the user’s environment program.
PAGE 424
setlocale(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: atof(3), catopen(3), catgets(3), isalnum(3), localeconv(3), nl_langinfo(3), printf(3), scanf(3), strcat(3), strfmon(3), strftime(3), wctype(3).
PAGE 425
Guardian Native C Library Calls (s) setpwent(3) NAME setpwent - Resets the sequential key to the user database LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSECSRL G-series native OSS processes: /G/system/sysnn/zsecsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include
PAGE 426
setstate(3) Guardian Native C Library Calls Reference Manual NAME setstate - Switches hte state array used by the random number generator LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include char *setstate ( const char *state PARAMETERS state Is a pointer to a state array.
PAGE 427
Guardian Native C Library Calls (s) setvbuf(3) NAME setvbuf - Assigns buffering to a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int setvbuf( FILE *stream, char *buffer, int mode, size_t size); PARAMETERS stream Specifies the input/output stream.
PAGE 428
setvbuf(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fopen(3), fread(3), getc(3), getwc(3), malloc(3), putc(3), putwc(3), setbuf(3).
PAGE 429
Guardian Native C Library Calls (s) signal(3) NAME signal - Specifies the action to take upon delivery of a signal LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include void (*signal( int signal, void (*function)(int))) (int); PARAMETERS signal Specifies the signal. The signal names are defined in the signal.h header file.
PAGE 430
signal(3) Guardian Native C Library Calls Reference Manual returned and errno is set to [ENOTOSS]. Specifying the Signal The signal parameter specifies the signal. All signal values are valid if the corresponding action is to restore the default action. All signals can be caught or ignored except the SIGKILL, SIGSTOP, and SIGABEND signals; these signals can neither be caught nor ignored. Specifying the Function The function parameter can have the SIG_DFL or SIG_IGN value, or it can point to a function.
PAGE 431
Guardian Native C Library Calls (s) signal(3) The following are HP extensions to the XPG4 Version 2 specification: 527192-005 • HP defined several new signals, including SIGABEND. See the signal(4) reference page for a complete list. • The errno value [ENOTOSS] can be returned.
PAGE 432
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 double sin( double x); PARAMETERS x is the value for which the trigonometric sine function is to be computed.
PAGE 433
Guardian Native C Library Calls (s) 527192-005 sin(3) • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs.
PAGE 434
sinh(3) Guardian Native C Library Calls Reference Manual NAME sinh - Computes the hyperbolic 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 double sinh( double x); PARAMETERS x Is the value for which the hyperbolic sine function is to be computed.
PAGE 435
Guardian Native C Library Calls (s) sprintf(3) NAME sprintf - Stores formatted output into a character array LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int sprintf ( char *string, const char *format [, value] . . .
PAGE 436
sprintf(3) Guardian Native C Library Calls Reference Manual • • Zero or more flags that modify the meaning of the conversion specification. The flag characters and their meanings are as follows: - Left align within the field the result of the conversion. + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored.
PAGE 437
Guardian Native C Library Calls (s) sprintf(3) had not been specified. When variable ordering with the Ldigit$ format is used, the * (asterisk) specification for field width in precision is replaced by *digit$.
PAGE 438
sprintf(3) Guardian Native C Library Calls Reference Manual not implied. 6−32 x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 439
Guardian Native C Library Calls (s) sprintf(3) S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 440
sprintf(3) Guardian Native C Library Calls Reference Manual ERRORS None. The sprintf( ) function does not set errno. RELATED INFORMATION Functions: fp_class(3), fprintf(3), isnan(3), toascii(3), putc(3), printf(3), scanf(3). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 6−34 The conversion specifier L followed by a d, i, n, o, or x indicates that the argument will be treated as a long long, which is a 64-bit integer data type.
PAGE 441
Guardian Native C Library Calls (s) sqrt(3) NAME sqrt - Computes the square root of a floating-point number 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 double sqrt( double x); PARAMETERS x Is the value whose square root is to be computed.
PAGE 442
sqrt(3) Guardian Native C Library Calls Reference Manual This function supports the special rounding modes of the IEEE floating-point standard. Guardian declarations and procedures can be used to access the floating-point status and control register to set and clear the special rounding modes. Refer to the Guardian Programmer’s Guide for information about those declarations and procedures.
PAGE 443
Guardian Native C Library Calls (s) srand(3) NAME srand - Generates pseudorandom numbers 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 void srand( unsigned int seed); PARAMETERS seed Specifies an initial seed value.
PAGE 444
srand48(3) Guardian Native C Library Calls Reference Manual NAME srand48 - Sets rule to generate uniformly distributed pseudorandom number sequences LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 445
Guardian Native C Library Calls (s) srand48(3) STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 446
srandom(3) Guardian Native C Library Calls Reference Manual NAME srandom - Generates random numbers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include void srandom ( unsigned int seed); PARAMETERS seed Is an unsigned int used to initialize a state array.
PAGE 447
Guardian Native C Library Calls (s) sscanf(3) NAME sscanf - Converts formatted input read from a character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int sscanf( const char *string, const char *format [, *pointer] . . .
PAGE 448
sscanf(3) Guardian Native C Library Calls Reference Manual • Invalid character—if the input string contains a character that is not allowed, this invalid character delimits the field and is considered the first character of the next field. • Maximum width—if the conversion specification includes a maximum width and the field is not terminated by white space or an invalid character, then when that maximum width is reached in the input string, the field is terminated.
PAGE 449
Guardian Native C Library Calls (s) • sscanf(3) A conversion code character convcode that specifies the type of conversion to be applied: % Accepts a single % (percent sign) input at this point; no assignment is done. c Accepts a single character or a series of characters. If there is either no width or a width of 1 in the conversion specification, one character is accepted and the corresponding pointer parameter should be a type char pointer.
PAGE 450
sscanf(3) Guardian Native C Library Calls Reference Manual o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer. p Matches an unsigned hexadecimal integer, the same as the %p conversion of the printf( ) function. The corresponding pointer parameter must be a pointer to a pointer to void. s Accepts a string of characters. The input field ends with a white-space character.
PAGE 451
Guardian Native C Library Calls (s) sscanf(3) The conversion code convcode indicates how to interpret the input field. The corresponding pointer must usually be of a restricted type. You should not specify the pointer parameter for a suppressed field. sscanf( ) processing ends either at the end of the input string, the end of the conversion specifications, or when an input character conflicts with the conversion specifications.
PAGE 452
sscanf(3) Guardian Native C Library Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: • 6−46 The conversion specifier L followed by a d, i, n, o, or x indicates that the receiving variable is treated as a long long, which is a 64-bit integer data type.
PAGE 453
Guardian Native C Library Calls (s) strcasecmp(3) NAME strcasecmp - Compare two strings, ignoring case LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int strcasecmp( const char *s1, const char *s2); PARAMETERS s1 Is a pointer to the first string to be compared.
PAGE 454
strcat(3) Guardian Native C Library Calls Reference Manual NAME strcat - Appends a string to a string 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 char *strcat( char *s1, const char *s2); PARAMETERS s1 Specifies the destination string for appending.
PAGE 455
Guardian Native C Library Calls (s) strchr(3) NAME strchr - Finds an integer character in string 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/sysnn/zcredll SYNOPSIS #include char *strchr( const char *s, int c); PARAMETERS s Specifies the string to search.
PAGE 456
strcmp(3) Guardian Native C Library Calls Reference Manual NAME strcmp - Compares strings 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 int strcmp( const char *s1, const char *s2); PARAMETERS s1 Specifies the first of two strings to compare.
PAGE 457
Guardian Native C Library Calls (s) strcoll(3) NAME strcoll - Compares strings using locale collation LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int strcoll( const char *s1, const char *s2); PARAMETERS s1 Specifies first string to be compared.
PAGE 458
strcpy(3) Guardian Native C Library Calls Reference Manual NAME strcpy - Copies strings 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 char *strcpy( char *s1, const char *s2); PARAMETERS s1 Specifies the destination string for the copying. s2 Specifies the source string for the copying.
PAGE 459
Guardian Native C Library Calls (s) strcspn(3) NAME strcspn - Returns length of initial segment of string 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 size_t strcspn( const char *s1, const char *s2); PARAMETERS s1 Points to a character string being checked for an initial segment.
PAGE 460
strdup(3) Guardian Native C Library Calls Reference Manual NAME strdup - Duplicates a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *strdup( const char s1); PARAMETERS s1 Points to the string to be duplicated.
PAGE 461
Guardian Native C Library Calls (s) strerror(3) NAME strerror - Accesses message explaining function error LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include char *strerror( int errnum); PARAMETERS errnum Specifies an error-number value.
PAGE 462
strfmon(3) Guardian Native C Library Calls Reference Manual NAME strfmon - Formats monetary strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS include #include ssize_t strfmon( char *s, size_t maxsize, char *format [,double value] . . .
PAGE 463
Guardian Native C Library Calls (s) strfmon(3) flag is ignored unless a left precision is specified. ^ The ˆ (circumflex) flag suppresses grouping digits when formatting the currency amount. The default is to group the digits and separate them with the grouping characters if defined for the current locale. + The + (plus) character specifies that the locale’s equivalent of + and - are used to indicate positive and negative values.
PAGE 464
strfmon(3) Guardian Native C Library Calls Reference Manual The following table lists the default values used by the strfmon( ) function when there are no values defined in the locale for these members of the lconv structure. These are the defaults for the C locale. For all other lconv members, such as mon_thousands_sep, there are no defaults. Table 6−1.
PAGE 465
Guardian Native C Library Calls (s) strfmon(3) converted, including the character that caused the overflow. The infbuf parameter points to the first byte of the characters left to covert. RELATED INFORMATION Functions: localeconv(3), scanf(3), strftime(3).
PAGE 466
strftime(3) Guardian Native C Library Calls Reference Manual NAME strftime - Converts a date and time to a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 467
Guardian Native C Library Calls (s) strftime(3) The format parameter has the following syntax: [ordinary-text] [%[[-|0]width] [.precision] format-code [ordinary-text]]... ordinary-text Text that is copied to the output parameter with no changes. width A decimal digit string that specifies the minimum field width. If the width of the item equals or exceeds the minimum field width, the minimum is ignored.
PAGE 468
strftime(3) 6−62 Guardian Native C Library Calls Reference Manual D The format is fixed to return %m/%d/%y. (For example, 20 Jun 1990 will return 06/20/90.) e The day of the month is output as a number between 1 and 31 in a 2-digit field with leading space fill. Ec Specifies the locale’s alternate appropriate date and time representation. EC Specifies the name of the base year (period) in the locale’s alternate representation. Ex Specifies the locale’s alternate date representation.
PAGE 469
Guardian Native C Library Calls (s) 527192-005 strftime(3) OS Specifies the seconds using the locale’s alternate numeric symbols. OU Specifies the week number of the year (Sunday as the first day of the week) using the locale’s alternate numeric symbols. OV Specifies the week number of the year (Monday as the first day of the week) using the locale’s alternate numeric symbols. Ow Specifies the weekday as a number in the locale’s alternate representation (Sunday = 0).
PAGE 470
strftime(3) Guardian Native C Library Calls Reference Manual x The short date is output in the format specified for the current locale. X The time is output in the format specified for the current locale. y The year is output as a number (without the century) between 00 and 99. Y The year is output as a number (with the century) between 0000 and 9999. Z The (standard time or daylight saving time) time-zone name is output as a string from the environment variable TZ (CDT, for example).
PAGE 471
Guardian Native C Library Calls (s) strftime(3) RETURN VALUES The strftime( ) function returns the number of bytes written into the array pointed to by the s parameter when the total number of resulting bytes, including the terminating null character, is not more than the value of the maxsize parameter. The returned value does not count the terminating null byte in the number of bytes written into the array.
PAGE 472
strlen(3) Guardian Native C Library Calls Reference Manual NAME strlen - Finds length of string 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 size_t strlen( const char *s); PARAMETERS s Specifies the string.
PAGE 473
Guardian Native C Library Calls (s) strncasecmp(3) NAME strncasecmp - Compares two strings, ignoring case LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZSTFNSRL G-series native OSS processes: /G/system/sysnn/zstfnsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL H-series OSS processes: /G/system/zdllnnn/zcredll SYNOPSIS #include int strncasecmp(const char *s1, const char *s2, size_t n); PARAMETERS s1 Is a pointer to the first string to be compared.
PAGE 474
strncat(3) Guardian Native C Library Calls Reference Manual NAME strncat - Appends bytes to a string 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 char *strncat( char *s1, const char *s2, size_t n); PARAMETERS s1 Points to a location containing first string.
PAGE 475
Guardian Native C Library Calls (s) strncmp(3) NAME strncmp - Compares two strings 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 int strncmp( const char *s1, const char *s2, size_t n); PARAMETERS s1 Points to a location containing first string.
PAGE 476
strncpy(3) Guardian Native C Library Calls Reference Manual NAME strncpy - Copies a string 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 char *strncpy( char *s1, const char *s2, size_t n); PARAMETERS s1 Points to a location containing first string.
PAGE 477
Guardian Native C Library Calls (s) strpbrk(3) NAME strpbrk - Finds one of a set of bytes in a string 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 char *strpbrk( const char *s1, const char *s2); PARAMETERS s1 Specifies a string being searched. s2 Specifies a set of bytes in a string.
PAGE 478
strptime(3) Guardian Native C Library Calls Reference Manual NAME strptime - Converts a character string to a time value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 479
Guardian Native C Library Calls (s) strptime(3) c Inputs the date and time, using the locale’s default format. C Inputs the century as a decimal number in the range from 00 to 99. d Inputs the day of the month as a decimal number in the range from 01 to 31. D Inputs the date as %m %d %y. e Same as d. E Inputs the year, using the locale-dependent Emperor/Era name and year format. h Same as b. H Inputs the hour based on a 24-hour clock as a decimal number in the range from 00 to 23.
PAGE 480
strptime(3) Guardian Native C Library Calls Reference Manual Y Inputs the year, including the century (for example, 1991). Z Inputs the time-zone name. % Inputs a % (percent sign) character. Alternative-format Directives The E and O characters can be used with some of the directives to stipulate that an alternative format be used, if available. If the alternative format is not available in the locale, the modifier will be ignored, and the unmodified behavior for that directive will be followed.
PAGE 481
Guardian Native C Library Calls (s) strptime(3) RETURN VALUES Upon successful completition, the strptime( ) function returns a pointer to the character following the last character parsed. Otherwise, a null pointer is returned. RELATED INFORMATION Functions: scanf(3), strfmon(3), strftime(3), time(3).
PAGE 482
strrchr(3) Guardian Native C Library Calls Reference Manual NAME strrchr - Searches for character in string 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 char *strrchr( const char *s, int c); PARAMETERS s Specifies the string to search.
PAGE 483
Guardian Native C Library Calls (s) strspn(3) NAME strspn - Returns length of initial segment of string 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 size_t strspn( const char *s1, const char *s2); PARAMETERS s1 Points to a character string being checked for an initial segment.
PAGE 484
strstr(3) Guardian Native C Library Calls Reference Manual NAME strstr - Finds a substring 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 char *strstr( const char *s1, const char *s2); PARAMETERS s1 Specifies the character string being searched. s2 Specifies the substring to be located.
PAGE 485
Guardian Native C Library Calls (s) strtod(3) NAME strtod - Converts a character string to a double-precision floating-point value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 486
strtod(3) Guardian Native C Library Calls Reference Manual NOTES In the TNS environment, the strtod( ) function supports only the C/POSIX locale. In the native environment, all locales are supported. 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.
PAGE 487
Guardian Native C Library Calls (s) strtok(3) NAME strtok - Splits string into tokens 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 char *strtok( char *s1, const char *s2); PARAMETERS s1 Contains a pointer to the string to be searched.
PAGE 488
strtok(3) Guardian Native C Library Calls Reference Manual EXAMPLES The following example demonstrates how to split a string into tokens. #include #include #include
PAGE 489
Guardian Native C Library Calls (s) strtol(3) NAME strtol - Converts a character string to a signed long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include long int strtol ( const char *nptr, char **endptr, int base); PARAMETERS nptr Points to the character string to convert.
PAGE 490
strtol(3) Guardian Native C Library Calls Reference Manual converted: Character 0 1 2 3 4 5 6 7 8 9 A a Value B b C c D d E e F f G H g h I i J j 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 491
Guardian Native C Library Calls (s) strtol(3) RETURN VALUES The strtol( ) function returns the converted value of long integer if the expected form is found. If no conversion could be performed, a value of 0 (zero) is returned. If the converted value is outside the range of representable values, LONG_MAX or LONG_MIN is returned (according to the sign of the value).
PAGE 492
strtoll(3) Guardian Native C Library Calls Reference Manual NAME strtoll - Converts a character string to a signed long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 493
Guardian Native C Library Calls (s) strtoll(3) converted: Character 0 1 2 3 4 5 6 7 8 9 A a Value B b C c D d E e F G f g H h I i J j 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 494
strtoll(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The behavior of this function conforms to the Single UNIX Specification, Version 3 and the 1999 ANSI C standard.
PAGE 495
Guardian Native C Library Calls (s) strtoul(3) NAME strtoul - Converts a character string to an unsigned long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 496
strtoul(3) Guardian Native C Library Calls Reference Manual converted: Character 0 1 2 3 4 5 6 7 8 9 A a Value B b C c D d E e F G f g H h I i J j 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 497
Guardian Native C Library Calls (s) strtoul(3) STANDARDS CONFORMANCE The behavior of this function conforms to the Single UNIX Specification, Version 3 and the 1999 ANSI C standard.
PAGE 498
strtoull(3) Guardian Native C Library Calls Reference Manual NAME strtoull - Converts a string to an unsigned long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 499
Guardian Native C Library Calls (s) • strtoull(3) If the value of base is 16, the characters 0x or 0X precede the sequence of letters and digits, following the sign if present. The subject sequence is the longest initial subsequence of the input string, starting with the first non-white-space character, that is of the expected form.
PAGE 500
strxfrm(3) Guardian Native C Library Calls Reference Manual NAME strxfrm - Transforms string for collation in current locale LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include size_t strxfrm( char *s1, const char *s2, size_t n); PARAMETERS s1 Specifies the destination string.
PAGE 501
Guardian Native C Library Calls (s) strxfrm(3) RELATED INFORMATION Functions: setlocale(3), strcoll(3), strcmp(3), wcsxfrm(3).
PAGE 502
sysconf(3) Guardian Native C Library Calls Reference Manual NAME sysconf - Gets configurable system variables LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include long int sysconf( int name); PARAMETERS name Specifies the system variable to be queried.
PAGE 503
Guardian Native C Library Calls (s) sysconf(3) COLL_WEIGHTS_MAX Is the maximum number of weights that can be assigned to an entry in the LC_COLLATE locale-dependent information in a locale-definition file. Value of name: _SC_COLL_WEIGHTS_MAX EXPR_NEST_MAX Is the maximum number of expressions that can be nested within parentheses by the expr command.
PAGE 504
sysconf(3) Guardian Native C Library Calls Reference Manual _POSIX2_C_BIND Has the value 1 if the system supports the C language binding option from POSIX.2; otherwise, it has the value -1. Value of name: _SC_2_C_BIND _POSIX2_C_DEV Has the value 1 if the system supports the optional C Language Development Utilities from POSIX.2; otherwise, it has the value -1. Value of name: _SC_2_C_DEV _POSIX2_C_VERSION Is a value indicating the version of the POSIX.
PAGE 505
Guardian Native C Library Calls (s) sysconf(3) _POSIX2_VERSION Is the date of approval of the most current version of the POSIX.2 standard that the system supports. The date is a 6-digit number, with the first 4 digits signifying the year and the last 2 digits the month. Different versions of the POSIX.2 standard are periodically approved by the IEEE Standards Board, and the date of approval is used to distinguish between different versions.
PAGE 506
sysconf(3) Guardian Native C Library Calls Reference Manual _POSIX2_CHAR_TERM _POSIX2_LOCALEDEF _POSIX2_UPE _POSIX2_VERSION This variable is not available at compile time. Value of name: _SC_XOPEN_XCU_VERSION Use From the Guardian Environment The sysconf( ) function can be used by a Guardian process when the process has been compiled using the #define _XOPEN_SOURCE_EXTENDED 1 feature-test macro or an equivalent compiler command option.
PAGE 507
Guardian Native C Library Calls (s) system(3) NAME system - Executes an OSS shell command or TACL command LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int system( const char ∗ command); PARAMETERS command Specifies a valid sh OSS shell or TACL command.
PAGE 508
system(3) Guardian Native C Library Calls Reference Manual • If command is not a null pointer, upon successful completion, the system( ) function returns the exit status of the executed command in the format specified by the waitpid( ) function (see the wait(2) reference page). If the function fails, such as when the child process cannot be created or if the shell’s exit status cannot be obtained, the system( ) function returns a value of -1 and sets errno to indicate the error.
PAGE 509
Section 7. Guardian Native C Library Calls (t - z) This section contains reference pages documenting library calls with English names beginning with the letter t through the letter z that are included in the Guardian native C run-time libraries. The reference pages are arranged in alphabetical order (U.S. English).
PAGE 510
tan(3) Guardian Native C Library Calls Reference Manual NAME tan - Computes the trigonometric tangent 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 double tan( double x); PARAMETERS x Is the value for which the trigonometric tangent function is to be computed.
PAGE 511
Guardian Native C Library Calls (t - z) tan(3) The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: 527192-005 • For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN. • errno is not set to [ERANGE] when underflow occurs. • The tan( ) function cannot cause overflow so HUGE_VAL is not returned and errno is not set to [ERANGE].
PAGE 512
tanh(3) Guardian Native C Library Calls Reference Manual NAME tanh - Computes the hyperbolic tangent 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 double tanh( double x); PARAMETERS x Is the value for which the hyperbolic tangent function is to be computed.
PAGE 513
Guardian Native C Library Calls (t - z) tdelete(3) NAME tdelete - Deletes a node from a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 514
terminate_program(3) Guardian Native C Library Calls Reference Manual NAME terminate_program - Terminates a process 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
PAGE 515
Guardian Native C Library Calls (t - z) terminate_program(3) For active backup process pairs, if the primary process calls terminate_program( ) and specifies normal termination (the option value is zero), both the primary and backup processes terminate. To ensure that all cleanup operations that the C library needs to perform are done, do not call the Guardian system procedures STOP, ABEND, or PROCESS_STOP_ directly to terminate your program.
PAGE 516
tfind(3) Guardian Native C Library Calls Reference Manual NAME tfind - Finds a node in a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 517
Guardian Native C Library Calls (t - z) time(3) NAME time - Gets time LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include time_t time ( time_t *tloc); PARAMETERS tloc Points to the location where the return value is stored. When this parameter is a null pointer, no value is stored.
PAGE 518
times(3) Guardian Native C Library Calls Reference Manual NAME times - Gets process and child process times LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include clock_t times( struct tms *buffer); PARAMETERS buffer Points to a type tms structure where system time information is to be stored.
PAGE 519
Guardian Native C Library Calls (t - z) times(3) clock_t tms_cutime User time, children. The sum of the tms_utime and tms_cutime times of the terminated child processes. clock_t tms_cstime System time, children. The sum of the tms_stime and tms_cstime times of the terminated child processes. Use From the Guardian Environment A Guardian process can call times( ) with the following restrictions: • Child times are not maintained. • All processor time is accumulated as user time.
PAGE 520
tmpfile(3) Guardian Native C Library Calls Reference Manual NAME tmpfile - Creates a temporary file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the tmpfile( ) function: tmpfile_oss( ) and tmpfile_guardian( ).
PAGE 521
Guardian Native C Library Calls (t - z) tmpfile_guardian(3) NAME tmpfile_guardian - Creates a temporary file (Guardian tmpfile( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 522
tmpfile_guardian(3) Guardian Native C Library Calls Reference Manual [ENFILE] Too many files are currently open in the processor. [ENOMEM] Insufficient storage space is available. RELATED INFORMATION Functions: fopen(3), tmpfile(3), tmpfile_oss(3), tmpnam(3), unlink(2). STANDARDS CONFORMANCE The tmpfile_guardian( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 523
Guardian Native C Library Calls (t - z) tmpfile_oss(3) NAME tmpfile_oss - Creates a temporary file (OSS tmpfile( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 524
tmpfile_oss(3) Guardian Native C Library Calls Reference Manual [ENFILE] Too many files are currently open in the processor. [ENOMEM] Insufficient storage space is available. [ENOSPC] The directory or file system that would contain the new file cannot be expanded. RELATED INFORMATION Functions: fopen(3), tmpfile(3), tmpfile_guardian, tmpnam(3), unlink(2). STANDARDS CONFORMANCE The tmpfile_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 525
Guardian Native C Library Calls (t - z) tmpnam(3) NAME tmpnam - Constructs the name for a temporary file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll DESCRIPTION The C run-time library supports two variants of the tmpnam( ) function: tmpnam_oss( ) and tmpnam_guardian( ).
PAGE 526
tmpnam_guardian(3) Guardian Native C Library Calls Reference Manual NAME tmpnam_guardian - Constructs the name for a temporary file (Guardian tmpnam( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 527
Guardian Native C Library Calls (t - z) tmpnam_guardian(3) If the s parameter is not a null pointer, it is assumed to be the address of an array of at least the number of bytes specified by L_tmpnam. L_tmpnam is a constant defined in the stdio.h header file. The tmpnam( ) function places its results into that array and returns the value of the s parameter. RELATED INFORMATION Functions: fopen(3), free(3), malloc(3), tempnam(3), tmpfile(3), tmpnam(3), tmpnam_oss(3).
PAGE 528
tmpnam_oss(3) Guardian Native C Library Calls Reference Manual NAME tmpnam_oss - Constructs the name for a temporary file (OSS tmpnam( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 529
Guardian Native C Library Calls (t - z) tmpnam_oss(3) To use the tmpnam_oss( ) or tmpnam_guardian( ) functions, specify the _TANDEM_SOURCE feature test macro. RETURN VALUES If the s parameter is a null pointer, the tmpnam( ) function places its result into an internal static area and returns a pointer to that area. The next call to this function might modify the contents of the area.
PAGE 530
toascii(3) Guardian Native C Library Calls Reference Manual NAME toascii - Translates integer to 7-bit ASCII character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int toascii ( int c); PARAMETERS c Specifies the integer to be converted.
PAGE 531
Guardian Native C Library Calls (t - z) _tolower(3) NAME _tolower - Translates uppercase characters to lowercase characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int _tolower ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 532
tolower(3) Guardian Native C Library Calls Reference Manual NAME tolower - Translates uppercase characters to lowercase LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int tolower ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 533
Guardian Native C Library Calls (t - z) _toupper(3) NAME _toupper - Translates lowercase characters to uppercase characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int _toupper ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 534
toupper(3) Guardian Native C Library Calls Reference Manual NAME toupper - Translates lowercase characters to uppercase characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int toupper ( int c); PARAMETERS c Specifies the character to be converted.
PAGE 535
Guardian Native C Library Calls (t - z) towlower(3) NAME towlower - Translate uppercase to lowercase wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t towlower ( wint_t wc); PARAMETER wc Specifies the wide character to convert.
PAGE 536
towupper(3) Guardian Native C Library Calls Reference Manual NAME towupper - Translates lowercase to uppercase wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t towupper ( wint_t wc); PARAMETER wc Specifies the wide character to convert.
PAGE 537
Guardian Native C Library Calls (t - z) tsearch(3) NAME tsearch - Builds and searches a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 538
tsearch(3) Guardian Native C Library Calls Reference Manual RETURN VALUES If a node is found, the tsearch( ) function inserts the entry and returns a pointer to the newly inserted entry. The tsearch( ) function returns a null pointer when there is not enough space available to create a new node. The tsearch( ) function also returns a null pointer if rootp is a null pointer on entry. RELATED INFORMATION Functions: bsearch(3), hsearch(3), lsearch(3), tfind(3), tdelete(3), twalk(3), qsort(3).
PAGE 539
Guardian Native C Library Calls (t - z) twalk(3) NAME twalk - Traverses a binary search tree LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include void twalk( const void *root, void (*action) (const void *, VISIT, int) ); PARAMETERS root Points to the root of the binary tree to be walked.
PAGE 540
tzset(3) Guardian Native C Library Calls Reference Manual NAME tzset - Converts time units LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 541
Guardian Native C Library Calls (t - z) tzset(3) External variable daylight is set to nonzero when a daylight-saving time conversion should be applied. By default, this conversion follows standard U.S. time conventions; other time conventions may be specified. The default conversion algorithm adjusts for peculiarities of U.S. daylight-saving time in 1974 and 1975. RETURN VALUES The tzset( ) function returns no value. ERRORS The tzset( ) function returns no errors. This function does not set errno.
PAGE 542
ungetc(3) Guardian Native C Library Calls Reference Manual NAME ungetc - Pushes a character back into the input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int ungetc( int c, FILE *stream); PARAMETERS c Specifies a byte to be inserted into the input stream.
PAGE 543
Guardian Native C Library Calls (t - z) ungetwc(3) NAME ungetwc - Pushes a wide character back into the input stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t ungetwc( wint_t wchar, FILE *stream); PARAMETERS c Specifies a byte to be inserted into the input stream.
PAGE 544
unordered(3) Guardian Native C Library Calls Reference Manual NAME unordered - Tests whether one value is unordered relative to another value 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
PAGE 545
Guardian Native C Library Calls (t - z) va_arg(3) NAME va_arg - Returns a parameter from a variable-length parameter list LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include type va_arg( va_list ap, type); PARAMETERS ap This parameter is used to extract parameters from the parameter list. type A type name, expressed so that a pointer to an object of this type can be generated by appending an * (asterisk).
PAGE 546
va_end(3) Guardian Native C Library Calls Reference Manual NAME va_end - Ends processing for a variable-length parameter list LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void va_end( va_list ap); PARAMETERS ap This parameter is used to extract parameters from the parameter list. DESCRIPTION The stdarg macros allow you to write portable functions that accept a variable number of parameters.
PAGE 547
Guardian Native C Library Calls (t - z) valloc(3) NAME valloc - Provide a memory allocator 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 #include void *valloc( size_t size); PARAMETERS size Specifies the number of bytes of memory to be allocated.
PAGE 548
va_start(3) Guardian Native C Library Calls Reference Manual NAME va_start - Initializes processing for a variable-length parameter list LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void va_start( va_list ap, parmn); PARAMETERS ap This parameter is used to extract parameters from the parameter list. parmn The identifier of the rightmost named parameter in the function declaration for the function that has a variable-length parameter list.
PAGE 549
Guardian Native C Library Calls (t - z) va_start(3) RELATED INFORMATION Functions: va_arg(3), va_end(3), vfprintf(3).
PAGE 550
vfprintf(3) Guardian Native C Library Calls Reference Manual NAME vfprintf - Formats a variable number of parameters for output LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 551
Guardian Native C Library Calls • (t - z) vfprintf(3) - Left align within the field the result of the conversion. + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero).
PAGE 552
vfprintf(3) Guardian Native C Library Calls Reference Manual • An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
PAGE 553
Guardian Native C Library Calls 527192-005 (t - z) vfprintf(3) x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
PAGE 554
vfprintf(3) Guardian Native C Library Calls Reference Manual S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, then no more than the number of bytes specified by the precision are printed.
PAGE 555
Guardian Native C Library Calls void { (t - z) vfprintf(3) error(char *funct, char *fmt, ...) va_list args; /* ** Display the name of the function that called error */ fprintf(stderr, "ERROR in %s: ", funct); /* ** Display the remainder of the message */ va_start(args, fmt); vfprintf(stderr, fmt, args); va_end(args); abort(); } RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned.
PAGE 556
vfprintf(3) [EPIPE] Guardian Native C Library Calls Reference Manual An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. RELATED INFORMATION Functions: fprintf(3), printf(3), sprintf(3), vprintf(3), vsprintf(3).
PAGE 557
Guardian Native C Library Calls (t - z) vprintf(3) NAME vprintf - Formats a variable number of parameters for output LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 558
vprintf(3) Guardian Native C Library Calls Reference Manual [EINVAL] There are insufficient arguments. [EIO] The implementation supports job control; the process is a member of a background process group attempting to write to its controlling terminal; TOSTOP is set; the process is neither ignoring nor blocking SIGTTOU; and the process group of the process is orphaned. This error might also be returned under implementation-defined conditions. [ENOMEM] Insufficient storage space was available.
PAGE 559
Guardian Native C Library Calls (t - z) vsprintf(3) NAME vsprintf - Formats a variable number of parameters for output to a buffer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include #include
PAGE 560
wcscat(3) Guardian Native C Library Calls Reference Manual NAME wcscat - Appends one wide-character string to another LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 561
Guardian Native C Library Calls (t - z) wcschr(3) NAME wcschr - Searches for the first instance of a character in a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 562
wcscmp(3) Guardian Native C Library Calls Reference Manual NAME wcscmp - Compares wide-character strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 563
Guardian Native C Library Calls (t - z) wcscpy(3) NAME wcscpy - Copies one wide-character string into another LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 564
wcscspn(3) Guardian Native C Library Calls Reference Manual NAME wcscspn - Returns the length of the initial segment of a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 565
Guardian Native C Library Calls (t - z) wcsftime(3) NAME wcsftime - Converts a date and time to a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 566
wcsftime(3) width precision Guardian Native C Library Calls Reference Manual A decimal digit string that specifies the minimum field width. If the width of the item equals or exceeds the minimum field width, the minimum is ignored. If the width of the item is less than the minimum field width, the function justifies and pads the item.
PAGE 567
Guardian Native C Library Calls 527192-005 (t - z) wcsftime(3) Ec Specifies the locale’s alternate appropriate date and time representation. EC Specifies the name of the base year (period) in the locale’s alternate representation. Ex Specifies the locale’s alternate date representation. EX Specifies the locale’s alternate time representation. Ey Specifies the offset from %EC (year only) in the locale’s alternate representation. EY Specifies the full alternate year representation.
PAGE 568
wcsftime(3) 7−60 Guardian Native C Library Calls Reference Manual OV Specifies the week number of the year (Monday as the first day of the week) using the locale’s alternate numeric symbols. Ow Specifies the weekday as a number in the locale’s alternate representation (Sunday = 0). OW Specifies the week number of the year (Monday as the first day of the week) using the locale’s alternate numeric symbols. Oy Specifies the year (offset from %C) in alternate representation.
PAGE 569
Guardian Native C Library Calls (t - z) wcsftime(3) y The year is output as a number (without the century) between 00 and 99. Y The year is output as a number (with the century) between 0000 and 9999. Z The (standard time or daylight saving time) time-zone name is output as a string from the environment variable TZ (CDT, for example). If no time-zone information exists, no characters are output. % The % (percent) character is output.
PAGE 570
wcsncat(3) Guardian Native C Library Calls Reference Manual NAME wcsncat - Appends wide-character strings with a character count LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 571
Guardian Native C Library Calls (t - z) wcsncmp(3) NAME wcsncmp - Compares wide-character strings with a character count LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 572
wcsncpy(3) Guardian Native C Library Calls Reference Manual NAME wcsncpy - Copies wide-character strings with a character count LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 573
Guardian Native C Library Calls (t - z) wcspbrk(3) NAME wcspbrk - Locates the first occurrence of characters in a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wchar_t *wcspbrk( const wchar_t *wcs1, const wchar_t *wcs2); PARAMETERS wcs1 Pointer to a string that is being searched.
PAGE 574
wcsrchr(3) Guardian Native C Library Calls Reference Manual NAME wcsrchr - Searches for the final instance of a character in a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 575
Guardian Native C Library Calls (t - z) wcsspn(3) NAME wcsspn - Returns the length of the initial segment of a string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 576
wcstod(3) Guardian Native C Library Calls Reference Manual NAME wcstod - Converts a wide-character string to a double-precision floating-point value LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 577
Guardian Native C Library Calls (t - z) wcstod(3) begins with a - (minus sign), the conversion value is negated. The radix character is determined by the LC_NUMERIC category in the program’s current locale. In the C locale, or in a locale where the radix character is not defined, the radix character defaults to a . (dot).
PAGE 578
wcstok(3) Guardian Native C Library Calls Reference Manual NAME wcstok - Splits wide-character strings into tokens LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 579
Guardian Native C Library Calls (t - z) wcstok(3) character strings, from call to call. The implementation behaves as though no function calls the wcstok( ) function. EXAMPLES The following example shows how to split a wide-character string into tokens. #include #include #include
PAGE 580
wcstol(3) Guardian Native C Library Calls Reference Manual NAME wcstol - Converts a wide-character string to long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 581
Guardian Native C Library Calls (t - z) wcstol(3) Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 582
wcstol(3) Guardian Native C Library Calls Reference Manual RETURN VALUES The wcstol( ) function returns the converted value of long integer if the expected form is found. If no conversion could be performed, a value of 0 (zero) is returned. If the converted value is outside the range of representable values, LONG_MAX or LONG_MIN is returned (according to the sign of the value).
PAGE 583
Guardian Native C Library Calls (t - z) wcstoll(3) NAME wcstoll - Converts a wide-character string to a long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 584
wcstoll(3) Guardian Native C Library Calls Reference Manual Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value.
PAGE 585
Guardian Native C Library Calls (t - z) wcstombs(3) NAME wcstombs - Converts a wide character string into a multibyte character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 586
wcstombs(3) Guardian Native C Library Calls Reference Manual RETURN VALUES If the wcstombs( ) function does not encounter an invalid wide-character code, it returns the number of bytes stored, not including the terminating null byte. When the wcstombs( ) function encounters a wide character code that does not correspond to a valid multibyte character, it returns a value of -1 cast to size_t and sets errno to indicate the error.
PAGE 587
Guardian Native C Library Calls (t - z) wcstoul(3) NAME wcstoul - Converts wide-character strings to an unsigned long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 588
wcstoul(3) Guardian Native C Library Calls Reference Manual Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value cast to unsigned integer.
PAGE 589
Guardian Native C Library Calls (t - z) wcstoul(3) RETURN VALUES The wcstoul( ) function returns the converted value of the unsigned long integer if the expected form is found. If no conversion could be performed, a value of 0 (zero) is returned. If the converted value is outside the range of representable values, ULONG_MAX is returned.
PAGE 590
wcstoull(3) Guardian Native C Library Calls Reference Manual NAME wcstoull - Converts wide-character strings to an unsigned long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 591
Guardian Native C Library Calls (t - z) wcstoull(3) Character 0 1 2 3 4 5 6 7 8 9 Value 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 A a B b C c D d E e F f G g H h I i J j The subject string can optionally be preceded by a + (plus sign) or - (minus sign), but cannot include an integer suffix (such as L). If the subject string is preceded by a - (minus sign), the converted integer value has a negative value cast to unsigned integer.
PAGE 592
wcswcs(3) Guardian Native C Library Calls Reference Manual NAME wcswcs - Searches for a substring in a wide-character string LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 593
Guardian Native C Library Calls (t - z) wcswidth(3) NAME wcswidth - Determines the display width of wide-character strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 594
wcswidth(3) Guardian Native C Library Calls Reference Manual value of -1 is returned. RELATED INFORMATION Functions: wcwidth(3).
PAGE 595
Guardian Native C Library Calls (t - z) wcsxfrm(3) NAME wcsxfrm - Transforms wide character strings for collation in the current locale LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
PAGE 596
wcsxfrm(3) Guardian Native C Library Calls Reference Manual ERRORS If the following condition occurs, the wcsxfrm( ) function sets errno to the corresponding value. [EINVAL] The ws2 parameter contains wide-character codes outside the domain of the collating sequence defined by the current locale. [ENOMEM] There was insufficient memory available to allocate temporary storage for this operation. RELATED INFORMATION Functions: setlocale(3), strcmp(3), strxfrm(3), wcscmp(3), wcscoll(3).
PAGE 597
Guardian Native C Library Calls (t - z) wctomb(3) NAME wctomb - Converts a wide character into a multibyte character LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int wctomb ( char *s, wchar_t wchar); PARAMETERS s Points to the location where the conversion is stored.
PAGE 598
wctomb(3) Guardian Native C Library Calls Reference Manual ERRORS If any of the following conditions occur, the wctomb( ) function sets errno to the corresponding value: [EILSEQ] The wchar parameter does not correspond to a valid multibyte character. RELATED INFORMATION Functions: mblen(3), mbstowcs(3), mbtowc(3), wcstombs(3).
PAGE 599
Guardian Native C Library Calls (t - z) wctype(3) NAME wctype - Gets a handle to classify wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wctype_t wctype( char *property); PARAMETERS property Points to a string that identifies a character class.
PAGE 600
wctype(3) Guardian Native C Library Calls Reference Manual punct Punctuation character (No characters in alpha, digit, cntrl, or the space character are included.) space Space characters. At a minimum, the space, form-feed, newline, carriage-return, tab, and vertical-tab characters are included in this class upper Uppercase character. At a minimum, the 26 uppercase US-ASCII characters are included in this class.
PAGE 601
Guardian Native C Library Calls (t - z) wcwidth(3) NAME wcwidth - Determines the display width of wide characters LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include int wcwidth( wchar_t wc); PARAMETERS wc Specifies a wide character.
PAGE 602
wmemchr(3) Guardian Native C Library Calls Reference Manual NAME wmemchr - Finds a wide character in memory 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 wchar_t *wmemchr( const wchar_t *ws, wchar_t wc, size_t n); PARAMETERS ws Points to the location of a string.
PAGE 603
Guardian Native C Library Calls (t - z) wmemchr(3) STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification and conforms with the Single UNIX Specification, Version 2.
PAGE 604
wmemcmp(3) Guardian Native C Library Calls Reference Manual NAME wmemcmp - Compare wide characters in memory 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 int wmemcmp( const wchar_t *ws1, const wchar_t *ws2, size_t n); PARAMETERS ws1 Points to the location of a destination string.
PAGE 605
Guardian Native C Library Calls (t - z) wmemcpy(3) NAME wmemcpy - Copy wide characters in memory 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 wchar_t *wmemcpy( wchar_t *ws1, const wchar_t *ws2, size_t n); PARAMETERS ws1 Points to the location of a destination string.
PAGE 606
wmemmove(3) Guardian Native C Library Calls Reference Manual NAME wmemmove - Copy wide characters with overlapping areas in memory 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
PAGE 607
Guardian Native C Library Calls (t - z) wmemset(3) NAME wmemset - Sets wide characters in memory 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 wchar_t *wmemset( wchar_t *ws, wchar_t wc, size_t n); PARAMETERS ws Points to the location of a string.
PAGE 608
y0(3) Guardian Native C Library Calls Reference Manual NAME y0 - Computes the Bessel function of the second kind, of order 0 (zero) 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 double y0( double x); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 609
Guardian Native C Library Calls (t - z) y1(3) NAME y1 - Computes the Bessel function of the second kind, of order 1 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 double y1( double x); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 610
yn(3) Guardian Native C Library Calls Reference Manual NAME yn - Computes the Bessel function of the second kind, of order n 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 double yn( int n, double x ); PARAMETERS x Specifies the double value for which the function is to be computed.
PAGE 611
Guardian Native C Library Calls (t - z) yn(3) STANDARDS CONFORMANCE The XPG4 Version 2 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 527192-005 For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN.
PAGE 612
Permuted Index _____________________________ for a temporary file (OSS tmpnam( temporary file (Guardian tmpfile( Opens a stream (Guardian fopen( Opens a stream (OSS fopen( Opens a stream (Guardian freopen( Opens a stream (OSS freopen( Removes a file (Guardian remove( Removes a file (OSS remove( Renames a file (Guardian rename( a file or directory (OSS rename( temporary file (Guardian tmpnam( a temporary file (OSS tmpfile( of the first kind, of order of the second kind, of order of the first kind, of order
PAGE 613
of an Edit file opened for of an Edit file opened for information for a file opened for information for a file opened for information for a file opened for strcat: strncat: to another wcscat: with a character count wcsncat: bcopy: Copies an bzero: Zeroes an characters with overlapping wide characters with overlapping bcmp: Compares two Expands absolute value of its Gets flag letters from the Expands the greater of its two Expands the lesser of its two calloc: Allocates memory in an /SQL DECIMAL value stored
PAGE 614
Guardian Native C Library Calls Reference Manual bsearch: Performs a tdelete: Deletes a node from a tfind: Finds a node in a tsearch: Builds and searches a twalk: Traverses a ffs: Finds first allocating/ /Specifies the minimum into a fraction and a/ frexp: into integral and/ modf: /Converts time since the Epoch to /Converts time since the Epoch to time string asctime: Converts the Epoch mktime: Converts of parameters for output to a setbuf: Assigns setvbuf: Assigns search tree tsearch: memchr: Finds a chara
PAGE 615
Permuted Index stream getwchar: Gets a wide /for the first instance of a /for the final instance of a memcpy: Copies a wmemchr: Finds a wide strchr: Finds an integer strrchr: Searches for for a first occurrence of a wctomb: Converts a wide Tests for an alphanumeric Tests for an alphanumeric wide Tests for an alphabetic wide Tests for a wide control the properties of a wide Tests for a wide lowercase Tests for a printable wide Tests for a wide punctuation Test for a wide white-space Tests for a wide uppercas
PAGE 616
Guardian Native C Library Calls Reference Manual in memory memmove: Copies in memory wmemmove: Copy wide the run-time heap consistency is run-time heap heap_check: times: Gets process and subvolume names used to qualify/ fp_class: Returns the wctype: Gets a handle to atexit: Provides for stream clearerr: used fclose: endgrent: endpwent: dlresultcode: Returns the error strxfrm: Transforms string for /wide character strings for Compares strings using locale system: Executes an OSS shell an OSS shell command o
PAGE 617
Permuted Index a division operation fmod: function of 1.
PAGE 618
Guardian Native C Library Calls Reference Manual bcopy: memory memccpy: overlapping areas in/ memmove: into another wcscpy: strcpy: with a character count wcsncpy: wmemcpy: overlapping areas in/ wmemmove: of y cosine function cosine function cos: Computes the trigonometric cosh: Computes the hyperbolic the inverse trigonometric Computes the inverse hyperbolic strings with a character strings with a character strings with a character primary/ __ns_start_backup: pathname to a character/ mknod: symlink: tmpfil
PAGE 619
Permuted Index wide characters wcwidth: a multibyte character mblen: wide character iswctype: assert: Inserts program times difftime: Computes the between two calendar times isdigit: Tests for a iswdigit: Tests for a wide isxdigit: Tests for a hexadecimal rename: Renames a file or rmdir: Removes a rename_oss: Renames a file or wcwidth: Determines the strings wcswidth: Determines the hypot: Computes the Euclidean drand48: Generate uniformly erand48: Generates uniformly jrand48: Generate uniformly /Sets rule
PAGE 620
Guardian Native C Library Calls Reference Manual time into time since the ctime: Converts time since the gmtime: Converts time since the /Converts time since the distributed pseudorandom number/ error function call/ dlresultcode: Returns the standard output, or standard erf: Computes the erfc: Computes the complementary ferror: Tests the a message explaining a function a previous dynamic-link library message explaining function hypot: Computes the TACL command system: re_exec: regex: setjmp: Saves the curre
PAGE 621
Permuted Index information about an open attributes for an open remove_guardian: Removes a rename_guardian: Renames a function) /Creates a temporary /the name for a temporary about a symbolic link or any a stream pointer to a Guardian file opened for ANSI I/O /Returns /indicator of an Edit /indicator of an Edit file open state information for a the file state information for a the file state information for a /Performs a backup open for a character/ mknod: Creates a rename: Renames a function) rename_oss: R
PAGE 622
Guardian Native C Library Calls Reference Manual floating-point/ floor: Rounds integral value rint: Rounds fp_class: Returns the class of a /string to a double-precision string to a double-precision string to a double-precision numbers to floating-point/ fflush: remainder of a division/ /Opens a stream (Guardian fopen_oss: Opens a stream (OSS (Guardian fopen( ) function) fopen( ) function) input, standard output, or/ getdate: Converts user parameters for output vfprintf: parameters for output vprintf: param
PAGE 623
Permuted Index Accesses message explaining the floating-point absolute value Opens a stream (Guardian fopen( ) Opens a stream (OSS fopen( ) Opens a stream (OSS freopen( ) the logarithm of the gamma Computes the Euclidean distance the logarithm of the gamma Computes the natural logarithm Computes the base 10 logarithm expm1: Computes the exponential file (Guardian tmpnam( ) Computes the natural logarithm order 0/ j0: Computes the Bessel order 1 j1: Computes the Bessel order n jn: Computes the Bessel order 0/
PAGE 624
Guardian Native C Library Calls Reference Manual information from the user/ information from the user/ information from the user/ input stream fgetc: input stream getc: standard input stream getchar: characters wctype: fgets: input stream gets: specified input stream getwc: specified input stream fgetwc: standard input stream getwchar: a stream fgetws: the standard input stream getws: getw: variables sysconf: ftime: attributes for an/ fpathconf: argument vector getopt: standard input stream group database g
PAGE 625
Permuted Index to use when allocating from the /Controls whether the run-time the consistency of the run-time consistency of the run-time heap whether the run-time heap/ the minimum block size to/ isxdigit: Tests for a iswxdigit: Tests for a wide random number/ setstate: Switches acosh: Computes the inverse cosh: Computes the asinh: Computes the inverse sinh: Computes the atanh: Computes the inverse tanh: Computes the distance function /associated with the real user strcasecmp: Compare two strings, Compares
PAGE 626
Guardian Native C Library Calls Reference Manual Pushes a character back into the a wide character back into the file descriptors for synchronous assert: wcschr: Searches for the first wcsrchr: Searches for the final string to a long long radix-64 ASCII string to a 32-bit Computes absolute value of an Converts a character string to an a character string to a long a character string to a long long strchr: Finds an string to a signed long long string to an unsigned long strings to an unsigned long strings to
PAGE 627
Permuted Index character character lowercase character wide character punctuation character white-space character uppercase character hexadecimal-digit character digit character of the first kind, of order 0/ of the first kind, of order 1 of the first kind, of order n distributed pseudorandom number/ interprocess communication (IPC) setgrent: Resets the group name setpwent: Resets the sequential the Bessel function of the first the Bessel function of the second the Bessel function of the first the Bessel fu
PAGE 628
Guardian Native C Library Calls Reference Manual logarithm function of 1.
PAGE 629
Permuted Index /number of active assign two arguments use when/ /Specifies the Computes the exponential function a pathname to a character/ into time since the Epoch number into integral and/ operation fmod: Computes the strfmon: Formats distributed pseudorandom number/ the length in bytes of a /a wide character string into a wide/ mbstowcs: Converts a character mbtowc: Converts a Converts a wide character into a for synchronous input/output number by a power of 2 ldexp: of the first kind, of order of the s
PAGE 630
Guardian Native C Library Calls Reference Manual distributed pseudorandom distributed pseudorandom distributed pseudorandom square root of a floating-point double-precision floating-point exponent as a floating-point ecvt: Converts a floating-point fcvt: Converts a floating-point gcvt: Converts a floating-point rand: Returns pseudorandom random: Generates random srand: Generates pseudorandom srandom: Generates random ceil: Rounds floating-point floor: Rounds floating-point rint: Rounds floating-point extern
PAGE 631
Permuted Index Writes a byte to the standard Writes a string to the standard variable number of parameters for fprintf: Prints formatted stream printf: Prints formatted variable number of parameters for variable number of parameters for memmove: Copies characters with /Copy wide characters with malloc_pages: Provides a memory get_param_msg: Retrieves the /Retrieves value of a parameter list va_arg: Returns a processing for a variable-length parameter from a variable-length processing for a variable-length /
PAGE 632
Guardian Native C Library Calls Reference Manual Sends a signal to the calling get_startup_msg: Retrieves the atexit: Provides for cleanup on times: Gets process and child the real user ID of the current parameter list va_end: Ends parameter/ va_start: Initializes clock: Reports assert: Inserts setlocale: Changes or queries the iswctype: Determines the valloc: malloc_pages: termination atexit: symbolic link or any file lstat: stat: open file fstat: information nl_langinfo: /Generate uniformly distributed /G
PAGE 633
Permuted Index expressions expressions expressions expression matching expression matching expressions expression matching expression matching regcomp: Perform regerror: Performs regexec: Performs regfree: Performs re_comp: Compiles re_exec: Executes regcmp: Compiles regex: Executes whether one value is unordered free: of a division operation fmod: Computes the modulo remainder: Computes the /Removes a file (Guardian remove_oss: Removes a file (OSS (Guardian remove( ) function) remove( ) function) rmdir: re
PAGE 634
Guardian Native C Library Calls Reference Manual segment of a string wcsspn: environment variable getenv: copysign: pointer of a stream occurrence of a character numbers to nearest integral/ cbrt: Computes the cube sqrt: Computes the square floating-point integers ceil: floating-point integers floor: nearest integral value rint: distributed/ lcong48: Sets distributed/ seed48: Sets distributed/ srand48: Sets library loadfile from a checked/ /Controls whether the Checks the consistency of the context setjmp:
PAGE 635
Permuted Index putenv: memset: for interval timers alarm: distributed/ lcong48: distributed pseudorandom/ seed48: distributed/ srand48: for a file/ __ns_fset_file_state: of an Edit file opened/ edfseek: wmemset: array used by the random number/ stream system: Executes an OSS copysign: Returns x with the action to take upon delivery of a take upon delivery of a signal abort: Generates a software raise: Sends a Converts a character string to a /Converts a character string to a sine function sin: Computes the
PAGE 636
Guardian Native C Library Calls Reference Manual Retrieves the process a file a C/ /Converts SQL DECIMAL value character array sprintf: /value to a SQL DECIMAL value and ignoring case string character in string locale collation initial segment of string clearerr: Clears indicators on a fclose: Closes a feof: Tests EOF on a fflush: Flushes a fgets: Gets a string from a fopen: Opens a file fputs: Writes a string to a fread: Reads input from a freopen: Opens a fwrite: Writes to an output getw: Gets a word from
PAGE 637
Permuted Index time to a string strcat: Appends a string to a strdup: Duplicates a strlen: Finds length of strncat: Appends bytes to a strncpy: Copies a string to a wide character string into a multibyte character time into a date and time input read from a character the Epoch into a date and time a floating-point number to a a floating-point number to a a character index: Scans locale strxfrm: Transforms character rindex: Scans a character in a wide-character a character in a wide-character fgets: Gets a f
PAGE 638
Guardian Native C Library Calls Reference Manual strcasecmp: Compare two strncasecmp: Compares two wcstok: Splits wide-character wcstoul: Converts wide-character wcstoull: Converts wide-character strcoll: Compares display width of wide-character wcsncat: Appends wide-character wcsncmp: Compares wide-character wcsncpy: Copies wide-character strings, ignoring case string bytes in a string string to a time value in string segment of string string to a double-precision/ string to a signed long integer string t
PAGE 639
Permuted Index ispunct: character iswspace: isupper: islower: feof: isdigit: isgraph: character isxdigit: character iswprint: isatty: isspace: hexadecimal-digit/ iswxdigit: character iswcntrl: iswdigit: character iswlower: character iswpunct: character iswupper: isalpha: character iswalpha: character isalnum: character iswalnum: isascii: iscntrl: isprint: iswgraph: stream ferror: number is infinite finite: a number) isnan: unordered relative to/ unordered: search tree alarm: Sets or changes the the timeout
PAGE 640
Guardian Native C Library Calls Reference Manual twalk: Traverses a binary search a node from a binary search Finds a node in a binary search and searches a binary search acos: Computes the inverse cos: Computes the asin: Computes the inverse sin: Computes the atan: Computes the inverse tan: Computes the y/x atan2: Computes the inverse binary search tree tree and stores it in a C array of into the input stream back into the input stream pseudorandom/ drand48: Generate pseudorandom/ erand48: Generates pseudo
PAGE 641
Permuted Index Sets or changes the timeout the class of a floating-point the floating-point absolute isnan: Tests whether a unordered: Tests whether one get_param_by_name: Retrieves readlink: Reads the getenv: Returns the abs: Computes absolute _abs: Expands absolute labs: Computes absolute numbers to nearest integral decimal to/ /Converts SQL DECIMAL a character string to a time is unordered relative to another stores it/ /Converts a C long long array of decimal to a C long long putenv: Sets an environment
PAGE 642
Guardian Native C Library Calls Reference Manual input stream ungetwc: Pushes a input stream fgetwc: Gets a input stream getwc: Gets a input stream getwchar: Gets a wmemchr: Finds a character wctomb: Converts a Tests for an alphanumeric Determines the properties of a a multibyte character to a a multibyte character string to a stream fgetws: Gets a standard input/ getws: Gets a multibyte/ wcstombs: Converts a collation in/ wcsxfrm: Transforms stream fputwc: Writes a stream putwc: Writes a wctype: Gets a han
PAGE 643
Permuted Index output stream puts: specified stream fputwc: specified stream putwc: a stream fputws: the standard output/ putws: putw: fwrite: logarithm function of 1.0 plus copysign: Returns Returns x with the sign of of the second kind, of order 0/ of the second kind, of order 1 of the second kind, of order n trigonometric tangent function of of the first kind, of order 0 of the second kind, of order 0 bzero: 527192-005 Writes a string to the standard ......................................
PAGE 644
-1- Index _____________________________ Symbols __ns_backup_fopen function, 5-7 to 5-8 __ns_fget_file_open_state function, 5-9 to 5-10 __ns_fget_file_state function, 5-11 to 5-12 __ns_fopen_special function, 5-13 to 5-15 __ns_fset_file_state function, 5-16 to 5-17 __ns_start_backup function, 5-18 to 5-20 3-62, 3-73 argument vector, returning flag letters from, 3-24 asctime function, 1-10 asin function, 1-11 to 1-12 asinh function, 1-13 assert macro, 1-14 assigning buffers, 6-12, 6-21 atan function, 1-17
PAGE 645
C calloc function, 1-30 cbrt function, 1-31 ceil function, 1-32 character classification functions, 3-60, 3-61, 3-62, 3-64, 3-65, 3-66, 3-67, 3-69, 3-70, 3-71, 3-72, 3-85 converting multibyte to wide, 4-46 finding length of multibyte, 4-43 getting from input stream, 2-19, 3-43, 3-44 locating first occurrence in a string, 7-65 pushing back, 7-34, 7-35 translating to 7-bit ASCII, 7-22 translating to lowercase, 7-23, 7-24 translating to uppercase, 7-25, 7-26 character string converting multibyte to wide, 4-45
PAGE 646
Guardian Native C Library Calls Reference Manual default volume, 1-33 diagnostics, inserting in programs, 1-14 difftime function, 1-46 digit class type test, 3-62, 3-65, 3-77 div function, 1-47 division function, 1-47, 4-16, 4-20 dlclose function, 1-48 dlerror function, 1-50 DLLs, 1-48, 1-50, 1-52, 1-58, 1-60 dlopen function, 1-52 dlresultcode function, 1-58 drand48 function, 1-62 to 1-63 E ecvt function, 1-64 to 1-65 edfseek function, 1-66 to 1-67 edftell function, 1-68 Edit file, 1-66 to 1-67, 1-68 endgr
PAGE 647
Index temporary, 7-12, 7-13, 7-15 finite function, 2-22 flag letters, returning from argument vector, 3-24 floating-point integer absolute value function, 2-2 modulo remainder function, 2-24 round functions, 1-32, 2-23 floating-point number converting to fraction and integral power of 2, 2-65 converting to integral and fractional parts, 4-57 multiplying by integral power of 2, 4-14 floor function, 2-23 fmod function, 2-24 to 2-25 fopen function, 2-26, 2-27 to 2-29, 2-30 to 2-32 fopen_guardian function, 2-27
PAGE 648
Guardian Native C Library Calls Reference Manual 3-21, 6-13 Guardian API, 1-33, 1-66 to 1-67, 1-68, 2-33, 3-6 to 3-7, 3-8, 3-23, 3-27, 3-28 to 3-29, 3-38 to 3-40, 3-46, 3-50, 3-51, 3-52, 7-6 to 7-7 Guardian environment, using from abort function, 1-3 alarm function, 1-9 ftok function, 2-80 longjmp function, 4-32 raise function, 5-47 setjmp function, 6-14 signal function, 6-23 times function, 7-11 Guardian file number, 3-46 H hash tables creating, 3-48 deleting, 3-49 searching, 3-48, 3-53 hcreate function,
PAGE 649
Index M iswxdigit function, 3-84 isxdigit function, 3-85 J j0 function, 4-2 to 4-3 j1 function, 4-4 to 4-5 jn function, 4-6 to 4-7 jrand48 function, 4-8 to 4-9 L l64a function, 4-10 labs function, 4-11 lcong48 function, 4-12 to 4-13 ldexp function, 4-14 to 4-15 ldiv function, 4-16 lfind function, 4-17 lgamma function, 4-18 to 4-19 linear search, of table, 4-17, 4-38 lldiv function, 4-20 locale, setting and querying, 6-15 locale-dependent parameters, 4-21 localeconv function, 4-21 to 4-23 localtime funct
PAGE 650
Guardian Native C Library Calls Reference Manual wide, 7-89 multibyte character string, converting from wide, 7-77 N NaN, checking, 3-68 national language, returning information about, 5-4 natural logarithm, 4-27 nextafter function, 5-2 nl_langinfo function, 5-4 nonlocal goto, 4-32 nrand48 function, 5-5 to 5-6 null character, 1-21, 6-79 O operations on strings, 6-48, 6-50, 6-52 optarg, external variable, 3-24 output formatting parameters, 7-42, 7-49, 7-51 printing and formatting, 2-41, 5-25, 6-29 output s
PAGE 651
Index R raise function, 5-47 to 5-48 rand function, 5-49 random function, 5-50 random numbers generating, 6-37 returning, 5-49 realloc function, 5-51 regcmp function, 5-58 regcomp function, 5-60 regerror function, 5-60 regex function, 5-68 regexec function, 5-60 regfree function, 5-60 remainder function, 5-72 remove function, 5-74, 5-75, 5-76 to 5-77 remove_guardian function, 5-75 remove_oss function, 5-76 to 5-77 removing a file, 5-74, 5-75, 5-76 retrieving values of system variables, 6-96 returning rando
PAGE 652
Guardian Native C Library Calls Reference Manual getting a string from stdin, 3-36 mapping pointer to file descriptor, 2-21 mapping pointer to Guardian file number, 3-46 opening, 2-7, 2-27, 2-30, 2-58, 2-59, 2-62 performing binary input/output, 2-55, 2-83 returning file pointer for, 2-16, 2-73, 2-77 setting file pointer for, 2-73, 2-76, 5-78 testing EOF on, 2-9 testing error indicator on, 2-10 strerror function, 6-55 strfmon function, 6-56 to 6-59 strftime function, 6-60 to 6-65 string converting character
PAGE 653
Index _POSIX2_VERSION, 6-99 _POSIX_JOB_CONTROL, 6-97 _POSIX_SAVED_IDS, 6-97 _POSIX_VERSION, 6-97 _XOPEN_ENH_I18N, 6-99 _XOPEN_SHM, 6-99 _XOPEN_VERSION, 6-99 _XOPEN_XCU_VERSION, 6-99 sysconf function, 6-96 to 6-100 system clock getting time, 7-9 times of process and child process, 7-10 system function, 6-101 to 6-102 system variable, finding current value, 1-36 system variables, retrieving values of, 6-96 T table performing linear search, 4-17 performing linear search and update, 4-38 sorting, 5-45 TACL com
PAGE 654
Guardian Native C Library Calls Reference Manual U ungetc function, 7-34 ungetwc function, 7-35 unordered function, 7-36 UNRESOLVED_PROCEDURE_CALLED function, 1-56 uppercase class type test, 3-62, 3-72, 3-83 user database accessing basic group information, 1-69, 3-17, 3-19, 3-21, 6-13 defined, 1-70, 3-30, 3-32, 3-34, 6-19 manipulating entry in, 1-70, 3-30, 3-32, 3-34, 6-19 user password, 1-70, 3-30, 3-32, 3-34, 6-19 username, return for process, 1-43 V valloc function, 7-39 va_arg, 7-37 va_end, 7-38 va_st
PAGE 655
Index wmemchr function, 7-94 to 7-95 wmemcmp function, 7-96 wmemcpy function, 7-97 wmemmove function, 7-98 wmemset function, 7-99 word getting from input stream, 2-19, 3-43, 3-44 writing out, 5-39 to 5-40 writing out, 5-39 to 5-40 writing out a string, 2-49, 2-53, 5-37, 5-43 writing out characters, 2-47, 5-31, 5-33 writing out wide characters, 2-51, 5-41 X xdigit class type test, 3-62, 3-84, 3-85 Y y0 function, 7-100 y1 function, 7-101 yn function, 7-102 to 7-103 527192-005 Hewlett-Packard Company Inde