Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

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 J06.03 and all subsequent J-series RVUs, H06.08 and all

subsequent H-series RVUs, and G06.29 and all subsequent G-series RVUs until

otherwise indicated in its replacement publication.

Part Number Published

527192-018 August 2013

Summary of content (1252 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 J06.03 and all subsequent J-series RVUs, H06.08 and all subsequent H-series RVUs, and G06.29 and all subsequent G-series RVUs until otherwise indicated in its replacement publication.
PAGE 2
Document History Part Number Product Version Published 527192-013 527192-014 527192-015 527192-016 527192-017 527192-018 N/A N/A N/A N/A N/A N/A May 2009 May 2009 August 2010 February 2011 February 2012 August 2013 New editions incorporate any updates issued since the previous edition.
PAGE 3
Contents _____________________________ What is New in This Manual . New Functions About This Manual . . . . . . . . . . . . . . . . . . . xiii . . . . . . . . . . . . . . . . . . . . xiv . . . . . . . . . . . . . . . . . . . . . . xv . . . . . . . . . . . . . . . . . . . . . . xv Document Usage . . . . . . . . . . . . . . . . . . . . xvi Reference Page Format . . . . . . . . . . . . . .
PAGE 4
atof . . atoi . . atol . . atoll . basename bcmp . bcopy . bsearch . btowc . bzero . cabs . cabsf . cabsl . cacos . cacosf . cacosh . cacoshf . cacoshl . cacosl . calloc . carg . . cargf . cargl . casin . casinf . casinh . casinhf . casinhl . casinl . catan . catanf . catanh . catanhf . catanhl . catanl . catclose catgets . catopen cbrt . . cbrtf . cbrtl . ccos . ccosf . ccosh . ccoshf . ccoshl . ccosl . ceil . . ceilf . ceill . . cexp . cexpf . cexpl . chvol . 527192-018 . . . . . . . . . . . . . . . . .
PAGE 5
Guardian Native C Library Calls Reference Manual cimag . . . cimagf . . . cimagl . . . clearerr . . . clock . . . clog . . . . clogf . . . clogl . . . confstr . . . conj . . . . conjf . . . conjl . . . copysign . . copysignf . . copysignl . . cos . . . . cosf . . . . cosh . . . coshf . . . coshl . . . cosl . . . . cpow . . . cpowf . . . cpowl . . . cproj . . . cprojf . . . cprojl . . . creal . . . crealf . . . creall . . . csin . . . . csinf . . . csinh . . . csinhf . . . csinhl . . . csinl . . . csqrt . .
PAGE 6
Contents dlsym . drand48 ecvt . . edfseek . edftell . endgrent endpwent erand48 erf . . erfc . . erfcf . erfcl . erff . . erfl . . _Exit . exit . . exp2 . exp2f . exp2l . exp . . expf . expl . . expm1 . expm1f . expm1l . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 7
Guardian Native C Library Calls Reference Manual fgetwc . . . . fgetws . . . . fileno . . . . finite . . . . flockfile . . . floor . . . . floorf . . . . floorl . . . . fma . . . . . fmaf . . . . fmal . . . . fmax . . . . fmaxf . . . . fmaxl . . . . fmin . . . . fminf . . . . fminl . . . . fmod . . . . fmodf . . . . fmodl . . . . fopen . . . . fopen64 . . . fopen64_guardian fopen64_oss . . fopen64_std_file . fopen_guardian . fopen_oss . . . fopen_std_file . . fpathconf . . . fp_class . . . fpclassify . . .
PAGE 8
Contents ftello64 ftime . ftok . . ftrylockfile funlockfile fwide . fwprintf fwrite . fwscanf . . . . . . . . . . . . . . . . . . Section 3. Guardian Native C Library Calls gamma . . . . . . . . gamma_r . . . . . . . gcvt . . . . . . . . . get_assign_msg . . . . . get_assign_msg_by_name . . getc . . . . . . . . . getchar . . . . . . . . getchar_unlocked . . . . getc_unlocked . . . . . getdate . . . . . . . . getenv . . . . . . . . getenv_r . . . . . . . getgrent . . . . . . . getgrent_r . . . . . . .
PAGE 9
Guardian Native C Library Calls Reference Manual hypotf . . hypotl . . ilogb . . ilogbf . . ilogbl . . imaxabs . imaxdiv . index . . initstate . isalnum . isalpha . . isascii . . isatty . . isblank . . iscntrl . . isdigit . . isfinite . . isgraph . . isgreater . isgreaterequal isinf . . isless . . islessequal . islessgreater islower . . isnan . . isnormal . isprint . . ispunct . . isspace . . isunordered isupper . . iswalnum . iswalpha . iswblank . iswcntrl . iswctype . iswdigit . iswgraph . iswlower .
PAGE 10
Contents ldexp . . . ldexpf . . . ldexpl . . . ldiv . . . . lfind . . . lgamma . . lgammaf . . lgammal . . lgamma_r . . llabs . . . lldiv . . . llrint . . . llrintf . . . llrintl . . . llround . . . llroundf . . llroundl . . localeconv . . localtime . . localtime_r . log10 . . . log10f . . . log10l . . . log1p . . . log1pf . . . log1pl . . . log2 . . . log2f . . . log2l . . . log . . . . logb . . . logbf . . . logbl . . . logf . . . . logl . . . . longjmp . . longlong_to_dec lrand48 . . . lrint . . . .
PAGE 11
Guardian Native C Library Calls Reference Manual memccpy . memchr . memchr64 . memcmp . memcmp64 memcpy . memcpy64 . memmove . memmove64 memset . . memset64 . _min . . mktime . . modf . . modff . . modfl . . mrand48 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 5. Guardian Native C Library Calls nan . . . . . . . . . nanf . . . . . . . . nanl . . . . . . . . . nearbyint . . . . . . . nearbyintf . . . . . . . nearbyintl . . . . . . . nextafter . . . . . . . nextafterf . . .
PAGE 12
Contents putws . . . qsort . . . raise . . . rand . . . random . . . rand_r . . . realloc . . . re_comp . . re_exec . . regcmp . . . regcomp . . regerror . . regex . . . regexec . . regfree . . . remainder . . remainderf . . remainderl . . remove . . . remove_guardian remove_oss . remquo . . . remquof . . remquol . . rewind . . . rindex . . . rint . . . . rintf . . . . rintl . . . . round . . . roundf . . . roundl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 13
Guardian Native C Library Calls Reference Manual sinf . . . sinh . . . sinhf . . sinhl . . sinl . . . snprintf . sprintf . . sqrt . . . sqrtf . . sqrtl . . srand . . srand48 . srandom . sscanf . . strcasecmp strcat . . strcat64 . strchr . . strchr64 . strcmp . . strcmp64 . strcoll . . strcpy . . strcpy64 . strcspn . . strdup . . strerror . . strerror_r . strfmon . . strftime . strlen . . strlen64 . strncasecmp strncat . . strncat64 . strncmp . strncmp64 . strncpy . . strncpy64 . strpbrk . . strptime .
PAGE 14
Contents strtoumax strxfrm . swprintf swscanf sysconf . system . . . . . . . . . . . . . . . . . . . Section 7. Guardian Native C Library Calls tan . . . . . . . . . tanf . . . . . . . . . tanh . . . . . . . . . tanhf . . . . . . . . tanhl . . . . . . . . tanl . . . . . . . . . tdelete . . . . . . . . tempnam . . . . . . . terminate_program . . . . tfind . . . . . . . . tgamma . . . . . . . tgammaf . . . . . . . tgammal . . . . . . . time . . . . . . . . times . . . . . . . . tmpfile . . . . . . . .
PAGE 15
Guardian Native C Library Calls Reference Manual vfscanf . . vfwprintf . vfwscanf . vprintf . . vscanf . . vsnprintf . vsprintf . vsscanf . . vswprintf . vswscanf . vwprintf . vwscanf . wcrtomb . wcscat . . wcschr . . wcscmp . wcscoll . . wcscpy . . wcscspn . wcsftime . wcslen . . wcsncat . wcsncmp . wcsncpy . wcspbrk . wcsrchr . wcsrtombs . wcsspn . . wcstod . . wcstof . . wcstoimax . wcstok . . wcstol . . wcstoll . . wcstombs . wcstoul . wcstoull . wcstoumax wcswcs . . wcswidth . wcsxfrm . wctob . .
PAGE 16
Contents yn . Permuted Index Index . 527192-018 . . . . . . . . . . . . . . . . . . . . . . . . . 7-213 . . . . . . . . . . . . . . . . . . . . . . . Pindex-1 . . . . . . . . . . . . . . . . . . . . . . .
PAGE 17
Guardian Native C Library Calls Reference Manual LIST OF TABLES Table 2−1. Values of File-Related Constants for Open Files . . . . . . . . . . . . 2-85 Table 6−1. Default Values for Monetary Formatting . . . . . . . . . . . . . . 6-95 Table 6−2. Example Output from strfmon() Function . . . . . . . . . . . . . .
PAGE 18
What is New in This Manual This section describes changes made to the Guardian Native C Library Calls Reference Manual since the last edition (527192-017). Unless otherwise indicated in the text, discussions of native mode behavior, processes, and so forth apply to both the TNS/R code that runs on systems running G-series RVUs and to the TNS/E code that runs on systems running J-series RVUs or H-series RVUs.
PAGE 19
Guardian Native C Library Calls Reference Manual New Functions The following missing functions have been added: xiv • basename( ) • catclose( ) • catgets( ) • catopen( ) • snprintf( ) • tempname( ) • vsnprintf( ) • wcscoll( ) • wcslen( ) Hewlett-Packard Company 527192-018
PAGE 20
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 21
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 22
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 23
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 24
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 25
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 26
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 27
_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 28
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 29
aclsort(3) Guardian Native C Library Calls Reference Manual NAME aclsort - Sorts an access control list (ACL) LIBRARY G-series native OSS processes: /G/system/sysnn/zossfsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zossfdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yossfdll SYNOPSIS #include #include
PAGE 30
Guardian Native C Library Calls (a - e) aclsort(3) • If the calclass parameter is 0 (zero) and the ACL contains no entries of type USER and no entries of type GROUP, the entries of type GROUP_OBJ and CLASS_OBJ have the same permissions. • If the ACL contains no entries of type DEF_USER and no entries of type DEF_GROUP, and an entry of type DEF_GROUP_OBJ is specified, an entry of type DEF_CLASS_OBJ is also specified and the two entries have the same permissions.
PAGE 31
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 32
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-018 For IEEE floating-point values, errno is not set to [EDOM] when the value of x is NaN.
PAGE 33
acosf(3) Guardian Native C Library Calls Reference Manual NAME acosf - Computes the inverse trigonometric cosine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 34
Guardian Native C Library Calls (a - e) acosh(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 35
acosh(3) 1−12 Guardian Native C Library Calls Reference Manual Hewlett-Packard Company 527192-018
PAGE 36
Guardian Native C Library Calls (a - e) acoshf(3) NAME acoshf - Computes the inverse hyperbolic cosine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float acoshf( float x); PARAMETERS x Is the float value for which the inverse hyperbolic cosine function is to be computed.
PAGE 37
acoshl(3) Guardian Native C Library Calls Reference Manual NAME acoshl - Computes the inverse hyperbolic cosine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 38
Guardian Native C Library Calls (a - e) acosl(3) NAME acosl - Computes the inverse trigonometric cosine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 39
alarm(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries 32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library: /G/system/zdllnnn/zputdll 64-bit H-series and J-series OSS proces
PAGE 40
Guardian Native C Library Calls • (a - e) alarm(3) Link the application to the zputdll library (/G/system/zdllnnn/zputdll). On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use this function with 32-bit or 64-bit threaded applications. To use this function in a 32-bit threaded application on systems running H06.24 or later RVUs or J06.
PAGE 41
_alloca(3) Guardian Native C Library Calls Reference Manual NAME _alloca - Allocates memory LIBRARY None. The C/C++ compiler generates in-line code for this function. SYNOPSIS #include void ∗ _alloca( unsigned short size); PARAMETERS size Specifies the number of bytes of memory to be allocated. DESCRIPTION The _alloca( ) function allocates size bytes of space in the stack frame of the caller.
PAGE 42
Guardian Native C Library Calls (a - e) asctime(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 43
asctime_r(3) Guardian Native C Library Calls Reference Manual NAME asctime_r - Converts broken-down time into a date and time string (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 44
Guardian Native C Library Calls (a - e) asctime_r(3) • Link your application to the Standard POSIX Threads library: /G/system/sysnn/zsptsrl (G-series) or /G/system/zdllnnn/zsptdll (H-series or J-series) • Compile your application using the #define_SPT_MODEL_ macro or an equivalent compiler command option. For more detailed information about writing multi-threaded or 64-bit applications for the Open System Services environment, see the Open System Services Programmer’s Guide.
PAGE 45
asin(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 46
Guardian Native C Library Calls (a - e) asin(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 leaves some features to the implementing vendor to define.
PAGE 47
asinf(3) Guardian Native C Library Calls Reference Manual NAME asinf - Computes the inverse trigonometric sine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 48
Guardian Native C Library Calls (a - e) asinf(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 49
asinh(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 50
Guardian Native C Library Calls (a - e) asinhf(3) NAME asinhf - Computes the inverse hyperbolic sine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float asinhf( float x); PARAMETERS x Is the float value for which the inverse hyperbolic sine function is to be computed.
PAGE 51
asinhl(3) Guardian Native C Library Calls Reference Manual NAME asinhl - Computes the inverse hyperbolic sine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 52
Guardian Native C Library Calls (a - e) asinl(3) NAME asinl - Computes the inverse trigonometric sine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 53
asinl(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 54
Guardian Native C Library Calls (a - e) assert(3) 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 55
atan2(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 56
Guardian Native C Library Calls (a - e) atan2(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 leaves some features to the implementing vendor to define.
PAGE 57
atan2f(3) Guardian Native C Library Calls Reference Manual NAME atan2f - Computes the inverse trigonometric tangent function of y/x for float values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 58
Guardian Native C Library Calls (a - e) atan2f(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 59
atan2l(3) Guardian Native C Library Calls Reference Manual NAME atan2l - Computes the inverse trigonometric tangent function of y/x for long double values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 60
Guardian Native C Library Calls (a - e) atan2l(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 61
atan(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 62
Guardian Native C Library Calls (a - e) atanf(3) NAME atanf - Computes the inverse trigonometric tangent function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 63
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 64
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-018 • 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 65
atanhf(3) Guardian Native C Library Calls Reference Manual NAME atanhf - Computes the inverse hyperbolic tangent function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 66
Guardian Native C Library Calls (a - e) atanhf(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 67
atanhl(3) Guardian Native C Library Calls Reference Manual NAME atanhl - Computes the inverse hyperbolic tangent function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 68
Guardian Native C Library Calls (a - e) atanhl(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 69
atanl(3) Guardian Native C Library Calls Reference Manual NAME atanl - Computes the inverse trigonometric tangent function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 70
Guardian Native C Library Calls (a - e) atexit(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 71
atof(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 72
Guardian Native C Library Calls (a - e) atof(3) 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 73
atoi(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 74
Guardian Native C Library Calls (a - e) atol(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 75
atoll(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 76
Guardian Native C Library Calls (a - e) basename(3) NAME basename - Returns the final component of a pathname LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include char *basename(char *path); PARAMETERS path is a pointer to a pathname.
PAGE 77
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 78
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 79
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 80
Guardian Native C Library Calls (a - e) btowc(3) NAME btowc - Converts single-byte characater to wide-character LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.1 */ wint_t btowc(int c); PARAMETERS c The character to be evaluated and converted.
PAGE 81
bzero(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 82
Guardian Native C Library Calls (a - e) cabs(3) NAME cabs - Computes the complex absolute value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double cabs( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 83
cabsf(3) Guardian Native C Library Calls Reference Manual NAME cabsf - Computes the float complex absolute value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float cabsf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 84
Guardian Native C Library Calls (a - e) cabsl(3) NAME cabsl - Computes the long double complex absolute value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double cabsl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 85
cacos(3) Guardian Native C Library Calls Reference Manual NAME cacos - Computes the complex arc cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex cacos( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 86
Guardian Native C Library Calls (a - e) cacosf(3) NAME cacosf - Computes the float complex arc cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex cacosf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 87
cacosh(3) Guardian Native C Library Calls Reference Manual NAME cacosh - Computes the complex arc hyperbolic cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex cacosh( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 88
Guardian Native C Library Calls (a - e) cacoshf(3) NAME cacoshf - Computes the float complex arc hyperbolic cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex cacoshf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 89
cacoshl(3) Guardian Native C Library Calls Reference Manual NAME cacoshl - Computes the long double complex arc hyperbolic cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex cacoshl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 90
Guardian Native C Library Calls (a - e) cacosl(3) NAME cacosl - Computes the long double complex arc cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex cacosl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 91
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include #include
PAGE 92
Guardian Native C Library Calls (a - e) carg(3) NAME carg - Computes the complex argument LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double carg( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 93
cargf(3) Guardian Native C Library Calls Reference Manual NAME cargf - Computes the float complex argument LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float cargf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 94
Guardian Native C Library Calls (a - e) cargl(3) NAME cargl - Computes the long double complex argument LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double cargl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 95
casin(3) Guardian Native C Library Calls Reference Manual NAME casin - Computes the complex arc sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex casin( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 96
Guardian Native C Library Calls (a - e) casinf(3) NAME casinf - Computes the float complex arc sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex casinf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 97
casinh(3) Guardian Native C Library Calls Reference Manual NAME casinh - Computes the complex arc hyperbolic sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex casinh( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 98
Guardian Native C Library Calls (a - e) casinhf(3) NAME casinhf - Computes the float complex arc hyperbolic sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex casinhf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 99
casinhl(3) Guardian Native C Library Calls Reference Manual NAME casinhl - Computes the long double complex arc hyperbolic sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex casinhl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 100
Guardian Native C Library Calls (a - e) casinl(3) NAME casinl - Computes the long double complex arc sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex casinl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 101
catan(3) Guardian Native C Library Calls Reference Manual NAME catan - Computes the complex arc tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex catan( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 102
Guardian Native C Library Calls (a - e) catanf(3) NAME catanf - Computes the float complex arc tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex catanf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 103
catanh(3) Guardian Native C Library Calls Reference Manual NAME catanh - Computes the complex arc hyperbolic tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex catanh( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 104
Guardian Native C Library Calls (a - e) catanhf(3) NAME catanhf - Computes the float complex arc hyperbolic tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex catanhf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 105
catanhl(3) Guardian Native C Library Calls Reference Manual NAME catanhl - Computes the long double complex arc hyperbolic tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex catanhl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 106
Guardian Native C Library Calls (a - e) catanl(3) NAME catanl - Computes the long double complex arc tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex catanl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 107
catclose(3) Guardian Native C Library Calls Reference Manual NAME catclose - Closes a specified message catalog LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 108
Guardian Native C Library Calls (a - e) catgets(3) NAME catgets - Retrieves a message from a catalog LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 109
catopen(3) Guardian Native C Library Calls Reference Manual NAME catopen - Opens a specified message catalog LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include nl_catd catopen( const char *name, int oflag); PARAMETERS name Specifies the catalog file to open.
PAGE 110
Guardian Native C Library Calls (a - e) catopen(3) For example, if the catopen( ) function specifies a catalog with the name mycmd.cat, and the environment variables are set as follows: NLSPATH=../%N:/usr/lib/nls/msg/%L/%N:/usr/lib/nls/msg/%l/%N LANG=fr_BE.ISO8859-1 then the application searches for the catalog in the following order: ../mycmd.cat /usr/lib/nls/msg/fr_BE.ISO88591-1/mycmd.cat /usr/lib/nls/msg/fr/mycmd.
PAGE 111
cbrt(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 112
Guardian Native C Library Calls (a - e) cbrtf(3) NAME cbrtf - Computes the cube root for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float cbrtf( float x); PARAMETERS x Is the float value whose cube root is to be computed.
PAGE 113
cbrtl(3) Guardian Native C Library Calls Reference Manual NAME cbrtl - Computes the cube root of a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double cbrtl( long double x); PARAMETERS x Is the long double value whose cube root is to be computed.
PAGE 114
Guardian Native C Library Calls (a - e) ccos(3) NAME ccos - Computes the complex cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex ccos( double complex z); PARAMETERS z Specifies a double complex value. DESCRIPTION The ccos( ) function computes the complex cosine of z.
PAGE 115
ccosf(3) Guardian Native C Library Calls Reference Manual NAME ccosf - Computes the float complex cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex ccosf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 116
Guardian Native C Library Calls (a - e) ccosh(3) NAME ccosh - Computes the complex hyperbolic cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex ccosh( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 117
ccoshf(3) Guardian Native C Library Calls Reference Manual NAME ccoshf - Computes the float complex hyperbolic cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex ccoshf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 118
Guardian Native C Library Calls (a - e) ccoshl(3) NAME ccoshl - Computes the long double complex hyperbolic cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex ccoshl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 119
ccosl(3) Guardian Native C Library Calls Reference Manual NAME ccosl - Computes the long double complex cosine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex ccosl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 120
Guardian Native C Library Calls (a - e) ceil(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 121
ceilf(3) Guardian Native C Library Calls Reference Manual NAME ceilf - Rounds float numbers to float integers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float ceilf( float x); PARAMETERS x Specifies the float value to be rounded.
PAGE 122
Guardian Native C Library Calls (a - e) ceill(3) NAME ceill - Rounds long double numbers to long double integers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double ceill( long double x); PARAMETERS x Specifies the long double value to be rounded.
PAGE 123
cexp(3) Guardian Native C Library Calls Reference Manual NAME cexp - Computes the complex exponential LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex cexp( double complex z); PARAMETERS z Specifies the power to which the base of the natural logarithms (e) is to be raised.
PAGE 124
Guardian Native C Library Calls (a - e) cexpf(3) NAME cexpf - Computes the float complex exponential LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex cexpf( float complex z); PARAMETERS z Specifies the power to which the base of the natural logarithms (e) is to be raised.
PAGE 125
cexpl(3) Guardian Native C Library Calls Reference Manual NAME cexpl - Computes the long double complex exponential LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 126
Guardian Native C Library Calls (a - e) chvol(3) NAME chvol - Changes default volume and subvolume names used to qualify partial Guardian filenames LIBRARY G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL G-series OSS native processes: /G/system/sysnn/zcrtlsrl H-series and J-series Guardian native processes: $SYSTEM.ZDLLnnn.
PAGE 127
cimag(3) Guardian Native C Library Calls Reference Manual NAME cimag - Computes the imaginary part of a complex value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double cimag( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 128
Guardian Native C Library Calls (a - e) cimagf(3) NAME cimagf - Computes the imaginary part of a float complex value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float cimagf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 129
cimagl(3) Guardian Native C Library Calls Reference Manual NAME cimagl - Computes the imaginary part of a long double complex value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double cimagl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 130
Guardian Native C Library Calls (a - e) clearerr(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 131
clock(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 132
Guardian Native C Library Calls (a - e) clog(3) NAME clog - Computes the complex natural logarithm function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex clog( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 133
clogf(3) Guardian Native C Library Calls Reference Manual NAME clogf - Computes the float complex natural logarithm function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex clogf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 134
Guardian Native C Library Calls (a - e) clogl(3) NAME clogl - Computes the long double complex natural logarithm function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex clogl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 135
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 and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include
PAGE 136
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 137
conj(3) Guardian Native C Library Calls Reference Manual NAME conj - Computes the complex conjugate LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex conj( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 138
Guardian Native C Library Calls (a - e) conjf(3) NAME conjf - Computes the float complex conjugate LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex conjf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 139
conjl(3) Guardian Native C Library Calls Reference Manual NAME conjl - Computes the long double complex conjugate LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex conjl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 140
Guardian Native C Library Calls (a - e) copysign(3) NAME copysign - Returns x with the sign of y LIBRARY G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL G-series OSS native processes: /G/system/sysnn/zcrtlsrl H-series and J-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 141
copysignf(3) Guardian Native C Library Calls Reference Manual NAME copysignf - Returns x with the sign of y for a float value LIBRARY H-series and J-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include double copysignf( float x, float y ); PARAMETERS x Specifies a float value. y Specifies a float value.
PAGE 142
Guardian Native C Library Calls (a - e) copysignl(3) NAME copysignl - Returns x with the sign of y for a long double value LIBRARY H-series and J-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include long double copysignl( long double x, long double y ); PARAMETERS x Specifies a long double value.
PAGE 143
cos(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 144
Guardian Native C Library Calls 527192-018 (a - e) cos(3) • For IEEE floating-point values, errno is not set to [EDOM] when the value of x is NaN. • 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 145
cosf(3) Guardian Native C Library Calls Reference Manual NAME cosf - Computes the trigonometric cosine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float cosf( float x); PARAMETERS x Is the float value for which the trigonometric cosine function is to be computed.
PAGE 146
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 147
coshf(3) Guardian Native C Library Calls Reference Manual NAME coshf - Computes the hyperbolic cosine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float coshf( float x); PARAMETERS x Is the float value for which the hyperbolic cosine function is to be computed.
PAGE 148
Guardian Native C Library Calls (a - e) coshl(3) NAME coshl - Computes the hyperbolic cosine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 149
cosl(3) Guardian Native C Library Calls Reference Manual NAME cosl - Computes the trigonometric cosine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 150
Guardian Native C Library Calls (a - e) cpow(3) NAME cpow - Computes the complex power function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex cpow( double complex x, double complex y ); PARAMETERS x Specifies a double complex value. y Specifies a double complex value.
PAGE 151
cpowf(3) Guardian Native C Library Calls Reference Manual NAME cpowf - Computes the float complex power function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex cpowf( float complex x, float complex y ); PARAMETERS x Specifies a float complex value. y Specifies a float complex value.
PAGE 152
Guardian Native C Library Calls (a - e) cpowl(3) NAME cpowl - Computes the long double complex power function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex cpowl( long double complex x, long double complex y ); PARAMETERS x Specifies a long double complex value.
PAGE 153
cproj(3) Guardian Native C Library Calls Reference Manual NAME cproj - Computes the complex projection function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex cproj( double complex z); PARAMETERS z Is the value to be projected.
PAGE 154
Guardian Native C Library Calls (a - e) cprojf(3) NAME cprojf - Computes the float complex projection function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex cprojf( float complex z); PARAMETERS z Is the float complex value to be projected.
PAGE 155
cprojl(3) Guardian Native C Library Calls Reference Manual NAME cprojl - Computes the long double complex projection function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex cprojl( long double complex z); PARAMETERS z Is the long double complex value to be projected.
PAGE 156
Guardian Native C Library Calls (a - e) creal(3) NAME creal - Computes the real part of a complex value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double creal( double complex z); PARAMETERS z Specifies a double complex value. DESCRIPTION The creal( ) function computes the real part of z.
PAGE 157
crealf(3) Guardian Native C Library Calls Reference Manual NAME crealf - Computes the real part of a float complex value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float crealf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 158
Guardian Native C Library Calls (a - e) creall(3) NAME creall - Computes the real part of a long double complex value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double creall( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 159
csin(3) Guardian Native C Library Calls Reference Manual NAME csin - Computes the complex sine function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex csin( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 160
Guardian Native C Library Calls (a - e) csinf(3) NAME csinf - Computes the float complex sine function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex csinf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 161
csinh(3) Guardian Native C Library Calls Reference Manual NAME csinh - Computes the complex hyperbolic sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex csinh( double complex z); PARAMETERS z Specifies a complex value.
PAGE 162
Guardian Native C Library Calls (a - e) csinhf(3) NAME csinhf - Computes the float complex hyperbolic sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex csinhf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 163
csinhl(3) Guardian Native C Library Calls Reference Manual NAME csinhl - Computes the long double complex hyperbolic sine LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex csinhl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 164
Guardian Native C Library Calls (a - e) csinl(3) NAME csinl - Computes the long double complex sine function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex csinl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 165
csqrt(3) Guardian Native C Library Calls Reference Manual NAME csqrt - Computes the complex square root function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex csqrt( double complex z); PARAMETERS z Is the value whose complex square root is to be computed.
PAGE 166
Guardian Native C Library Calls (a - e) csqrtf(3) NAME csqrtf - Computes the float complex square root function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex csqrtf( float complex z); PARAMETERS z Is the float complex value whose complex square root is to be computed.
PAGE 167
csqrtl(3) Guardian Native C Library Calls Reference Manual NAME csqrtl - Computes the long double complex square root function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 168
Guardian Native C Library Calls (a - e) ctan(3) NAME ctan - Computes the complex tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex ctan( double complex z); PARAMETERS z Specifies a double complex value. DESCRIPTION The ctan( ) function computes the complex tangent of z.
PAGE 169
ctanf(3) Guardian Native C Library Calls Reference Manual NAME ctanf - Computes the float complex tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex ctanf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 170
Guardian Native C Library Calls (a - e) ctanh(3) NAME ctanh - Computes the complex hyperbolic tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double complex ctanh( double complex z); PARAMETERS z Specifies a double complex value.
PAGE 171
ctanhf(3) Guardian Native C Library Calls Reference Manual NAME ctanhf - Computes the float complex hyperbolic tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float complex ctanhf( float complex z); PARAMETERS z Specifies a float complex value.
PAGE 172
Guardian Native C Library Calls (a - e) ctanhl(3) NAME ctanhl - Computes the long double complex hyperbolic tangent LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex ctanhl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 173
ctanl(3) Guardian Native C Library Calls Reference Manual NAME ctanl - Computes the long double complex tangent function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double complex ctanl( long double complex z); PARAMETERS z Specifies a long double complex value.
PAGE 174
Guardian Native C Library Calls (a - e) ctime(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 175
ctime_r(3) Guardian Native C Library Calls Reference Manual NAME ctime_r - Converts time since the Epoch into a date and time string (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 176
Guardian Native C Library Calls (a - e) ctime_r(3) /G/system/zdllnnn/zsptdll (H-series or J-series) • Compile your application using the #define_SPT_MODEL_ macro or an equivalent compiler command option. For more detailed information about writing multi-threaded or 64-bit applications for the Open System Services environment, see the Open System Services Programmer’s Guide.
PAGE 177
cuserid(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 178
Guardian Native C Library Calls (a - e) cuserid(3) [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(3), getpwent(3).
PAGE 179
dec_to_longlong(3) Guardian Native C Library Calls Reference Manual NAME dec_to_longlong - Converts SQL DECIMAL value stored in a C array of decimal to a C long long value LIBRARY G-series Guardian native processes: $SYSTEM.SYSnn.ZCRESRL G-series OSS native processes: /G/system/sysnn/zcresrl H-series and J-series Guardian native processes: $SYSTEM.ZDLLnnn.
PAGE 180
Guardian Native C Library Calls (a - e) difftime(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 181
div(3) Guardian Native C Library Calls Reference Manual NAME div - Divides integers LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 182
Guardian Native C Library Calls (a - e) dlclose(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series and J-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 183
dlclose(3) Guardian Native C Library Calls Reference Manual 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 184
Guardian Native C Library Calls (a - e) dlerror(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series and J-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 185
dlerror(3) Guardian Native C Library Calls Reference Manual 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 186
Guardian Native C Library Calls (a - e) dlopen(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series and J-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 187
dlopen(3) Guardian Native C Library Calls Reference Manual 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 an
PAGE 188
Guardian Native C Library Calls (a - e) dlopen(3) 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 189
dlopen(3) Guardian Native C Library Calls Reference Manual 1. Locations specified by -rld_first_l at link time (the value of rpath_first) 2. Public libraries 3. Program location * 4. Locations specified by -rld_l at link time (the value of rpath) 5. Default locations for 32-bit processes: For OSS: /lib, /usr/lib, /usr/local/lib, /G/SYSTEM/ZDLL For Guardian: $SYSTEM.
PAGE 190
Guardian Native C Library Calls (a - e) dlopen(3) For OSS: /lib64, /usr/lib64, /usr/local/lib64, /lib, /usr/lib, /usr/local/lib, /G/SYSTEM/YDLL, /G/SYSTEM/ZDLL in this order where the asterisk (*) marks those locations that are omitted when the ld or eld command -limit_runtime_paths option was used. Environment Variables and Diagnostic Output If you do not specify RTLD_VERBOSE() for mode in the dlopen( ) call, the verbosity level defaults to that specified by _RLDVERBOSE=n.
PAGE 191
dlopen(3) Guardian Native C Library Calls Reference Manual • Could not be opened for execution • Is not a DLL or an unlicensed public SRL or if an error occurred during the loading or adjustment of the file’s symbolic references. The dlerror( ) or dlresultcode( ) function should be called immediately to determine the problem. ERRORS The dlopen( ) function does not set the errno variable. Error information is available through the dlerror( ) or dlresultcode( ) function.
PAGE 192
Guardian Native C Library Calls (a - e) dlresultcode(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series and J-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 193
dlresultcode(3) Guardian Native C Library Calls Reference Manual 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 194
Guardian Native C Library Calls (a - e) dlsym(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZRLDDLL H-series and J-series OSS processes: /G/system/zdllnnn/zrlddll SYNOPSIS #include
PAGE 195
dlsym(3) Guardian Native C Library Calls Reference Manual 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 196
Guardian Native C Library Calls (a - e) drand48(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 197
drand48(3) Guardian Native C Library Calls Reference Manual 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 198
Guardian Native C Library Calls (a - e) ecvt(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 199
ecvt(3) Guardian Native C Library Calls Reference Manual ERRORS No errors are returned. This function does not set errno. 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 200
Guardian Native C Library Calls (a - e) edfseek(3) NAME edfseek - Sets the file-position indicator of an Edit file opened for ANSI I/O LIBRARY G-series Guardian native processes: $SYSTEM.SYSnn.ZCRTLSRL G-series OSS native processes: /G/system/sysnn/zcrtlsrl H-series and J-series Guardian native processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 201
edfseek(3) Guardian Native C Library Calls Reference Manual Relative positioning (using pos_base values SEEK_CUR or SEEK_END) is slower than absolute positioning (using pos_base value SEEK_SET) because it requires sequential scanning of 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.
PAGE 202
Guardian Native C Library Calls (a - e) edftell(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 203
endgrent(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include
PAGE 204
Guardian Native C Library Calls (a - e) endpwent(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include
PAGE 205
erand48(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 206
Guardian Native C Library Calls (a - e) erand48(3) can be either positive or negative. Refer to the fp_class(3) reference page for a description of IEEE value classes. Guardian functions are available to convert between floating-point formats. Refer to the Guardian Programmer’s Guide for a discussion of floating-point conversions. RETURN VALUES The erand48( ) function returns nonnegative, double-precision, floating-point values.
PAGE 207
erf(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 208
Guardian Native C Library Calls (a - e) erfc(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 209
erfcf(3) Guardian Native C Library Calls Reference Manual NAME erfcf - Computes the complementary error function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float erfcf( float x); PARAMETERS x Specifies the float value for which the complementary error function is to be computed.
PAGE 210
Guardian Native C Library Calls (a - e) erfcl(3) NAME erfcl - Computes the complementary error function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 211
erff(3) Guardian Native C Library Calls Reference Manual NAME erff - Computes the error function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float erff( float x); PARAMETERS x Specifies the float value for which the error function is to be computed.
PAGE 212
Guardian Native C Library Calls (a - e) erfl(3) NAME erfl - Computes the error function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double erfl( long double x); PARAMETERS x Specifies the long double value for which the error function is to be computed.
PAGE 213
_Exit(3) Guardian Native C Library Calls Reference Manual NAME _Exit - Terminates a process LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include void _Exit( int status); PARAMETERS status Indicates the status of the process.
PAGE 214
Guardian Native C Library Calls (a - e) _Exit(3) • If the exit of a process causes a process group to become orphaned, and if any member of the newly orphaned process group is stopped, then a SIGHUP signal followed by a SIGCONT signal is sent to each member of the orphaned process group. • Locks set by the fcntl( ) function are removed. Use From the Guardian Environment The _Exit( ) function can be called from any Guardian process as well as from OSS processes.
PAGE 215
exit(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 216
Guardian Native C Library Calls (a - e) exp2(3) NAME exp2 - Computes the base-2 exponential function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double exp2( double x); PARAMETERS x Specifies the power to which the base-2 logarithm is to be raised.
PAGE 217
exp2f(3) Guardian Native C Library Calls Reference Manual NAME exp2f - Computes the base-2 exponential function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float exp2f( float x); PARAMETERS x Specifies the power to which the base-2 logarithm is to be raised.
PAGE 218
Guardian Native C Library Calls (a - e) exp2l(3) NAME exp2l - Computes the base-2 exponential function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double exp2l( long double x); PARAMETERS x Specifies the power to which the base-2 logarithm is to be raised.
PAGE 219
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 220
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-018 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 221
expf(3) Guardian Native C Library Calls Reference Manual NAME expf - Computes the exponential function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float expf( float x); PARAMETERS x Specifies the power to which the base of the natural logarithms (e) is to be raised.
PAGE 222
Guardian Native C Library Calls (a - e) expl(3) NAME expl - Computes the exponential function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double expl( long double x); PARAMETERS x Specifies the power to which the base of the natural logarithms (e) is to be raised.
PAGE 223
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 224
Guardian Native C Library Calls (a - e) expm1f(3) NAME expm1f - Computes the exponential function minus 1.0 for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float expm1f( float x); PARAMETERS x Is the power to which the base of the natural logarithms (e) is to be raised.
PAGE 225
expm1l(3) Guardian Native C Library Calls Reference Manual NAME expm1l - Computes the exponential function minus 1.0 for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 226
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 227
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 228
Guardian Native C Library Calls (f) fabsf(3) NAME fabsf - Computes the floating-point absolute value function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float fabsf( float x); PARAMETERS x Specifies the float value whose absolute value is to be computed.
PAGE 229
fabsl(3) Guardian Native C Library Calls Reference Manual NAME fabsl - Computes the floating-point absolute value function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 230
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 231
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), fopen64(3), setbuf(3).
PAGE 232
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 233
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 234
Guardian Native C Library Calls (f) fdim(3) NAME fdim - Computes the positive difference between two floating-point values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double fdim( double x, double y ); PARAMETERS x Specifies a double value. y Specifies a double value.
PAGE 235
fdimf(3) Guardian Native C Library Calls Reference Manual NAME fdimf - Computes the positive difference between two float values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float fdimf( float x, float y ); PARAMETERS x Specifies a float value. y Specifies a float value.
PAGE 236
Guardian Native C Library Calls (f) fdiml(3) NAME fdiml - Computes the positive difference between two long double values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double fdiml( long double x, long double y ); PARAMETERS x Specifies a long double value. y Specifies a long double value.
PAGE 237
fdopen(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 238
Guardian Native C Library Calls (f) fdopen(3) 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. 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.
PAGE 239
feclearexcept(3) Guardian Native C Library Calls Reference Manual NAME feclearexcept - Clears floating-point exception flags LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int feclearexcept( int excepts); PARAMETERS excepts Specifies the floating-point exception flags that are to be cleared.
PAGE 240
Guardian Native C Library Calls (f) fegetenv(3) NAME fegetenv - Gets the floating-point environment LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int fegetenv( fenv_t *envp); PARAMETERS envp Specifies the object that is to store the current floating-point environment.
PAGE 241
fegetexceptflag(3) Guardian Native C Library Calls Reference Manual NAME fegetexceptflag - Gets floating-point exception flags LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 242
Guardian Native C Library Calls (f) fegetround(3) NAME fegetround - Gets the current floating-point rounding direction LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int fegetround(void); PARAMETERS None. DESCRIPTION The fegetround( ) function gets the current floating-point rounding direction.
PAGE 243
feholdexcept(3) Guardian Native C Library Calls Reference Manual NAME feholdexcept - Saves the floating-point environment LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int feholdexcept( fenv_t *envp); PARAMETERS envp Specifies the object that is to store the current floating-point environment.
PAGE 244
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 245
feraiseexcept(3) Guardian Native C Library Calls Reference Manual NAME feraiseexcept - Raises floating-point exception flags LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int feraiseexcept( int excepts); PARAMETERS excepts Specifies the floating-point exception flags that are to be raised.
PAGE 246
Guardian Native C Library Calls (f) ferror(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 247
fesetenv(3) Guardian Native C Library Calls Reference Manual NAME fesetenv - Sets the floating-point environment LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 248
Guardian Native C Library Calls (f) fesetexceptflag(3) NAME fesetexceptflag - Sets floating-point exception flags LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 249
fesetround(3) Guardian Native C Library Calls Reference Manual NAME fesetround - Sets the floating-point rounding direction LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int fesetround( int round); PARAMETERS round Specifies one of the following rounding direction macros, which are defined in the fenv.
PAGE 250
Guardian Native C Library Calls (f) fetestexcept(3) NAME fetestexcept - Raises floating-point exception flags LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int fetestexcept( int excepts); PARAMETERS excepts Specifies the floating-point exception flags that are to be queried.
PAGE 251
feupdateenv(3) Guardian Native C Library Calls Reference Manual NAME feupdateenv - Updates the floating-point environment LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 252
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 253
fflush(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: close(2), exit(2), fclose(3), fopen(3), fopen64(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 254
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int ffs(int i); PARAMETERS i is an integer to examined.
PAGE 255
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 256
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 257
fgetpos(3) Guardian Native C Library Calls Reference Manual NAME fgetpos - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 258
Guardian Native C Library Calls (f) fgetpos64(3) NAME fgetpos64 - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 259
fgetpos64(3) [ESPIPE] Guardian Native C Library Calls Reference Manual An illegal attempt was made to get or set the file position of a pipe or FIFO. RELATED INFORMATION Functions: fgetpos(3), fgetpos64(3), fopen(3), fopen64(3), fseek(3), fseeko(3), fseeko64(3), fsetpos(3), fsetpos64(3), ftell(3), ftello(3), ftello64(3), rewind(3). STANDARDS CONFORMANCE This function is an HP extension to the XPG4 version 2 specification.
PAGE 260
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 261
fgets(3) [ENOMEM] Guardian Native C Library Calls Reference Manual Insufficient memory is available for the operation. [EOVERFLOW] An attempt was made to read at or beyond the maximum file offset. 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 262
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 263
fgetwc(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fopen(3), fread(3), getc(3), gets(3), getwc(3), getwchar(3), putwc(3), scanf(3).
PAGE 264
Guardian Native C Library Calls (f) fgetws(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 265
fileno(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 266
Guardian Native C Library Calls (f) finite(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 267
flockfile(3) Guardian Native C Library Calls Reference Manual NAME flockfile - Allows a thread to acquire ownership of a stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include void flockfile( FILE ∗ stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 268
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 269
floorf(3) Guardian Native C Library Calls Reference Manual NAME floorf - Rounds float numbers to float integers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float floorf( float x); PARAMETERS x Specifies the float value to be rounded.
PAGE 270
Guardian Native C Library Calls (f) floorl(3) NAME floorl - Rounds long double numbers to long double integers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double floorl( long double x); PARAMETERS x Specifies the long double value to be rounded.
PAGE 271
fma(3) Guardian Native C Library Calls Reference Manual NAME fma - Computes the multiply-add operation for floating-point values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double fma( double x, double y, double z ); PARAMETERS x Specifies a double value that is a factor of the multiplication.
PAGE 272
Guardian Native C Library Calls (f) fma(3) [EDOM] The value of x*y is invalid and z is NaN. [ERANGE] The result would cause an underflow. RELATED INFORMATION Functions: fmaf(3), fmal(3). Files: math(4). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 273
fmaf(3) Guardian Native C Library Calls Reference Manual NAME fmaf - Computes the multiply-add operation for float values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float fmaf( float x, float y, float z ); PARAMETERS x Specifies a float value that is a factor of the multiplication.
PAGE 274
Guardian Native C Library Calls (f) [ERANGE] fmaf(3) The result would cause an overflow. If any of the following conditions occurs, the fmaf( ) function may set errno to the corresponding value: [EDOM] The value of x*y is invalid and z is NaN. [ERANGE] The result would cause an underflow. RELATED INFORMATION Functions: fma(3), fmal(3). Files: math(4). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 275
fmal(3) Guardian Native C Library Calls Reference Manual NAME fmal - Computes the multiply-add operation for long double values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 276
Guardian Native C Library Calls (f) [ERANGE] fmal(3) The result would cause an overflow. If any of the following conditions occurs, the fmal( ) function may set errno to the corresponding value: [EDOM] The value of x*y is invalid and z is NaN. [ERANGE] The result would cause an underflow. RELATED INFORMATION Functions: fma(3), fmaf(3). Files: math(4). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 277
fmax(3) Guardian Native C Library Calls Reference Manual NAME fmax - Determines the maximum numeric value of two floating-point numbers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double fmax( double x, double y ); PARAMETERS x Specifies a double number. y Specifies a double number.
PAGE 278
Guardian Native C Library Calls (f) fmaxf(3) NAME fmaxf - Determines the maximum numeric value of two float numbers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float fmaxf( float x, float y ); PARAMETERS x Specifies a float number. y Specifies a float number.
PAGE 279
fmaxl(3) Guardian Native C Library Calls Reference Manual NAME fmaxl - Determines the maximum numeric value of two long double numbers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double fmaxl( long double x, long double y ); PARAMETERS x Specifies a long double number.
PAGE 280
Guardian Native C Library Calls (f) fmin(3) NAME fmin - Determines the minimum numeric value of two floating-point numbers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double fmin( double x, double y ); PARAMETERS x Specifies a double number. y Specifies a double number.
PAGE 281
fminf(3) Guardian Native C Library Calls Reference Manual NAME fminf - Determines the minimum numeric value of two float numbers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float fminf( float x, float y ); PARAMETERS x Specifies a float number. y Specifies a float number.
PAGE 282
Guardian Native C Library Calls (f) fminl(3) NAME fminl - Determines the minimum numeric value of two long double numbers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double fminl( long double x, long double y ); PARAMETERS x Specifies a long double number. y Specifies a long double number.
PAGE 283
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 284
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 285
fmodf(3) Guardian Native C Library Calls Reference Manual NAME fmodf - Computes the modulo remainder of a division operation for float values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float fmodf( float x, float y ); PARAMETERS x Specifies the float value that is the numerator of the division.
PAGE 286
Guardian Native C Library Calls (f) fmodf(3) RELATED INFORMATION Functions: abs(3), ceil(3), fabs(3), floor(3), fmod(3), fmodl(3), fp_class(3), isnan(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 287
fmodl(3) Guardian Native C Library Calls Reference Manual NAME fmodl - Computes the modulo remainder of a division operation for long double values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 288
Guardian Native C Library Calls (f) fmodl(3) RELATED INFORMATION Functions: abs(3), ceil(3), fabs(3), floor(3), fmod(3), fmodf(3), fp_class(3), isnan(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 289
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 290
Guardian Native C Library Calls (f) fopen64(3) NAME fopen64 - Opens a file stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 291
fopen64_guardian(3) Guardian Native C Library Calls Reference Manual NAME fopen64_guardian - Opens a stream (Guardian fopen64( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 292
Guardian Native C Library Calls (f) fopen64_guardian(3) 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). w+ Create a text file (or truncate an existing text file to length zero) and open it for update access.
PAGE 293
fopen64_guardian(3) Guardian Native C Library Calls Reference Manual of fopen64( ) does not distinguish between text and binary files. Text and binary files in the OSS environment are type 180. For information on the ANSISTREAMS pragma, see the C/C++ Programmer’s Guide. The default number of secondary extents for files created by fopen64( ) is 16. The default number of maxextents for files created by fopen64( ) is 500.
PAGE 294
Guardian Native C Library Calls (f) fopen64_oss(3) NAME fopen64_oss - Opens a stream (OSS fopen64( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 295
fopen64_oss(3) Guardian Native C Library Calls Reference Manual r Open an existing file for read-only access. w Create a file (or truncate an existing file to length zero) and open it for write-only access. a Create a file (or open an existing file) and open it for append (write at the end of the file) access. r+ Open an existing file for update access (reading and writing). w+ Create a file (or truncate an existing file to length zero) and open it for update access.
PAGE 296
Guardian Native C Library Calls (f) fopen64_oss(3) fopen64_guardian( ) is functionally identical to the fopen64( ) function of the Guardian environment. It is the same as setting systype guardian at compile time. systype guardian is the default setting for the C and C++ compilers in the Guardian environment. To use the fopen64_oss( ) or fopen64_guardian( ) functions, specify the _TANDEM_SOURCE feature test macro. RETURN VALUES If the fopen64( ) function succeeds, a pointer to the stream is returned.
PAGE 297
fopen64_oss(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: open(2), fclose(3), fopen(3), fopen64(3), fopen64_guardian(3), fopen_oss(3), freopen(3), fseek(3), setbuf(3). Miscellaneous topics: acl(5). STANDARDS CONFORMANCE The fopen64_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 298
Guardian Native C Library Calls (f) fopen64_std_file(3) NAME fopen64_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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 299
fopen64_std_file(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fopen64(3). STANDARDS CONFORMANCE The fopen64_std_file( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 300
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 301
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 302
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 303
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 304
Guardian Native C Library Calls (f) fopen_oss(3) r+ Open an existing file for update access (reading and writing). w+ Create a file (or truncate an existing file to length zero) and open it for update access. a+ Create a file (or open an existing file) and open it for update access with writing at the end of the file. The OSS version of fopen does not distinguish between text and binary files. Text and binary files are type 180.
PAGE 305
fopen_oss(3) Guardian Native C Library Calls Reference Manual To use the fopen_oss( ) or fopen_guardian( ) functions, specify the _TANDEM_SOURCE feature test macro. RETURN VALUES If the fopen( ) function succeeds, a pointer to the stream is returned. If the fopen( ) function fails, a null pointer is returned, and errno is set to indicate the error. ERRORS If any of these conditions occurs, the fopen( ) function sets errno to the corresponding value.
PAGE 306
Guardian Native C Library Calls (f) fopen_oss(3) Miscellaneous topics: acl(5). STANDARDS CONFORMANCE The fopen_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 307
fopen_std_file(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 308
Guardian Native C Library Calls (f) fpathconf(3) 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 and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include
PAGE 309
fpathconf(3) PATH_MAX Guardian Native C Library Calls Reference Manual 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 310
Guardian Native C Library Calls (f) fpathconf(3) 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 311
fpathconf(3) [EINVAL] [EIO] Guardian Native C Library Calls Reference Manual One of the following conditions occurred: • The name parameter specifies an unknown or inapplicable characteristic. • 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.
PAGE 312
Guardian Native C Library Calls (f) fpathconf(3) STANDARDS CONFORMANCE _PC_SOCK_MAXBUF is not supported because it is not in the XPG4 Version 2 specification. The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • The error values [EBADF] and [EINVAL] can be returned by the fpathconf( ) function.
PAGE 313
fp_class(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 314
Guardian Native C Library Calls (f) fp_class(3) 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 315
fpclassify(3) Guardian Native C Library Calls Reference Manual NAME fpclassify - Classifies a floating-point value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int fpclassify( floating-type x); PARAMETERS floating-type Specifies the floating-type of x. x Specifies a value of type floating-type.
PAGE 316
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 317
fprintf(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: ’ Format the integer portion of the result of a decimal conversion (%i, %d, %u, %f, %F, %g, or %G) with thousands’ grouping characters, using the nonmonetary grouping character. For other conversions the behavior is undefined. - Left align within the field the result of the conversion.
PAGE 318
Guardian Native C Library Calls (f) fprintf(3) — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 319
fprintf(3) Guardian Native C Library Calls Reference Manual — An L followed by an n conversion specifier indicates that the argument will be treated as a pointer to a long long int. — A t followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a ptrdiff_t or the corresponding unsigned integer type argument. — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t.
PAGE 320
Guardian Native C Library Calls (f) fprintf(3) f Accepts a float or double value and converts it to decimal notation in the format [-]ddd.ddd. The number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified). If a radix character is output, at least one digit is output before it. The value is rounded to the appropriate number of digits.
PAGE 321
fprintf(3) Guardian Native C Library Calls Reference Manual (zero) or null, the results are undefined. S or ls 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 322
Guardian Native C Library Calls (f) fprintf(3) RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned. 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.
PAGE 323
fputc(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 324
Guardian Native C Library Calls (f) fputc(3) 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. [EFBIG] An attempt was made to write at or beyond the file offset maximum.
PAGE 325
fputs(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 326
Guardian Native C Library Calls (f) fputs(3) [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 327
fputwc(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS For TNS/E Target Compilations on H06.
PAGE 328
Guardian Native C Library Calls (f) fputwc(3) RETURN VALUES Upon successful completion, this function returns the value written. If this function fails, it returns the constant WEOF. ERRORS If any of the following conditions occur, the putwc( ), fputwc(), and putwchar( ) function sets errno to the corresponding value. [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation.
PAGE 329
fputws(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 330
Guardian Native C Library Calls (f) fputws(3) [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: gets(3), getws(3), wcstombs(3), printf(3), putc(3), puts(3), putwc(3), putws(3).
PAGE 331
fread(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 332
Guardian Native C Library Calls (f) fread(3) [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 333
free(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include #include
PAGE 334
Guardian Native C Library Calls (f) freopen(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 335
freopen64(3) Guardian Native C Library Calls Reference Manual NAME freopen64 - Opens a stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 336
Guardian Native C Library Calls (f) freopen64_guardian(3) NAME freopen64_guardian - Opens a stream (Guardian freopen64( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 337
freopen64_guardian(3) Guardian Native C Library Calls Reference Manual r Opens a text file for reading. w Creates a new text file for writing, or opens and truncates a text file to zero length. a Appends (opens a text file for writing at the end of the file, or creates a text file for writing). r+ Opens a text file for update (reading and writing). w+ Truncates or creates a text file for update.
PAGE 338
Guardian Native C Library Calls (f) freopen64_guardian(3) Interoperability Variants The C run-time library supports two variants of the freopen64( ) function: freopen64_oss( ) and freopen64_guardian( ). The variants support the unique file-naming conventions and structures of the OSS and Guardian file systems, respectively. Explicit calls to the freopen64_oss( ) and freopen64_guardian( ) variants in source code are only made when the behavior of one environment is desired from the other environment.
PAGE 339
freopen64_oss(3) Guardian Native C Library Calls Reference Manual NAME freopen64_oss - Opens a stream (OSS freopen64( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 340
Guardian Native C Library Calls (f) freopen64_oss(3) function. The original stream is closed regardless of whether the open64( ) function succeeds with the named file. The freopen64( ) function returns a pointer to the FILE structure associated with the stream parameter. The freopen64( ) function is typically used to attach the preopened streams associated with stdin, stdout, and stderr to other files. The mode parameter controls the access allowed to the stream.
PAGE 341
freopen64_oss(3) Guardian Native C Library Calls Reference Manual freopen64_guardian( ) is functionally identical to the freopen64( ) function of the Guardian environment. It is the same as setting systype guardian at compile time. systype guardian is the default setting for the C and C++ compilers in the Guardian environment. To use the freopen64_oss( ) or freopen64_guardian( ) functions, specify the _TANDEM_SOURCE feature test macro.
PAGE 342
Guardian Native C Library Calls (f) freopen64_oss(3) STANDARDS CONFORMANCE The freopen64_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 343
freopen_guardian(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 344
Guardian Native C Library Calls (f) freopen_guardian(3) 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 345
freopen_guardian(3) Guardian Native C Library Calls Reference Manual 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 346
Guardian Native C Library Calls (f) freopen_oss(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 347
freopen_oss(3) Guardian Native C Library Calls Reference Manual r Opens the file for reading. w Creates a new file for writing, or opens and truncates a file to zero length. a Appends (opens a file for writing at the end of the file, or creates a file for writing). r+ Opens a file for update (reading and writing). 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).
PAGE 348
Guardian Native C Library Calls (f) freopen_oss(3) RETURN VALUES If the freopen( ) function fails, a null pointer is returned, and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the freopen( ) function sets errno to the value that corresponds to the condition.
PAGE 349
frexp(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 350
Guardian Native C Library Calls (f) frexp(3) 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 351
frexpf(3) Guardian Native C Library Calls Reference Manual NAME frexpf - Breaks a float number into a fraction and a power of 2 LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float frexpf( float value, int *exp ); PARAMETERS value Specifies the float value to be broken into a fraction and a power of 2.
PAGE 352
Guardian Native C Library Calls (f) frexpf(3) RELATED INFORMATION Functions: fp_class(3), frexp(3), frexpl(3), isnan(3), ldexp(3), modf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 353
frexpl(3) Guardian Native C Library Calls Reference Manual NAME frexpl - Breaks a long double number into a fraction and a power of 2 LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 354
Guardian Native C Library Calls (f) frexpl(3) RELATED INFORMATION Functions: fp_class(3), frexp(3), frexpf(3), isnan(3), ldexp(3), modf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 355
fscanf(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 356
Guardian Native C Library Calls (f) • fscanf(3) 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 357
fscanf(3) Guardian Native C Library Calls Reference Manual — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type. — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type.
PAGE 358
Guardian Native C Library Calls (f) fscanf(3) n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input stream so far by this function. The assignment count returned at the completion of this function is not incremented. o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer.
PAGE 359
fscanf(3) Guardian Native C Library Calls Reference Manual added automatically. The results from the conversion are placed in *pointer unless you specify assignment suppression with an * (asterisk). Assignment suppression provides a way to describe an input field that is to be skipped. The input field is a string of non-white-space characters. It extends to the next inappropriate character or until width, if specified, is reached. The conversion code convcode indicates how to interpret the input field.
PAGE 360
Guardian Native C Library Calls (f) fscanf(3) [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3), sscanf(3), strtod(3).
PAGE 361
fseek(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 362
Guardian Native C Library Calls (f) fseek(3) The fseek( ) function allows the file-position indicator to be set beyond the end of existing data in the file. If data is later written at this point, subsequent reads of data in the gap will return bytes with the value 0 (zero) until data is actually written into the gap. The fseek( ) function does not, by itself, extend the size of a file.
PAGE 363
fseek(3) Guardian Native C Library Calls Reference Manual [EINTR] The write operation was terminated by a signal, and either none, some, or all the data was transferred. If there is buffered I/O, it is recommended that you call the fflush( ) function before the fseek( ) function to guarantee that the buffer characters were written. [EINVAL] The whence parameter is an invalid value, or the resulting file offset would be invalid.
PAGE 364
Guardian Native C Library Calls (f) fseeko(3) NAME fseeko - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 365
fseeko(3) Guardian Native C Library Calls Reference Manual If the most recent operation (ignoring any ftell( ) operations) on a given stream was fflush( ), the fseeko( ) function causes the file offset in the underlying open file descriptor to be adjusted to reflect the location specified by the fseeko( ) function. The fseeko( ) function allows the file-position indicator to be set beyond the end of existing data in the file.
PAGE 366
Guardian Native C Library Calls (f) fseeko(3) [EINTR] A signal terminated the write operation, and either none, some, or all the data was transferred. If there is buffered I/O, call the fflush( ) function before the fseeko( ) function to guarantee that the buffer characters are written. [EINVAL] The whence parameter is an invalid value, or the resulting file offset is invalid.
PAGE 367
fseeko64(3) Guardian Native C Library Calls Reference Manual NAME fseeko64 - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 368
Guardian Native C Library Calls (f) fseeko64(3) fields of the file for update. If the most recent operation (ignoring any ftell( ) operations) on a given stream was fflush( ), then the fseeko64( ) function causes the file offset in the underlying open file descriptor to be adjusted to reflect the location specified by the fseeko64( ) function. The fseeko64( ) function allows the file-position indicator to be set beyond the end of existing data in the file.
PAGE 369
fseeko64(3) Guardian Native C Library Calls Reference Manual [EINTR] A signal terminated the write operation, and either none, some, or all the data was transferred. If there is buffered I/O, call the fflush( ) function before the fseeko64( ) function to guarantee that the buffer characters are written. [EINVAL] The whence parameter is an invalid value, or the resulting file offset would be invalid.
PAGE 370
Guardian Native C Library Calls (f) fsetpos(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 371
fsetpos64(3) Guardian Native C Library Calls Reference Manual NAME fsetpos64 - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 372
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 373
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. [EOVERFLOW] The value of the file position cannot be represented in an object of type long. [ESPIPE] An illegal attempt was made to get set the file position of a pipe or FIFO.
PAGE 374
Guardian Native C Library Calls (f) ftello(3) NAME ftello - Reports the position of 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 375
ftello(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, the ftello( ) function returns the offset of the current byte relative to the beginning of the file associated with the named stream. Otherwise, a value of -1 is returned, and errno is set to indicate the error. ERRORS If these conditions occurs, the ftello( ) function sets errno to the corresponding value: [EBADF] The file descriptor underlying the stream parameter is not a valid file descriptor.
PAGE 376
Guardian Native C Library Calls (f) ftello64(3) NAME ftello64 - Reports the position of 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 377
ftello64(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, the ftello64( ) function returns the offset of the current byte relative to the beginning of the file associated with the named stream. Otherwise, a value of -1 is returned, and errno is set to indicate the error. ERRORS If these conditions occurs, the ftello64( ) function sets errno to the corresponding value: [EBADF] The file descriptor underlying the stream parameter is not a valid file descriptor.
PAGE 378
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 379
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 and J-series native Guardian processes: implicit libraries H-series and J-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 380
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 381
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. [ENOTSUP] The path_name parameter refers to a file on a logical disk volume administered through the Storage Management Foundation (SMF). [ENXIO] The caller’s current working directory or the root directory is not mounted.
PAGE 382
Guardian Native C Library Calls (f) ftrylockfile(3) NAME ftrylockfile - Allows a thread to acquire ownership of a stream if the stream is available LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int ftrylockfile( FILE ∗ stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 383
funlockfile(3) Guardian Native C Library Calls Reference Manual NAME funlockfile - Allows a thread to relinquish ownership of a stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include void funlockfile( FILE ∗ stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 384
Guardian Native C Library Calls (f) fwide(3) NAME fwide - Converts formatted input read from an input stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.1 */ int fwide( FILE *stream, int *mode ); PARAMETERS stream Specifies the input stream.
PAGE 385
fwprintf(3) Guardian Native C Library Calls Reference Manual NAME fwprintf - Prints formatted output to an output stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.1 */ int fwprintf ( FILE *stream, const wchar_t *format [, value] . . .
PAGE 386
Guardian Native C Library Calls (f) • • fwprintf(3) Zero or more flags that modify the meaning of the conversion specification. The flag characters and their meanings are as follows: ’ Format the integer portion of the result of a decimal conversion (%i, %d, %u, %f, %F, %g, or %G) with thousands’ grouping wide-characters, using the nonmonetary grouping wide-character. For other conversions the behavior is undefined. - Left align within the field the result of the conversion.
PAGE 387
fwprintf(3) Guardian Native C Library Calls Reference Manual — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 388
Guardian Native C Library Calls (f) fwprintf(3) — An L followed by an n conversion specifier indicates that the argument will be treated as a pointer to a long long int. — A t followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a ptrdiff_t or the corresponding unsigned integer type argument. — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t.
PAGE 389
fwprintf(3) Guardian Native C Library Calls Reference Manual f Accepts a float or double value and converts it to decimal notation in the format [-]ddd.ddd. The number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified). If a radix character is output, at least one digit is output before it.
PAGE 390
Guardian Native C Library Calls (f) fwprintf(3) (zero) or null, the results are undefined. S or ls 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 391
fwprintf(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned. ERRORS The fwprintf( ) 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.
PAGE 392
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 393
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 394
Guardian Native C Library Calls (f) fwscanf(3) NAME fwscanf - Converts formatted input read from an input stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.1 */ int fwscanf( FILE *stream, const wchar_t *format [, *pointer] . . .
PAGE 395
fwscanf(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 396
Guardian Native C Library Calls (f) fwscanf(3) — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type. — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type.
PAGE 397
fwscanf(3) Guardian Native C Library Calls Reference Manual i Accepts a decimal integer unless: — The first digit is a 0 (zero), in which case the integer is interpreted as an octal number. — The first two characters are 0x or 0X, in which case the integer is interpreted as a hexadecimal number. The corresponding pointer parameter should be an integer pointer. n Consumes no input.
PAGE 398
Guardian Native C Library Calls (f) fwscanf(3) — You can include the ] (right bracket) as an element of scanset if it is the first character of scanset. In this case, it is not interpreted as the bracket that closes scanset. If scanset is an exclusive scanset, the ] is preceded by the ˆ (circumflex) to make the ] an element of scanset. The corresponding pointer parameter must point to a character array large enough to contain the output string with a terminating 0 (zero) appended.
PAGE 399
fwscanf(3) Guardian Native C Library Calls Reference Manual [EILSEQ] The stream parameter contains an invalid wide character. [EINTR] The read operation was interrupted by a signal that was caught and no data was transferred. [EINVAL] The function call contains an invalid argument. [EIO] The call is attempting to read from the process’s controlling terminal and either the process is ignoring or blocking the SIGTTIN signal or the process group is orphaned.
PAGE 400
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 401
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 402
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 403
gamma_r(3) Guardian Native C Library Calls Reference Manual NAME gamma_r - Computes the logarithm of the gamma function (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 404
Guardian Native C Library Calls (g - i) gamma_r(3) reference page. Guardian functions are available to convert between floating-point formats. For a discussion of floating-point conversions, see the Guardian Programmer’s Guide. On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use either the POSIX User Thread Model library or the Standard POSIX Threads library for threaded applications.
PAGE 405
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 406
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 407
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 408
Guardian Native C Library Calls (g - i) get_assign_msg(3) short exclusion_spec; 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 409
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 410
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 411
getc(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. 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 412
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 413
getchar(3) Guardian Native C Library Calls Reference Manual online or in the Open System Services System Calls Reference Manual for information about the cause of that error. 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 414
Guardian Native C Library Calls (g - i) getchar_unlocked(3) NAME getchar_unlocked - Gets a character from the standard input stream but does not lock the stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int getchar_unlocked(void); PARAMETERS None.
PAGE 415
getchar_unlocked(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made on a nonexistent device, or the request was outside the capabilities of the device. [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. 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 416
Guardian Native C Library Calls (g - i) getc_unlocked(3) NAME getc_unlocked - Gets a character from a specified input stream but does not lock the stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int getc_unlocked( FILE ∗ stream); PARAMETERS stream Points to the file structure of an open file.
PAGE 417
getc_unlocked(3) Guardian Native C Library Calls Reference Manual [EINTR] The read operation was interrupted by a signal which was caught and no data was transferred. [EIO] The call is attempting to read from the process’s controlling terminal and either the process is ignoring or blocking the SIGTTIN signal or the process group is orphaned. [ENOMEM] Insufficient memory is available for the operation.
PAGE 418
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 419
getdate(3) Guardian Native C Library Calls Reference Manual %n Matches a newline character. %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).
PAGE 420
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 421
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 422
Guardian Native C Library Calls (g - i) getenv_r(3) NAME getenv_r - Returns the value of an environment variable LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int getenv_r( const char *name, char *buffer, size_t buflen ); PARAMETERS name Specifies the name of an environment variable.
PAGE 423
getgrent(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include
PAGE 424
Guardian Native C Library Calls (g - i) getgrent(3) NOTES The data returned by the getgrent( ) function is stored in a thread-specific 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 425
getgrent_r(3) Guardian Native C Library Calls Reference Manual NAME getgrent_r - Gets group information from the group database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes that do not use Standard POSIX Threads: $SYSTEM.ZDLLnnn.
PAGE 426
Guardian Native C Library Calls (g - i) getgrent_r(3) H06.21 and later H-series RVUs and J06.10 and later J-series RVUs The group information is updated in the structure pointed to by the grp parameter and a pointer to that structure is stored at the location pointed to by the result parameter. Storage referenced by the grp structure is allocated from the memory provided with the buffer parameter, which is buflen bytes in size.
PAGE 427
getgrent_r(3) • Guardian Native C Library Calls Reference Manual Include the grp.h header file To use the Standard POSIX Threads library, you must: • Include the spthread.
PAGE 428
Guardian Native C Library Calls (g - i) getgrent_r(3) [EWRONGID] The processor for the disk process that provides access to the database failed during the input operation and the backup process took over. Try the operation again. RELATED INFORMATION Functions: endgrent(3), getgrent(3), getgrgid(3), getgrgid_r(3), getgrnam(3), getgrnam_r(3), setgrent(3). STANDARDS CONFORMANCE H06.21 and later H-series RVUs, J06.10 and later J-series RVUs This function conforms to IEEE Std 1003.
PAGE 429
getgrgid(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include #include
PAGE 430
Guardian Native C Library Calls (g - i) getgrgid(3) }; 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 thread-specific 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 431
getgrgid_r(3) Guardian Native C Library Calls Reference Manual NAME getgrgid_r - Gets group information from the group database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes that do not use Standard POSIX Threads: $SYSTEM.ZDLLnnn.
PAGE 432
Guardian Native C Library Calls (g - i) getgrgid_r(3) Group Structure The group structure returned by the getgrgid_r( ) function is defined in the grp.h header file. The structure contains the following fields: gr_name The group name of the group. gr_passwd The system does not use this field, so its value is meaningless. gr_gid The group ID of the group. gr_mem The members of the group. OSS supports the following POSIX.
PAGE 433
getgrgid_r(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, the getgrgid_r( ) function returns 0 (zero). Otherwise, the function returns an error number, as described in the ERRORS subsection of this reference page. ERRORS If any of these conditions occur, the getgrgid_r( ) function returns the corresponding value: [EAGAIN] A system resource is temporarily unavailable. The function cannot allocate sufficient heap space to complete the call.
PAGE 434
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include #include
PAGE 435
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 thread-specific 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 436
Guardian Native C Library Calls (g - i) getgrnam_r(3) NAME getgrnam_r - Gets group information from the group database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes that do not use Standard POSIX Threads: $SYSTEM.ZDLLnnn.
PAGE 437
getgrnam_r(3) Guardian Native C Library Calls Reference Manual Group Structure The group structure returned by the getgrnam_r( ) function is defined in the grp.h header file. The structure contains the following fields: gr_name The group name of the group. gr_passwd The system does not use this field, so its value is meaningless. gr_gid The group ID of the group. gr_mem The members of the group. OSS supports the following POSIX.
PAGE 438
Guardian Native C Library Calls (g - i) getgrnam_r(3) RETURN VALUES Upon successful completion, the getgrnam_r( ) function returns 0 (zero). Otherwise, the function returns an error number, as described in the ERRORS subsection of this reference page. ERRORS If any of these conditions occur, the getgrnam_r( ) function returns the corresponding value: [EAGAIN] A system resource is temporarily unavailable. The function cannot allocate sufficient heap space to complete the call.
PAGE 439
get_max_assign_msg_ordinal(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 440
Guardian Native C Library Calls (g - i) get_max_assign_msg_ordinal(3) STANDARDS CONFORMANCE The get_max_assign_msg_ordinal( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 441
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 442
Guardian Native C Library Calls (g - i) getopt(3) EXAMPLES The following example shows a suggested way to use the getopt( ) function. #include
PAGE 443
getopt(3) Guardian Native C Library Calls Reference Manual • The argv[optind] result is NULL. • The *argv[optind] result is not the special - (dash) flag. • 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 444
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 445
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 446
Guardian Native C Library Calls (g - i) get_param_msg(3) RETURN VALUES If the param message is found, the value 0 (zero) is returned. If the param message is not found, -1 is returned. 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 447
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include
PAGE 448
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 thread-specific area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 449
getpwent_r(3) Guardian Native C Library Calls Reference Manual NAME getpwent_r - Gets user attribute information from the user database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes that do not use Standard POSIX Threads: $SYSTEM.ZDLLnnn.
PAGE 450
Guardian Native C Library Calls (g - i) getpwent_r(3) H06.21 and later H-series RVUs and J06.10 and later J-series RVUs The user information is updated in the structure pointed to by the pwd parameter and a pointer to that structure is stored at the location pointed to by the result parameter. Storage referenced by the pwd structure is allocated from the memory provided with the buffer parameter, which is buflen bytes in size.
PAGE 451
getpwent_r(3) Guardian Native C Library Calls Reference Manual If you are NOT using the Standard POSIX Threads Library (this is not a threaded application or you are using the POSIX User Thread Model Library), you must: • Include the pwd.h header file To use the Standard POSIX Threads library, you must: • Include the spthread.
PAGE 452
Guardian Native C Library Calls [ERANGE] (g - i) getpwent_r(3) Insufficient storage was supplied via buffer and buflen to contain the data to be referenced by the resulting passwd structure. RELATED INFORMATION Functions: endpwent(3), getpwnam(3), getpwnam_r(3), getpwent(3), getpwuid(3), getpwuid_r(3), setpwent(3). STANDARDS CONFORMANCE H06.21 and later H-series RVUs and J06.10 and later J-series RVUs This function conforms to IEEE Std 1003.1 2004, POSIX System Application Program Interface.
PAGE 453
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include
PAGE 454
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 thread-specific area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 455
getpwnam_r(3) Guardian Native C Library Calls Reference Manual NAME getpwnam_r - Gets user attribute information from the user database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes that do not use Standard POSIX Threads: $SYSTEM.ZDLLnnn.
PAGE 456
Guardian Native C Library Calls (g - i) pw_passwd The current user password (not returned). pw_uid The user ID of the user. pw_gid The group ID of the primary group of the user. pw_age The password aging string (not returned). getpwnam_r(3) pw_comment Comment string (not returned). pw_gecos Personal information about the user (not returned). pw_dir The home directory of the user. pw_shell The initial program for the user.
PAGE 457
getpwnam_r(3) • Guardian Native C Library Calls Reference Manual Compile your application using the #define _SPT_MODEL_ macro or an equivalent compiler command option For more information about threaded and 64-bit applications in the OSS environment, see the Open System Services Programmer’s Guide. RETURN VALUES Upon successful completion, the getpwnam( ) function returns a 0 (zero). Otherwise, a nonzero error number is returned and errno is set to indicate the error.
PAGE 458
Guardian Native C Library Calls (g - i) getpwuid(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include #include
PAGE 459
getpwuid(3) Guardian Native C Library Calls Reference Manual when linking user applications. 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 thread-specific area and is overwritten on subsequent calls to the getpwent( ), getpwnam( ), or getpwuid( ) function.
PAGE 460
Guardian Native C Library Calls (g - i) getpwuid_r(3) NAME getpwuid_r - Gets user attribute information from the user database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes that do not use Standard POSIX Threads: $SYSTEM.ZDLLnnn.
PAGE 461
getpwuid_r(3) Guardian Native C Library Calls Reference Manual User Structure The user passwd structure returned by the getpwuid_r( ) function is defined in the pwd.h header file. The structure contains the following fields: pw_name The user login name. pw_passwd The current user password (not returned). pw_uid The user ID of the user. pw_gid The group ID of the primary group of the user. pw_age The password aging string (not returned). pw_comment Comment string (not returned).
PAGE 462
Guardian Native C Library Calls (g - i) getpwuid_r(3) • Include the spthread.h header file • Link your application to the Standard POSIX Threads Library: /G/system/sysnn/zsptsrl (G-series) or /G/system/zdllnnn/zsptdll (H-series or J-series) • Compile your application using the #define _SPT_MODEL_ macro or an equivalent compiler command option For more information about threaded and 64-bit applications in the OSS environment, see the Open System Services Programmer’s Guide.
PAGE 463
getpwuid_r(3) Guardian Native C Library Calls Reference Manual Standard POSIX Threads Library This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
PAGE 464
Guardian Native C Library Calls (g - i) gets(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 465
gets(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. 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 466
Guardian Native C Library Calls (g - i) get_startup_msg(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 467
get_startup_msg(3) Guardian Native C Library Calls Reference Manual { 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 468
Guardian Native C Library Calls (g - i) get_startup_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_param_msg(3). STANDARDS CONFORMANCE The get_startup_msg( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 469
getw(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 470
Guardian Native C Library Calls (g - i) getw(3) [EOVERFLOW] An attempt was made to read at or beyond the file offset maximum. 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 471
getwc(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 472
Guardian Native C Library Calls (g - i) getwc(3) RELATED INFORMATION Functions: fgetwc(3), fopen(3), fread(3), getc(3), gets(3), getwchar(3), putwc(3), scanf(3).
PAGE 473
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 474
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 475
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 476
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 477
gmtime_r(3) Guardian Native C Library Calls Reference Manual NAME gmtime_r - Converts time since the Epoch to broken-down Coordinated Universal Time (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 478
Guardian Native C Library Calls • (g - i) gmtime_r(3) Compile your application using the #define_SPT_MODEL_ macro or an equivalent compiler command option. For more detailed information about writing multi-threaded or 64-bit applications for the Open System Services environment, see the Open System Services Programmer’s Guide.
PAGE 479
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 480
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include void hdestroy(void); PARAMETERS None.
PAGE 481
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 482
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 483
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 484
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 485
hsearch(3) Guardian Native C Library Calls Reference Manual ERRORS If any of the following conditions occurs, the hsearch( ) function sets errno to the value that corresponds to the condition. [ENOMEM] The table is full. [ESRCH] The search failed. RELATED INFORMATION Functions: bsearch(3), hcreate(3), hdestroy(3), lsearch(3), tsearch(3), qsort(3).
PAGE 486
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 487
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−88 • 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 488
Guardian Native C Library Calls (g - i) hypotf(3) NAME hypotf - Computes the Euclidean distance function for float values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float hypotf( float x, float y ); PARAMETERS x Specifies a float value. y Specifies a float value.
PAGE 489
hypotl(3) Guardian Native C Library Calls Reference Manual NAME hypotl - Computes the Euclidean distance function for long double values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double hypotl( long double x, long double y ); PARAMETERS x Specifies a long double value.
PAGE 490
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 491
ilogbf(3) Guardian Native C Library Calls Reference Manual NAME ilogbf - Computes the radix-independent exponent of a float value as an integer LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int ilogbf( float x); PARAMETERS x Specifies the float value for which the exponent is to be calculated.
PAGE 492
Guardian Native C Library Calls (g - i) ilogbl(3) NAME ilogbl - Computes the radix-independent exponent of a long double value as an integer LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 493
imaxabs(3) Guardian Native C Library Calls Reference Manual NAME imaxabs - Computes absolute value of integer LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include intmax_t imaxabs( intmax_t j); PARAMETERS j Specifies an integer.
PAGE 494
Guardian Native C Library Calls (g - i) imaxdiv(3) NAME imaxdiv - Divides integers LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include imaxdiv_t imaxdiv ( intmax_t numerator, intmax_t denominator); PARAMETERS numerator Specifies an integer. denominator Specifies an integer.
PAGE 495
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/sysnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/sysnn/ycredll SYNOPSIS #include
PAGE 496
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 497
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 498
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 499
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 500
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 and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include int isatty( int filedes); PARAMETERS filedes Specifies an open file descriptor.
PAGE 501
isblank(3) Guardian Native C Library Calls Reference Manual NAME isblank - Tests for a white space character LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int isblank( int c); PARAMETERS c Specifies the character to be tested.
PAGE 502
Guardian Native C Library Calls (g - i) iscntrl(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 503
isdigit(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 504
Guardian Native C Library Calls (g - i) isfinite(3) NAME isfinite - Tests for finite value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int isfinite( floating-type x); PARAMETERS floating-type Specifies the floating-type of x. x Specifies a value of type floating-type.
PAGE 505
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 506
Guardian Native C Library Calls (g - i) isgreater(3) NAME isgreater - Tests if x is greater than y LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int isgreater( floating-type x, floating-type y); PARAMETERS floating-type Specifies the floating-type of x. x Specifies a value of type floating-type.
PAGE 507
isgreaterequal(3) Guardian Native C Library Calls Reference Manual NAME isgreaterequal - Tests if x is greater than or equal to y LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int isgreaterequal( floating-type x, floating-type y); PARAMETERS floating-type Specifies the floating-type of x.
PAGE 508
Guardian Native C Library Calls (g - i) isinf(3) NAME isinf - Tests for infinity LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int isinf( floating-type x); PARAMETERS floating-type Specifies the floating-type of x. x Specifies a value of type floating-type.
PAGE 509
isless(3) Guardian Native C Library Calls Reference Manual NAME isless - Tests if x is less than y LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int isless( floating-type x, floating-type y); PARAMETERS floating-type Specifies the floating-type of x. x Specifies a value of type floating-type.
PAGE 510
Guardian Native C Library Calls (g - i) islessequal(3) NAME islessequal - Tests if x is less than or equal to y LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int islessequal( floating-type x, floating-type y); PARAMETERS floating-type Specifies the floating-type of x.
PAGE 511
islessgreater(3) Guardian Native C Library Calls Reference Manual NAME islessgreater - Tests if x is less than or greater than y LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int islessgreater( floating-type x, floating-type y); PARAMETERS floating-type Specifies the floating-type of x.
PAGE 512
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 513
isnan(3) Guardian Native C Library Calls Reference Manual NAME isnan - Tests whether a value is NaN (not a number) LIBRARY isnan( ) Macro H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll isnan( ) Function G-series native Guardian processes: $SYSTEM.SYSnn.
PAGE 514
Guardian Native C Library Calls (g - i) isnan(3) compiler directive. NOTES isnan( ) Macro The isnan( ) macro is implemented only for the IEEE_float floating-point option. Applications using this macro cannot be compiled if the specified floating-point option is Tandem_float. isnan( ) Function Tandem floating-point format does not support NaN values; the isnan( ) function returns a value of 0 (zero) for Tandem floating-point data.
PAGE 515
isnormal(3) Guardian Native C Library Calls Reference Manual NAME isnormal - Tests for a normalized value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int isnormal( floating-type x); PARAMETERS floating-type Specifies the floating-type of x. x Specifies a value of type floating-type.
PAGE 516
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 517
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 518
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 519
isunordered(3) Guardian Native C Library Calls Reference Manual NAME isunordered - Tests if x and y are unordered LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int isunordered( floating-type x, floating-type y); PARAMETERS floating-type Specifies the floating-type of x.
PAGE 520
Guardian Native C Library Calls (g - i) isupper(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 521
iswalnum(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 522
Guardian Native C Library Calls (g - i) iswalpha(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 523
iswblank(3) Guardian Native C Library Calls Reference Manual NAME iswblank - Tests for a white space wide-character LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int iswblank( wint_t c); PARAMETERS c Specifies the character to be tested.
PAGE 524
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 525
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 526
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 527
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 528
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 529
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 530
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 531
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 532
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 533
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 534
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 535
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 536
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 537
Guardian Native C Library Calls • 527192-018 (j - m) j0(3) errno is not set to [ERANGE] when underflow occurs.
PAGE 538
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 539
Guardian Native C Library Calls • 527192-018 (j - m) j1(3) errno is not set to [ERANGE] when underflow occurs.
PAGE 540
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 541
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-018 • 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 542
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 543
Guardian Native C Library Calls (j - m) jrand48(3) 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 jrand48( ) function returns signed long integers uniformly distributed over the range $-2 sup 31˜<=˜y˜<˜2 sup 31$.
PAGE 544
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 545
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 546
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 547
Guardian Native C Library Calls (j - m) lcong48(3) RELATED INFORMATION Functions: drand48(3), erand48(3), fp_class(3), isnan(3), jrand(3), lrand48(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 548
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 549
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 550
ldexpf(3) Guardian Native C Library Calls Reference Manual NAME ldexpf - Multiplies a float number by a power of 2 LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float ldexpf( float value, int exp ); PARAMETERS value Specifies the float value to be multiplied by a power of 2.
PAGE 551
Guardian Native C Library Calls (j - m) ldexpf(3) RELATED INFORMATION Functions: fp_class(3), frexp(3), isnan(3), ldexp(3), ldexpl(3), modf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 552
ldexpl(3) Guardian Native C Library Calls Reference Manual NAME ldexpl - Multiplies a long double number by a power of 2 LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double ldexpl( long double value, int exp ); PARAMETERS value Specifies the long double value to be multiplied by a power of 2.
PAGE 553
Guardian Native C Library Calls (j - m) ldexpl(3) RELATED INFORMATION Functions: fp_class(3), frexp(3), isnan(3), ldexp(3), ldexpf(3), modf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 554
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 555
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include
PAGE 556
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 557
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 558
lgammaf(3) Guardian Native C Library Calls Reference Manual NAME lgammaf - Computes the logarithm of the gamma function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float lgammaf( float x); extern int signgam; PARAMETERS x Specifies a positive float value.
PAGE 559
Guardian Native C Library Calls (j - m) lgammaf(3) RETURN VALUES Upon successful completion, the lgammaf( ) 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_VALF is returned and errno is set to [EDOM]. If the value of x is 0.0 (zero), HUGE_VALF is returned and errno is set to [EDOM].
PAGE 560
lgammal(3) Guardian Native C Library Calls Reference Manual NAME lgammal - Computes the logarithm of the gamma function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double lgammal( long double x); extern int signgam; PARAMETERS x Specifies a positive long double value.
PAGE 561
Guardian Native C Library Calls (j - m) lgammal(3) RETURN VALUES Upon successful completion, the lgammal( ) 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_VALL is returned and errno is set to [EDOM]. If the value of x is 0.0 (zero), HUGE_VALL is returned and errno is set to [EDOM].
PAGE 562
lgamma_r(3) Guardian Native C Library Calls Reference Manual NAME lgamma_r - Computes the logarithm of the gamma function (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 563
Guardian Native C Library Calls (j - m) lgamma_r(3) fp_class(3) reference page. Guardian functions are available to convert between floating-point formats. For a discussion of floating-point conversions, refer to the Guardian Programmer’s Guide. On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use either the POSIX User Thread Model library or the Standard POSIX Threads library for threaded applications.
PAGE 564
llabs(3) Guardian Native C Library Calls Reference Manual NAME llabs - Computes absolute value of long long integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 565
Guardian Native C Library Calls (j - m) lldiv(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 566
llrint(3) Guardian Native C Library Calls Reference Manual NAME llrint - Rounds floating-point number to nearest long long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long long int llrint( double x); PARAMETERS x Is the double value to be rounded.
PAGE 567
Guardian Native C Library Calls (j - m) llrintf(3) NAME llrintf - Rounds float number to nearest long long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long long int llrintf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 568
llrintl(3) Guardian Native C Library Calls Reference Manual NAME llrintl - Rounds long double number to nearest long long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long long int llrintl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 569
Guardian Native C Library Calls (j - m) llround(3) NAME llround - Rounds floating-point number to nearest long long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long long int llround( double x); PARAMETERS x Is the double value to be rounded.
PAGE 570
llroundf(3) Guardian Native C Library Calls Reference Manual NAME llroundf - Rounds float number to nearest long long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long long int llroundf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 571
Guardian Native C Library Calls (j - m) llroundl(3) NAME llroundl - Rounds long double number to nearest long long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long long int llroundl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 572
localeconv(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 573
Guardian Native C Library Calls (j - m) localeconv(3) 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 574
localeconv(3) Guardian Native C Library Calls Reference Manual _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 575
Guardian Native C Library Calls (j - m) localtime(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 576
localtime_r(3) Guardian Native C Library Calls Reference Manual NAME localtime_r - Converts time since the Epoch to broken-down local time (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 577
Guardian Native C Library Calls • (j - m) localtime_r(3) Compile your application using the #define_SPT_MODEL_ macro or an equivalent compiler command option. For more detailed information about writing multi-threaded or 64- bit applications for the Open System Services environment, see the Open System Services Programmer’s Guide.
PAGE 578
log10(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 579
Guardian Native C Library Calls (j - m) log10(3) The XPG4 specification leaves some features to the implementing vendor to define. The following feature is affected in the HP implementation: • 527192-018 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 580
log10f(3) Guardian Native C Library Calls Reference Manual NAME log10f - Computes the base 10 logarithm function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float log10f( float x); PARAMETERS x Specifies a float value.
PAGE 581
Guardian Native C Library Calls (j - m) log10l(3) NAME log10l - Computes the base 10 logarithm function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double log10l( long double x); PARAMETERS x Specifies a long double value.
PAGE 582
log1p(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 583
Guardian Native C Library Calls 527192-018 (j - m) Hewlett-Packard Company log1p(3) 4−49
PAGE 584
log1pf(3) Guardian Native C Library Calls Reference Manual NAME log1pf - Computes the natural logarithm function of 1.0 plus x for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float log1pf( float x); PARAMETERS x Is the float value for which the natural logarithm is to be calculated.
PAGE 585
Guardian Native C Library Calls (j - m) log1pf(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 586
log1pl(3) Guardian Native C Library Calls Reference Manual NAME log1pl - Computes the natural logarithm function of 1.0 plus x for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 587
Guardian Native C Library Calls (j - m) log1pl(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 588
log2(3) Guardian Native C Library Calls Reference Manual NAME log2 - Computes the base-2 logarithm function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double log2( double x); PARAMETERS x Specifies a double value. DESCRIPTION The log2( ) function computes the base-2 logarithm of x.
PAGE 589
Guardian Native C Library Calls (j - m) log2f(3) NAME log2f - Computes the base-2 logarithm function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float log2f( float x); PARAMETERS x Specifies a float value.
PAGE 590
log2l(3) Guardian Native C Library Calls Reference Manual NAME log2l - Computes the base-2 logarithm function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double log2l( long double x); PARAMETERS x Specifies a long double value.
PAGE 591
Guardian Native C Library Calls (j - m) log(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 592
log(3) Guardian Native C Library Calls Reference Manual The XPG4 specification leaves some features to the implementing vendor to define. The following features are affected in the HP implementation: • 4−58 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 593
Guardian Native C Library Calls (j - m) logb(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 594
logb(3) Guardian Native C Library Calls Reference Manual 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: • 4−60 For IEEE floating-point data, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 595
Guardian Native C Library Calls (j - m) logbf(3) NAME logbf - Computes the radix-independent exponent as a float number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float logbf( float x); PARAMETERS x Specifies the float value for which the exponent is to be calculated.
PAGE 596
logbf(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fp_class(3), ilogb(3), isnan(3), logb(3), logbl(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 597
Guardian Native C Library Calls (j - m) logbl(3) NAME logbl - Computes the radix-independent exponent as a long double number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double logbl( long double x); PARAMETERS x Specifies the long double value for which the exponent is to be calculated.
PAGE 598
logbl(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fp_class(3), ilogb(3), isnan(3), logb(3), logbf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 599
Guardian Native C Library Calls (j - m) logf(3) NAME logf - Computes the natural logarithm function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float logf( float x); PARAMETERS x Specifies a float value.
PAGE 600
logl(3) Guardian Native C Library Calls Reference Manual NAME logl - Computes the natural logarithm function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double logl( long double x); PARAMETERS x Specifies a long double value.
PAGE 601
Guardian Native C Library Calls (j - m) longjmp(3) NAME longjmp - Performs a nonlocal goto LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series and J-series native Guardian processes: implicit libraries H-series and J-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 602
longjmp(3) Guardian Native C Library Calls Reference Manual 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 603
Guardian Native C Library Calls (j - m) longlong_to_dec(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 604
longlong_to_dec(3) Guardian Native C Library Calls Reference Manual 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 605
Guardian Native C Library Calls (j - m) lrand48(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 606
lrand48(3) Guardian Native C Library Calls Reference Manual RETURN VALUES The lrand48( ) 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), 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 607
Guardian Native C Library Calls (j - m) lrint(3) NAME lrint - Rounds floating-point number to nearest long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long int lrint( double x); PARAMETERS x Is the double value to be rounded.
PAGE 608
lrintf(3) Guardian Native C Library Calls Reference Manual NAME lrintf - Rounds float number to nearest long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long int lrintf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 609
Guardian Native C Library Calls (j - m) lrintl(3) NAME lrintl - Rounds long double number to nearest long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long int lrintl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 610
lround(3) Guardian Native C Library Calls Reference Manual NAME lround - Rounds floating-point number to nearest long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long int lround( double x); PARAMETERS x Is the double value to be rounded.
PAGE 611
Guardian Native C Library Calls (j - m) lroundf(3) NAME lroundf - Rounds float number to nearest long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long int lroundf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 612
lroundl(3) Guardian Native C Library Calls Reference Manual NAME lroundl - Rounds long double number to nearest long integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long int lroundl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 613
Guardian Native C Library Calls (j - m) lsearch(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include
PAGE 614
lsearch(3) Guardian Native C Library Calls Reference Manual ERRORS There are no errors defined for this function. RELATED INFORMATION Functions: bsearch(3), hsearch(3), find(3), tsearch(3), qsort(3).
PAGE 615
Guardian Native C Library Calls (j - m) malloc(3) NAME malloc - Allocates memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include #include
PAGE 616
malloc_pages(3) Guardian Native C Library Calls Reference Manual NAME malloc_pages - Provides a memory page allocator LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include #include void *malloc_pages ( size_t size ); PARAMETERS size Specifies the number of bytes of memory to be allocated.
PAGE 617
Guardian Native C Library Calls (j - m) _max(3) 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. expr2 Is an expression of the same type as expr1.
PAGE 618
mblen(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 619
Guardian Native C Library Calls (j - m) mblen(3) RELATED INFORMATION Functions: mbtowc(3), wctomb(3), mbstowcs(3), wcstombs(3).
PAGE 620
mbrlen(3) Guardian Native C Library Calls Reference Manual NAME mbrlen - Get the number of bytes in a character (restartable) LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include size_t mbrlen( const char *s, size_t n, mbstate_t *ps ); PARAMETERS s Points to the character.
PAGE 621
Guardian Native C Library Calls [EILSEQ] (j - m) mbrlen(3) An invalid character sequence is detected. RELATED INFORMATION Functions: mbsinit(3). STANDARDS CONFORMANCE The behavior of this function conforms to the ISO/IEC 9899:1999 standard.
PAGE 622
mbrtowc(3) Guardian Native C Library Calls Reference Manual NAME mbrtowc - Convert a character to a wide-character (restartable) LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include size_t mbrtowc( wchar_t *s, const char *s, size_t n, mbstate_t *ps ); PARAMETERS pwc Points to the wide-character object.
PAGE 623
Guardian Native C Library Calls (size_t)-1 (j - m) mbrtowc(3) If an encoding error orccurs, in which case the next n or fewer bytes do not contribute to a complete and valid character. In this case, errno is set to [EILSEQ], and the conversion state is undefined. ERRORS If any of these conditions occurs, errno is set to the corresponding value: [EINVAL] The ps parmeter points to an object that contains an invalid conversion state. [EILSEQ] An invalid character sequence is detected.
PAGE 624
mbsinit(3) Guardian Native C Library Calls Reference Manual NAME mbsinit - determine conversion object status LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int mbsinit(const mbstate_t *ps); PARAMETERS ps Points to the mbstate_t object to be evaluated.
PAGE 625
Guardian Native C Library Calls (j - m) mbsrtowcs(3) NAME mbsrtowcs - Convert a character string to a wide-character string (restartable) LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 626
mbsrtowcs(3) Guardian Native C Library Calls Reference Manual ERRORS If any of these conditions occurs, errno is set to the corresponding value: [EINVAL] The ps parmeter points to an object that contains an invalid conversion state. [EILSEQ] An invalid character sequence is detected. RELATED INFORMATION Functions: mbsinit(3). STANDARDS CONFORMANCE The behavior of this function conforms to the ISO/IEC 9899:1999 standard.
PAGE 627
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 628
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 629
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 630
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 631
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 632
memchr64(3) Guardian Native C Library Calls Reference Manual NAME memchr64 - Finds a character byte in memory LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include void _ptr64 *memchr64( const void _ptr64 *s, int c, unsigned long long n); PARAMETERS s Points to the location of a string. c Specifies a byte for which to search. n Specifies the number of bytes to search.
PAGE 633
Guardian Native C Library Calls (j - m) memcmp(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 634
memcmp64(3) Guardian Native C Library Calls Reference Manual NAME memcmp64 - Compares characters in memory LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include int memcmp64( const void _ptr64 *s1, const void _ptr64 *s2, unsigned long long n); PARAMETERS s1 Points to the location of a destination string. s2 Points to the location of a source string. n Specifies the number of bytes to search.
PAGE 635
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 636
memcpy64(3) Guardian Native C Library Calls Reference Manual NAME memcpy64 - Copies a character in memory LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include void _ptr64 *memcpy64( void _ptr64 *s1, const void _ptr64 *s2, unsigned long long n); PARAMETERS s1 Points to the location of a destination string. s2 Points to the location of a source string. n Specifies the number of bytes to copy.
PAGE 637
Guardian Native C Library Calls (j - m) memmove(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 638
memmove64(3) Guardian Native C Library Calls Reference Manual NAME memmove64 - Copies characters with overlapping areas in memory LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include void _ptr64 *memmove64( void _ptr64 *s1, const void _ptr64 *s2, unsigned long long n); PARAMETERS s1 Points to the location of a destination string. s2 Points to the location of a source string.
PAGE 639
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 640
memset64(3) Guardian Native C Library Calls Reference Manual NAME memset64 - Sets characters in memory LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include void _ptr64 *memset64( void _ptr64 *s, int c, unsigned long long n); PARAMETERS s Points to the location of a string. c Specifies a byte for which c is the target of the copy. n Specifies the number of bytes to copy.
PAGE 641
Guardian Native C Library Calls (j - m) _min(3) 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 642
mktime(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 643
Guardian Native C Library Calls (j - m) mktime(3) 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 644
modf(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 645
Guardian Native C Library Calls (j - m) 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 leaves some features to the implementing vendor to define.
PAGE 646
modff(3) Guardian Native C Library Calls Reference Manual NAME modff - Breaks a float number into integral and fractional parts LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 647
Guardian Native C Library Calls (j - m) modff(3) RELATED INFORMATION Functions: fp_class(3), frexp(3), isnan(3), ldexp(3), modf(3), modfl(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 648
modfl(3) Guardian Native C Library Calls Reference Manual NAME modfl - Breaks a long double number into integral and fractional parts LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 649
Guardian Native C Library Calls (j - m) modfl(3) RELATED INFORMATION Functions: fp_class(3), frexp(3), isnan(3), ldexp(3), modf(3), modff(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 650
mrand48(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 651
Guardian Native C Library Calls (j - m) mrand48(3) RETURN VALUES The mrand48( ) 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), 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 652
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 653
nan(3) Guardian Native C Library Calls Reference Manual NAME nan - Returns quiet Nan for specified string LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double nan( const char *tagp); PARAMETERS tagp Specifies the string. DESCRIPTION The nan( ) function returns a quiet NaN from the specified string.
PAGE 654
Guardian Native C Library Calls (n - r) nanf(3) NAME nanf - Returns a float quiet NaN for specified string LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float nan( const char *tagp); PARAMETERS tagp Specifies the string.
PAGE 655
nanl(3) Guardian Native C Library Calls Reference Manual NAME nanl - Returns a long double quiet NaN for specified string LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double nanl( const char *tagp); PARAMETERS tagp Specifies the string.
PAGE 656
Guardian Native C Library Calls (n - r) nearbyint(3) NAME nearbyint - Rounds floating-point number to nearest integral value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double nearbyint( double x); PARAMETERS x Is the double value to be rounded.
PAGE 657
nearbyintf(3) Guardian Native C Library Calls Reference Manual NAME nearbyintf - Rounds float number to nearest integral value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float nearbyintf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 658
Guardian Native C Library Calls (n - r) nearbyintl(3) NAME nearbyintl - Rounds long double number to nearest integral value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double nearbyintl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 659
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 660
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 661
nextafterf(3) Guardian Native C Library Calls Reference Manual NAME nextafterf - Computes the next representable float number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float nextafterf( float x, float y ); PARAMETERS x Is a float number. y Is a float number.
PAGE 662
Guardian Native C Library Calls (n - r) nextafterf(3) ERRORS If any of the following conditions occurs, the nextafterf( ) function sets errno to the corresponding value: [ERANGE] The return value would cause an overflow. RELATED INFORMATION Functions: fp_class(3), nextafter(3), nextafterl(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 663
nextafterl(3) Guardian Native C Library Calls Reference Manual NAME nextafterl - Computes the next representable float number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double nextafterl( long double x, long double y ); PARAMETERS x Is a long double number. y Is a long double number.
PAGE 664
Guardian Native C Library Calls (n - r) nextafterl(3) ERRORS If any of the following conditions occurs, the nextafterl( ) function sets errno to the corresponding value: [ERANGE] The return value would cause an overflow. RELATED INFORMATION Functions: fp_class(3), nextafter(3), nextafterf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 665
nexttoward(3) Guardian Native C Library Calls Reference Manual NAME nexttoward - Computes the next representable floating-point number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double nexttoward( double x, long double y ); PARAMETERS x Is a double number. y Is a long double number.
PAGE 666
Guardian Native C Library Calls (n - r) nexttoward(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 667
nexttowardf(3) Guardian Native C Library Calls Reference Manual NAME nexttowardf - Computes the next representable float number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float nexttowardf( float x, long double y ); PARAMETERS x Is a float number. y Is a long double number.
PAGE 668
Guardian Native C Library Calls (n - r) nexttowardf(3) RELATED INFORMATION Functions: nextafter(3), nexttoward(3), nexttowardl(3). Files: math(4). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 669
nexttowardl(3) Guardian Native C Library Calls Reference Manual NAME nexttowardl - Computes the next representable long double number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double nexttowardl( long double x, long double y ); PARAMETERS x Is a long double number. y Is a long double number.
PAGE 670
Guardian Native C Library Calls (n - r) nexttowardl(3) RELATED INFORMATION Functions: nextafter(3), nexttoward(3), nexttowardf(3). Files: math(4). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 671
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 672
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 673
nrand48(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 nrand48( ) function returns signed long integers uniformly distributed over the range $0˜<=˜y<˜2 sup 31$.
PAGE 674
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 675
__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_backup_fopen64(3), __ns_fget_file_open_state(3), __ns_fget_file_state(3), __ns_fopen_special(3), __ns_fopen64_special(3), __ns_fset_file_state(3), __ns_start_backup(3).
PAGE 676
Guardian Native C Library Calls (n - r) __ns_backup_fopen64(3) NAME __ns_backup_fopen64 - 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 677
__ns_backup_fopen64(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, a pointer to the FILE structure denoting the file is returned. Otherwise, a null pointer is returned. ERRORS If any of these conditions occurs, the __ns_backup_fopen64( ) function sets errno to the corresponding value: • [ENOIMEM], if insufficient memory is available. • An fopen64( ) function errno value, if an error occurs on the file open.
PAGE 678
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 679
__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 680
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 681
__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 682
Guardian Native C Library Calls (n - r) __ns_fopen64_special(3) NAME __ns_fopen64_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 683
__ns_fopen64_special(3) Guardian Native C Library Calls Reference Manual If a device does not support the sync-id mechanism and a sync_depth value is specified, a value of 1 (one) is used for sync_depth. If you include a system name in the filename, you must precede the system name with two backslashes instead of one because backslash is an escape character in C. For example, to open the file \SYS.$VOL.SVOL.FILE, you would use the C string: "\\SYS.$VOL.SVOL.FILE".
PAGE 684
Guardian Native C Library Calls (n - r) __ns_fopen64_special(3) RETURN VALUES Upon successful completion, a pointer to the FILE structure denoting the open file is returned. Otherwise, a NULL pointer is returned. ERRORS If any of these conditions occurs, the __ns_fopen64_special( ) function sets errno to the corresponding value: [ENOIMEM] Insufficient memory is available. [EINVAL] An invalid argument is specified. fopen64( ) function errno value An error occurred on the file open.
PAGE 685
__ns_fopen_special(3) Guardian Native C Library Calls Reference Manual 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 686
Guardian Native C Library Calls (n - r) __ns_fopen_special(3) The default number of secondary extents for files created by __ns_fopen_special( ) is 16. The default number of maxextents for files created by __ns_fopen_special( ) is 500. For complete details on active backup programming in C, see the Guardian Programmer’s Guide. Access Mode Values The possible values of the string access_mode are: r Open an existing text file for read-only access.
PAGE 687
__ns_fopen_special(3) [EINVAL] Guardian Native C Library Calls Reference Manual An invalid argument is specified. fopen( ) function errno value An error occurred on the file open. RELATED INFORMATION Functions: __ns_backup_fopen(3), __ns_backup_fopen64(3), __ns_fget_file_open_state(3), __ns_fget_file_state(3), __ns_fopen64_special(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 688
Guardian Native C Library Calls (n - r) __ns_fset_file_state(3) 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 689
__ns_fset_file_state(3) Guardian Native C Library Calls Reference Manual — 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 690
Guardian Native C Library Calls (n - r) __ns_start_backup(3) 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 691
__ns_start_backup(3) Guardian Native C Library Calls Reference Manual 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 692
Guardian Native C Library Calls (n - r) __ns_start_backup(3) 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 693
perror(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include
PAGE 694
Guardian Native C Library Calls (n - r) pow(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 695
pow(3) Guardian Native C Library Calls Reference Manual For IEEE floating-point data: 5−44 • If the value of x is NaN and the value of y is not 0.0 (zero), NaN is returned. • 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.
PAGE 696
Guardian Native C Library Calls (n - r) pow(3) • If the value of x is positive or negative 0.0 (zero) and the value of y is an odd integral value greater than 0.0 (zero), positive or negative 0.0 (zero) is returned. • 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.
PAGE 697
powf(3) Guardian Native C Library Calls Reference Manual NAME powf - Computes the power function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float powf( float x, float y ); PARAMETERS x Specifies a float value. y Specifies a float value.
PAGE 698
Guardian Native C Library Calls (n - r) powf(3) For IEEE floating-point data: 527192-018 • If the value of x is NaN and the value of y is not 0.0 (zero), NaN is returned. • 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_VALF 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.
PAGE 699
powf(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 an odd integral value greater than 0.0 (zero), positive or negative 0.0 (zero) is returned. • 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.
PAGE 700
Guardian Native C Library Calls (n - r) powl(3) NAME powl - Computes the power function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double powl( long double x, long double y ); PARAMETERS x Specifies a long double value. y Specifies a long double value.
PAGE 701
powl(3) Guardian Native C Library Calls Reference Manual For IEEE floating-point data: 5−50 • If the value of x is NaN and the value of y is not 0.0 (zero), NaN is returned. • 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_VALL 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.
PAGE 702
Guardian Native C Library Calls (n - r) powl(3) • If the value of x is positive or negative 0.0 (zero) and the value of y is an odd integral value greater than 0.0 (zero), positive or negative 0.0 (zero) is returned. • 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.
PAGE 703
printf(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 704
Guardian Native C Library Calls • (n - r) printf(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 705
printf(3) Guardian Native C Library Calls Reference Manual • An optional parameter indicating the size of the argument corresponding to the following character, 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 706
Guardian Native C Library Calls (n - r) printf(3) — A z followed by an n conversion specifier indicates that the argument will be treated as a pointer to a signed integer type corresponding to the size_t argument. • 527192-018 A character that indicates the type of conversion to be applied: % Performs no conversion. Prints %. d or i Accepts an integer (int) value and converts it to signed decimal notation. The precision specifies the minimum number of digits to appear.
PAGE 707
printf(3) Guardian Native C Library Calls Reference Manual specified). The E conversion character produces a number with uppercase E instead of lowercase e before the exponent. The exponent always contains at least two digits. If the value is 0 (zero), the exponent is 0 (zero). g or G Accepts a float or double value and converts it in the style of the e, E, or f conversion characters, with the precision specifying the number of significant digits. Trailing zeros are removed from the result.
PAGE 708
Guardian Native C Library Calls (n - r) printf(3) to the specified width. For TNS/E systems only, the behavior of ls is the same as the behavior of S. p Accepts a pointer to void. The value of the pointer is converted to a sequence of printable characters, the same as unsigned hexadecimal integer (x). n Accepts a pointer to an integer into which is written the number of characters written to the output stream so far by this call. No argument is converted.
PAGE 709
printf(3) Guardian Native C Library Calls Reference Manual [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write at or beyond the file offset maximum. [EILSEQ] An invalid wide character was detected. [EINTR] The operation was interrupted by a signal that was caught, and no data was transferred. [EINVAL] There are insufficient arguments.
PAGE 710
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 711
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 712
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 713
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. [EFBIG] An attempt was made to write at or beyond the file offset maximum.
PAGE 714
Guardian Native C Library Calls (n - r) putchar_unlocked(3) NAME putchar_unlocked - Writes a byte to the standard output stream but does not lock the stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int putchar_unlocked( int c); PARAMETERS c Specifies the character to be written.
PAGE 715
putchar_unlocked(3) Guardian Native C Library Calls Reference Manual • 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 716
Guardian Native C Library Calls (n - r) putc_unlocked(3) NAME putc_unlocked - Writes a byte to a specified output stream but does not lock the stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int putc_unlocked( int c, FILE *stream); PARAMETERS c Specifies the character to be written.
PAGE 717
putc_unlocked(3) Guardian Native C Library Calls Reference Manual RETURN VALUES If successful, the putc_unlocked( ) function and macro returns the value written. If this function or macro fails or a write error occurs, the error indicator for the stream is set, the integer constant EOF is returned, and errno is set to indicate the error. ERRORS The putc_unlocked( ) function fails if: • The stream parameter is not open for writing. • The output file size cannot be increased.
PAGE 718
Guardian Native C Library Calls (n - r) putc_unlocked(3) STANDARDS CONFORMANCE Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1-2004, POSIX System Application Program Interface The [ENOMEM] and [ENXIO] errno values are extensions to the XPG4 Version 2 specification.
PAGE 719
putenv(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 720
Guardian Native C Library Calls (n - r) putenv(3) STANDARDS CONFORMANCE The putenv( ) function behavior in Guardian processes is an HP extension to the XPG4 Version 2 specification.
PAGE 721
puts(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 722
Guardian Native C Library Calls (n - r) puts(3) [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 723
putw(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 724
Guardian Native C Library Calls (n - r) putw(3) [EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write at or beyond the file offset maximum. [EINTR] The write operation was interrupted by a signal that was caught, and no data was transferred.
PAGE 725
putwc(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS For TNS/E Target Compilations on H06.
PAGE 726
Guardian Native C Library Calls (n - r) putwc(3) RETURN VALUES Upon successful completion, this function returns the value written. If this function fails, it returns the constant WEOF. ERRORS If any of the following conditions occur, the putwc( ) function sets errno to the corresponding value. [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation.
PAGE 727
putwchar(3) Guardian Native C Library Calls Reference Manual NAME putwchar - Writes a wide character 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 728
Guardian Native C Library Calls (n - r) putwchar(3) ERRORS If any of the following conditions occur, the putwchar( ) function sets errno to the corresponding value. [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the standard output stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the standard output stream is not a valid file descriptor open for writing.
PAGE 729
putws(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 730
Guardian Native C Library Calls (n - r) putws(3) [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 731
qsort(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 732
Guardian Native C Library Calls (n - r) qsort(3) RELATED INFORMATION Functions: bsearch(3), tsearch(3).
PAGE 733
raise(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include int raise( int signal); PARAMETERS signal Specifies a signal number.
PAGE 734
Guardian Native C Library Calls (n - r) raise(3) STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 527192-018 The raise( ) function can return the errno value [ENOTOSS].
PAGE 735
rand(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 736
Guardian Native C Library Calls (n - r) random(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long random(void); PARAMETERS None.
PAGE 737
rand_r(3) Guardian Native C Library Calls Reference Manual NAME rand_r - Returns pseudorandom numbers (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 738
Guardian Native C Library Calls (n - r) rand_r(3) For more detailed information about writing multi-threaded or 64-bit applications for the Open System Services environment, see the Open System Services Programmer’s Guide. RETURN VALUES The rand_r( ) function returns the next pseudorandom number in the sequence. ERRORS No error values are returned. This function does not set the errno variable. RELATED INFORMATION Functions: rand(3).
PAGE 739
realloc(3) Guardian Native C Library Calls Reference Manual NAME realloc - Reallocates memory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include #include
PAGE 740
Guardian Native C Library Calls (n - r) re_comp(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 741
re_comp(3) Guardian Native C Library Calls Reference Manual those characters following the "ˆ" in the bracketed string. 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 742
Guardian Native C Library Calls (n - r) re_comp(3) 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 743
re_exec(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 744
Guardian Native C Library Calls (n - r) re_exec(3) 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. 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.
PAGE 745
re_exec(3) Guardian Native C Library Calls Reference Manual 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 746
Guardian Native C Library Calls (n - r) regcmp(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include char *regcmp(const char *string1, ...
PAGE 747
regcmp(3) Guardian Native C Library Calls Reference Manual 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 748
Guardian Native C Library Calls (n - r) regcomp(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 749
regcomp(3) pattern Guardian Native C Library Calls Reference Manual Contains the basic or extended regular expression to be compiled by regcomp( ). The default regular expression type for the pattern parameter is a basic regular expression. An application can specify extended regular expressions with the REG_EXTENDED flag.
PAGE 750
Guardian Native C Library Calls (n - r) regcomp(3) pmatch parameter points to an array of at least the number of elements specified by the nmatch parameter. The regexec( ) function fills in the elements of the array pointed to by the pmatch parameter with offsets of the substrings of the string parameter. The elements of the pmatch array correspond to the parenthetic subexpressions of the original pattern parameter that was specified to the regcomp( ) function. The pmatch[i].
PAGE 751
regcomp(3) Guardian Native C Library Calls Reference Manual The regfree( ) function frees any memory allocated by the regcomp( ) function associated with the preg parameter. An expression defined by the preg parameter is no longer treated as a compiled basic or extended regular expression after it is given to the regfree( ) function. EXAMPLES 1.
PAGE 752
Guardian Native C Library Calls (n - r) regcomp(3) return; } error = regexec(&preg, string, 1, &pmatch, 0); 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.
PAGE 753
regcomp(3) Guardian Native C Library Calls Reference Manual } else { printf( "There are %i subexpressions in re\n", preg.re_nsub); matches_tocheck = preg.
PAGE 754
Guardian Native C Library Calls (n - r) regcomp(3) REG_BADRPT The ?, *, or + symbols are not preceded by a valid basic regular expression or an extended regular expression. 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.
PAGE 755
regerror(3) Guardian Native C Library Calls Reference Manual NAME regerror - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 756
Guardian Native C Library Calls (n - r) regex(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 757
regex(3) Guardian Native C Library Calls Reference Manual (...)$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 758
Guardian Native C Library Calls (n - r) regexec(3) NAME regexec - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 759
regfree(3) Guardian Native C Library Calls Reference Manual NAME regfree - Performs regular expression matching DESCRIPTION See regcomp(3).
PAGE 760
Guardian Native C Library Calls (n - r) remainder(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 761
remainder(3) Guardian Native C Library Calls Reference Manual • 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: • 5−110 For IEEE floating-point values, this function does not set errno to [EDOM] if the value of x or y is NaN.
PAGE 762
Guardian Native C Library Calls (n - r) remainderf(3) NAME remainderf - Computes the remainder of a division operation for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS float remainderf( float x, float y ); PARAMETERS x Is a float number. y Is a float number.
PAGE 763
remainderf(3) Guardian Native C Library Calls Reference Manual • The value of the x parameter is positive or negative infinity. RELATED INFORMATION Functions: fp_class(3), isnan(3), remainder(3), remainderl(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 764
Guardian Native C Library Calls (n - r) remainderl(3) NAME remainderl - Computes the remainder of a division operation for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS long double remainderl( long double x, long double y ); PARAMETERS x Is a long double number. y Is a long double number.
PAGE 765
remainderl(3) Guardian Native C Library Calls Reference Manual • The value of the x parameter is positive or negative infinity. RELATED INFORMATION Functions: fp_class(3), isnan(3), remainder(3), remainderf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 766
Guardian Native C Library Calls (n - r) remove(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 767
remove_guardian(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 768
Guardian Native C Library Calls (n - r) remove_guardian(3) RELATED INFORMATION Functions: link(2), remove(3), remove_oss(3), rename(2). STANDARDS CONFORMANCE The remove_guardian( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 769
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 770
Guardian Native C Library Calls (n - r) remove_oss(3) remove_oss( ) is functionally identical to the remove( ) 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. remove_guardian( ) is functionally identical to the remove( ) function of the Guardian environment. It is the same as setting systype guardian at compile-time.
PAGE 771
remquo(3) Guardian Native C Library Calls Reference Manual NAME remquo - Computes the remainder of a division operation with quotient LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS double remquo( double x, double y int *quo); PARAMETERS x Is a double number that is the numerator of the division.
PAGE 772
Guardian Native C Library Calls (n - r) remquof(3) NAME remquof - Computes the remainder of a division operation with quotient for float values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS float remquof( float x, float y int *quo); PARAMETERS x Is a float number that is the numerator of the division.
PAGE 773
remquol(3) Guardian Native C Library Calls Reference Manual NAME remquol - Computes the remainder of a division operation with quotient for long double values LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 774
Guardian Native C Library Calls (n - r) rewind(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 775
rewind(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 is also sent to the process. 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 776
Guardian Native C Library Calls (n - r) rindex(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 777
rint(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 778
Guardian Native C Library Calls (n - r) rint(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-018 For IEEE floating-point values, this function does not set errno to [EDOM] if the value of x is NaN.
PAGE 779
rintf(3) Guardian Native C Library Calls Reference Manual NAME rintf - Rounds float number to nearest integral value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float rintf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 780
Guardian Native C Library Calls (n - r) rintf(3) No error values are returned. This function does not set errno. RELATED INFORMATION Functions: fp_class(3), isnan(3), rint(3), rintl(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 781
rintl(3) Guardian Native C Library Calls Reference Manual NAME rintl - Rounds long double number to nearest integral value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double rintl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 782
Guardian Native C Library Calls (n - r) rintl(3) No error values are returned. This function does not set errno. RELATED INFORMATION Functions: fp_class(3), isnan(3), rint(3), rintf(3). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 783
round(3) Guardian Native C Library Calls Reference Manual NAME round - Rounds floating-point number to nearest integer value in floating-point format LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double round( double x); PARAMETERS x Is the double value to be rounded.
PAGE 784
Guardian Native C Library Calls (n - r) roundf(3) NAME roundf - Rounds float number to nearest integer value in floating-point format LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float roundf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 785
roundl(3) Guardian Native C Library Calls Reference Manual NAME roundl - Rounds long double number to nearest integer value in floating-point format LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double roundl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 786
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 787
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 788
Guardian Native C Library Calls (s) scalb(3) 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-018 This function does not set errno to [EDOM] if the value of x or n is NaN.
PAGE 789
scalbln(3) Guardian Native C Library Calls Reference Manual NAME scalbln - Computes the long integral exponent of a radix-independent floating-point number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double scalbln( double x, long int n ); PARAMETERS x Is the double value to be multiplied.
PAGE 790
Guardian Native C Library Calls (s) scalbln(3) STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 791
scalblnf(3) Guardian Native C Library Calls Reference Manual NAME scalblnf - Computes the long integral exponent of a radix-independent float number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float scalblnf( float x, long int n ); PARAMETERS x Is the float value to be multiplied.
PAGE 792
Guardian Native C Library Calls (s) scalblnf(3) RELATED INFORMATION Functions: ilogb(3), ldexp(3), logb(3), scalb(3), scalbn(3), scalbnl(3), scalbln(3). Files: math(4). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 793
scalblnl(3) Guardian Native C Library Calls Reference Manual NAME scalblnl - Computes the long integral exponent of a radix-independent long double number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 794
Guardian Native C Library Calls (s) scalblnl(3) RELATED INFORMATION Functions: ilogb(3), ldexp(3), logb(3), scalb(3), scalbn(3), scalbln(3), scalblnf(3). Files: math(4). STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 795
scalbn(3) Guardian Native C Library Calls Reference Manual NAME scalbn - Computes the exponent of a radix-independent floating-point number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double scalbn( double x, int n ); PARAMETERS x Is the double value to be multiplied.
PAGE 796
Guardian Native C Library Calls (s) scalbnf(3) NAME scalbnf - Computes the exponent of a radix-independent float number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float scalbnf( float x, int n ); PARAMETERS x Is the float value to be multiplied. n Is the exponent of the radix.
PAGE 797
scalbnf(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 798
Guardian Native C Library Calls (s) scalbnl(3) NAME scalbnl - Computes the exponent of a radix-independent long double number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double scalbnl( long double x, int n ); PARAMETERS x Is the long double value to be multiplied.
PAGE 799
scalbnl(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the ISO/IEC 9899:1999 standard. This function conforms to the IEEE Std 1003.1, 2004 Edition.
PAGE 800
Guardian Native C Library Calls (s) scandir(3) NAME scandir - Scan a directory LIBRARY G-series native OSS processes: /G/system/sysnn/zutilsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zutildll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yutildll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 801
scandir(3) Guardian Native C Library Calls Reference Manual ERRORS These underlying functions can cause the scandir( ) function to report an errno value: opendir( ), readdir( ), and malloc( ). For information about the errors reported by these functions, see the reference pages for the functions. RELATED INFORMATION Functions: closedir(3), mkdir(2), opendir(3), readdir(3), rewinddir(3), rmdir(2), scandir64(3), seekdir(3), telldir(3).
PAGE 802
Guardian Native C Library Calls (s) scandir64(3) NAME scandir64 - Scan a directory LIBRARY G-series native OSS processes: /G/system/sysnn/zutilsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zutildll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yutildll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 803
scandir64(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, the scandir64( ) function returns the number of entries selected. The namelist parameter returns a pointer to the array of entry pointers. If scandir64( ) is not successful, -1 is returned. When an underlying call to another function encounters an error, errno is set to indicate the error.
PAGE 804
Guardian Native C Library Calls (s) scanf(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 805
scanf(3) Guardian Native C Library Calls Reference Manual 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 806
Guardian Native C Library Calls (s) scanf(3) — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type. • 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.
PAGE 807
scanf(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 808
Guardian Native C Library Calls (s) scanf(3) inappropriate character or until width, if specified, is reached. 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. scanf( ) processing ends either at the end of the input file, the end of the conversion specifications, or when an input character conflicts with the conversion specifications.
PAGE 809
scanf(3) Guardian Native C Library Calls Reference Manual [EOVERFLOW] An attempt was made to read or write at or beyond the file offset maximum. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fscanf(3), getc(3), getwc(3), isnan(3), printf(3), sscanf(3), strtod(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 810
Guardian Native C Library Calls (s) seed48(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 811
seed48(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), 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 812
Guardian Native C Library Calls (s) setbuf(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 813
setgrent(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 814
Guardian Native C Library Calls (s) setjmp(3) NAME setjmp - Saves the current execution context LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series and J-series native Guardian processes: implicit libraries H-series and J-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 815
setlocale(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 816
Guardian Native C Library Calls (s) setlocale(3) 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 817
setlocale(3) 3. Guardian Native C Library Calls Reference Manual 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 818
Guardian Native C Library Calls (s) setlocale(3) 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 819
setpwent(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZSECDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zsecdll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ysecdll SYNOPSIS #include
PAGE 820
Guardian Native C Library Calls (s) setpwent(3) RELATED INFORMATION Functions: endpwent(3), getpwent(3), getpwnam(3), getpwuid(3). STANDARDS CONFORMANCE The HP implementation of this function does not return the errno values [EMFILE] or [ENFILE]. The following is an HP extensions to the XPG4 Version 2 specification: • 527192-018 The errno value [ENOMEM] can be returned.
PAGE 821
setstate(3) Guardian Native C Library Calls Reference Manual NAME setstate - Switches the 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 822
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 823
setvbuf(3) Guardian Native C Library Calls Reference Manual ERRORS If the following condition occurs, the setvbuf( ) function sets errno to the corresponding value. [EBADF] The file descriptor that underlies stream is invalid. RELATED INFORMATION Functions: fopen(3), fread(3), getc(3), getwc(3), malloc(3), putc(3), putwc(3), setbuf(3).
PAGE 824
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 and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries 32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library: /G/system/zdllnnn/zputdll 64-bit H-series and J-series OSS processes that u
PAGE 825
signal(3) Guardian Native C Library Calls Reference Manual function is identified by the SIG_DFL value for signal action.) If the signal specified by the signal parameter is unknown, the value -1 is returned and errno is set to [EINVAL]. If signal( ) is called in a code module compiled in the OSS environment and called from a TNS or accelerated Guardian process (main( ) was compiled with systype guardian), the value -1 is returned and errno is set to [ENOTOSS].
PAGE 826
Guardian Native C Library Calls (s) signal(3) • Compile the application using the _PUT_MODEL_ feature test macro or equivalent compiler command option. • Compile the application using the -Wlp64 compiler command option. • Link the application to the yputdll library (/G/system/zdllnnn/yputdll). For detailed information about writing multi-threaded and 64-bit applications for the Open System Services environment, see the Open System Services Programmer’s Guide.
PAGE 827
signal(3) 6−42 Guardian Native C Library Calls Reference Manual Hewlett-Packard Company 527192-018
PAGE 828
Guardian Native C Library Calls (s) signbit(3) NAME signbit - Tests sign of a floating-point value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include int signbit( floating-type x); PARAMETERS floating-type Specifies the floating-type of x. x Specifies a value of type floating-type.
PAGE 829
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 830
Guardian Native C Library Calls (s) 527192-018 sin(3) • For IEEE floating-point data, when the value of x is infinite, NaN is returned instead of 0.0 (zero). • 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 831
sinf(3) Guardian Native C Library Calls Reference Manual NAME sinf - Computes the trigonometric sine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float sinf( float x); PARAMETERS x Is the float value for which the trigonometric sine function is to be computed.
PAGE 832
Guardian Native C Library Calls (s) sinh(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 833
sinhf(3) Guardian Native C Library Calls Reference Manual NAME sinhf - Computes the hyperbolic sine function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float sinhf( float x); PARAMETERS x Is the float value for which the hyperbolic sine function is to be computed.
PAGE 834
Guardian Native C Library Calls (s) sinhl(3) NAME sinhl - Computes the hyperbolic sine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double sinhl( long double x); PARAMETERS x Is the long double value for which the hyperbolic sine function is to be computed.
PAGE 835
sinl(3) Guardian Native C Library Calls Reference Manual NAME sinl - Computes the trigonometric sine function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 836
Guardian Native C Library Calls (s) snprintf(3) NAME snprintf - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 837
snprintf(3) Guardian Native C Library Calls Reference Manual format strings in an order appropriate to specific languages. When variable ordering is used, the * (asterisk) specification for field width in precision is replaced by %digit$. If the variable ordering feature is used, it must be specified for all conversions. • • Zero or more flags that modify the meaning of the conversion specification.
PAGE 838
Guardian Native C Library Calls (s) snprintf(3) — The number of digits to appear after the radix character for the e, E, and f conversions. — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 839
snprintf(3) Guardian Native C Library Calls Reference Manual — An L followed by an n conversion specifier indicates that the argument will be treated as a pointer to a long long int. — A t followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a ptrdiff_t or the corresponding unsigned integer type argument. — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t.
PAGE 840
Guardian Native C Library Calls (s) snprintf(3) f Accepts a float or double value and converts it to decimal notation in the format [-]ddd.ddd. The number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified). If a radix character is output, at least one digit is output before it. The value is rounded to the appropriate number of digits.
PAGE 841
snprintf(3) Guardian Native C Library Calls Reference Manual (zero) or null, the results are undefined. S or ls 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 842
Guardian Native C Library Calls (s) snprintf(3) RETURN VALUES Upon successful completion, this function returns the number of bytes that would have been stored had n been sufficiently large (not counting the terminating null character). Otherwise, a negative value is returned. Thus, the null-terminated output has been completely stored if and only if the returned value is nonnegative and less than n. The value returned by the snprintf( ) function does not include the final ’\0’ (null) character.
PAGE 843
sprintf(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 844
Guardian Native C Library Calls (s) • • sprintf(3) Zero or more flags that modify the meaning of the conversion specification. The flag characters and their meanings are as follows: ’ Format the integer portion of the result of a decimal conversion (%i, %d, %u, %f, %F, %g, or %G) with thousands’ grouping characters, using the nonmonetary grouping character. For other conversions the behavior is undefined. - Left align within the field the result of the conversion.
PAGE 845
sprintf(3) Guardian Native C Library Calls Reference Manual — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 846
Guardian Native C Library Calls (s) sprintf(3) — An L followed by an n conversion specifier indicates that the argument will be treated as a pointer to a long long int. — A t followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a ptrdiff_t or the corresponding unsigned integer type argument. — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t.
PAGE 847
sprintf(3) Guardian Native C Library Calls Reference Manual f Accepts a float or double value and converts it to decimal notation in the format [-]ddd.ddd. The number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified). If a radix character is output, at least one digit is output before it.
PAGE 848
Guardian Native C Library Calls (s) sprintf(3) (zero) or null, the results are undefined. S or ls 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 849
sprintf(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned. The value returned by the sprintf( ) function does not include the final ’\0’ (null) character. 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).
PAGE 850
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 851
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 852
Guardian Native C Library Calls (s) sqrtf(3) NAME sqrtf - Computes the square root of a float number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float sqrtf( float x); PARAMETERS x Is the float value whose square root is to be computed.
PAGE 853
sqrtl(3) Guardian Native C Library Calls Reference Manual NAME sqrtl - Computes the square root of a long double number LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double sqrtl( long double x); PARAMETERS x Is the long double value whose square root is to be computed.
PAGE 854
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 855
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 856
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 857
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 858
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 859
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 860
Guardian Native C Library Calls (s) sscanf(3) — An L followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a long long or an unsigned long long, which is a 64-bit integer data type and an HP extension. — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type.
PAGE 861
sscanf(3) Guardian Native C Library Calls Reference Manual — The first two characters are 0x or 0X, in which case the integer is interpreted as a hexadecimal number. The corresponding pointer parameter should be an integer pointer. n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input string so far by this function. The assignment count returned at the completion of this function is not incremented.
PAGE 862
Guardian Native C Library Calls (s) sscanf(3) — You can include the ] (right bracket) as an element of scanset if it is the first character of scanset. In this case, it is not interpreted as the bracket that closes scanset. If scanset is an exclusive scanset, the ] is preceded by the ˆ (circumflex) to make the ] an element of scanset. The corresponding pointer parameter must point to a character array large enough to contain the output string with a terminating 0 (zero) appended.
PAGE 863
sscanf(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fscanf(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3), strtod(3). STANDARDS CONFORMANCE The [EINVAL] errno value is an extension to the the XPG4 Version 2 specification.
PAGE 864
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 865
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 866
Guardian Native C Library Calls (s) strcat64(3) NAME strcat64 - Appends a string to a string LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include char _ptr64 *strcat64( char _ptr64 *s1, const char _ptr64 *s2); PARAMETERS s1 Specifies the destination string for appending. s2 Specifies the string to be appended to s1.
PAGE 867
strchr(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 868
Guardian Native C Library Calls (s) strchr64(3) NAME strchr64 - Finds an integer character in string LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include char _ptr64 *strchr64( const char _ptr64 *s, int c); PARAMETERS s Specifies the string to search. c Specifies a character, expressed as an int data type, to search for.
PAGE 869
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 870
Guardian Native C Library Calls (s) strcmp64(3) NAME strcmp64 - Compares strings LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include int strcmp64( const _ptr64 char *s1, const _prt64 char *s2); PARAMETERS s1 Specifies the first of two strings to compare. s2 Specifies the second of two strings to compare.
PAGE 871
strcoll(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 872
Guardian Native C Library Calls (s) strcpy(3) NAME strcpy - Copies strings LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRESRL G-series native OSS processes: /G/system/sysnn/zcresrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 873
strcpy64(3) Guardian Native C Library Calls Reference Manual NAME strcpy64 - Copies strings LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include char _ptr64 *strcpy64( char _ptr64 *s1, const char _ptr64 *s2); PARAMETERS s1 Specifies the destination string for the copying. s2 Specifies the source string for the copying.
PAGE 874
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 875
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 876
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 877
strerror_r(3) Guardian Native C Library Calls Reference Manual NAME strerror_r - Accesses message explaining function error LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include char *strerror_r( int errnum); char *strerrbuf, size_t *buflen); PARAMETERS errnum Specifies an error-number value.
PAGE 878
Guardian Native C Library Calls (s) strfmon(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS include #include
PAGE 879
strfmon(3) Guardian Native C Library Calls Reference Manual does not affect field-width filling, which always uses the space character. This 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.
PAGE 880
Guardian Native C Library Calls (s) strfmon(3) 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 881
strfmon(3) Guardian Native C Library Calls Reference Manual 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 882
Guardian Native C Library Calls (s) strftime(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 883
strftime(3) Guardian Native C Library Calls Reference Manual 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 884
Guardian Native C Library Calls (s) 527192-018 strftime(3) 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 885
strftime(3) 6−100 Guardian Native C Library Calls Reference Manual 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 886
Guardian Native C Library Calls (s) strftime(3) 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). If no time-zone information exists, no characters are output.
PAGE 887
strftime(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: ctime(3), mbstowcs(3), setlocale(3), strptime(3), wcsftime(3).
PAGE 888
Guardian Native C Library Calls (s) strlen(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 889
strlen64(3) Guardian Native C Library Calls Reference Manual NAME strlen64 - Finds length of string LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include unsigned long long strlen64( const char _ptr64 *s); PARAMETERS s Specifies the string. DESCRIPTION The strlen64( ) function returns the number of bytes in the string pointed to by the s parameter.
PAGE 890
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 891
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 892
Guardian Native C Library Calls (s) strncat64(3) NAME strncat64 - Appends bytes to a string LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include char _ptr64 *strncat64( char _ptr64 *s1, const char _ptr64 *s2, unsigned long long n); PARAMETERS s1 Points to a location containing first string. s2 Points to a location containing the second of two strings referenced.
PAGE 893
strncmp(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 894
Guardian Native C Library Calls (s) strncmp64(3) NAME strncmp64 - Compares two strings LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include int strncmp64( const char_ptr64 *s1, const char _ptr64 *s2, unsigned long long n); PARAMETERS s1 Points to a location containing first string. s2 Points to a location containing the second of two strings referenced.
PAGE 895
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 896
Guardian Native C Library Calls (s) strncpy64(3) NAME strncpy64 - Copies a string LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include char _ptr64 *strncpy64( char _ptr64 *s1, const char _ptr64 *s2, unsigned long long n); PARAMETERS s1 Points to a location containing first string. s2 Points to a location containing the second of two strings referenced.
PAGE 897
strpbrk(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 898
Guardian Native C Library Calls (s) strptime(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 899
strptime(3) 6−114 Guardian Native C Library Calls Reference Manual B Same as b. 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.
PAGE 900
Guardian Native C Library Calls (s) strptime(3) y Inputs the year within the century as a decimal number in the range from 00 to 99. 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.
PAGE 901
strptime(3) Guardian Native C Library Calls Reference Manual 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). STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification.
PAGE 902
Guardian Native C Library Calls (s) strrchr(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 903
strrchr64(3) Guardian Native C Library Calls Reference Manual NAME strrchr64 - Searches for character in string LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include char _ptr64 *strrchr64( const char _ptr64 *s, int c); PARAMETERS s Specifies the string to search. c Specifies a character, expressed as an int data type, to search for.
PAGE 904
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 905
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 906
Guardian Native C Library Calls (s) strstr64(3) NAME strstr64 - Finds a substring LIBRARY H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include char _ptr64 *strstr64( const char _ptr64 *s1, const char _ptr64 *s2); PARAMETERS s1 Specifies the character string being searched. s2 Specifies the substring to be located.
PAGE 907
strtod(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 908
Guardian Native C Library Calls (s) • strtod(3) For IEEE floating-point values and H-series RVUs and G06.27 and later G-series RVUs only, one of INF, INFINITY, NAN, or NAN(seq), where seq is a sequence of digit and nondigit characters. When the input string is empty or consists entirely of white space, or when the first non-whitespace character is not a sign, a digit, or a radix character, the subject sequence contains no characters.
PAGE 909
strtof(3) Guardian Native C Library Calls Reference Manual NAME strtof - Converts a character string to a floating-point value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include float strtof( const char *nptr, char **endptr ); PARAMETERS nptr Points to the character string to be converted.
PAGE 910
Guardian Native C Library Calls (s) strtof(3) When the value of the endptr parameter is not (char**) NULL, a pointer to the character that terminated the scan is stored at *endptr. When a floating-point value cannot be formed, *endptr is set to nptr. The setlocale( ) function might affect the radix character used in the conversion result. The radix character is controlled by the LC_NUMERIC category of the setlocale( ) function. NOTES In the TNS/E native environment, all locales are supported.
PAGE 911
strtoimax(3) Guardian Native C Library Calls Reference Manual NAME strtoimax - Converts a character string to an intmax_t value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 912
Guardian Native C Library Calls (s) strtoimax(3) Character 0 1 2 3 4 5 6 7 8 9 Value A B C D E F G H I J a b c d e f g h i 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 913
strtoimax(3) Guardian Native C Library Calls Reference Manual RETURN VALUES The strtoimax( ) function returns the converted value of intmax_t 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 914
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 915
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 916
Guardian Native C Library Calls (s) strtok_r(3) NAME strtok_r - Splits string into tokens (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 917
strtok_r(3) Guardian Native C Library Calls Reference Manual • Include the string.h file To use the Standard POSIX Threads library, you must: • Include the spthread.h file • Link your application to the Standard POSIX Threads library: /G/system/sysnn/zsptsrl (G-series) or /G/system/zdllnnn/zsptdll (H-series or J-series) • Compile your application using the #define_SPT_MODEL_ macro or an equivalent compiler command option.
PAGE 918
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 919
strtol(3) Guardian Native C Library Calls Reference Manual • If the base value is between 2 and 36, the subject string can be a sequence of digits and letters a or A to z or Z that are used to represent an integer in the specified base. Alphabetic characters represent digits with an equivalent decimal value from 10 (for the letter A) to 35 (for the letter Z). The subject string can only have digits with a value less than base and alphabetic characters with equivalent values less than base.
PAGE 920
Guardian Native C Library Calls (s) strtol(3) } else { /* retval contains long integer */ printf("Integer in decimal is %d\n", retval); } } } 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 921
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 922
Guardian Native C Library Calls (s) • strtoll(3) If the base value is between 2 and 36, the subject string can be a sequence of digits and letters a or A to z or Z that are used to represent an integer in the specified base. Alphabetic characters represent digits with an equivalent decimal value from 10 (for the letter A) to 35 (for the letter Z). The subject string can only have digits with a value less than base and alphabetic characters with equivalent values less than base.
PAGE 923
strtoll(3) [ERANGE] Guardian Native C Library Calls Reference Manual The converted value is outside the range of representable values. If nptr is NULL, the function returns 0 (zero) and does not set errno. RELATED INFORMATION Functions: atof(3), atoi(3), atol(3), scanf(3), strtol(3), strtoul(3), strtoull(3), scanf(3), wstol(3). STANDARDS CONFORMANCE The behavior of this function conforms to the Single UNIX Specification, Version 3 and the 1999 ANSI C standard.
PAGE 924
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 925
strtoul(3) Guardian Native C Library Calls Reference Manual • If the base value is between 2 and 36, the subject string can be a sequence of digits and letters a or A to z or Z that are used to represent an integer in the specified base. Alphabetic characters represent digits with an equivalent decimal value from 10 (for the letter A) to 35 (for the letter Z). The subject string can only have digits with a value less than base and alphabetic characters with equivalent values less than base.
PAGE 926
Guardian Native C Library Calls (s) [ERANGE] strtoul(3) The converted value is outside the range of representable values. If nptr is NULL, the function returns 0 (zero) and does not set errno. RELATED INFORMATION Functions: atof(3), atoi(3), atol(3), scanf(3), strtol(3), strtoull(3), scanf(3), wcstol(3). STANDARDS CONFORMANCE The behavior of this function conforms to the Single UNIX Specification, Version 3 and the 1999 ANSI C standard.
PAGE 927
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 928
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 929
strtoumax(3) Guardian Native C Library Calls Reference Manual NAME strtoumax - Converts a character string to a uintmax_t integer LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 930
Guardian Native C Library Calls (s) strtoumax(3) Character 0 1 2 3 4 5 6 7 8 9 Value A B C D E F G H I J a b c d e f g h i 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 931
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 932
Guardian Native C Library Calls (s) strxfrm(3) ERRORS If the following condition occurs, the strxfrm( ) function sets errno to the corresponding value. [EINVAL] The s2 parameter contains codes outside the domain of the collating sequence defined by the current locale. RELATED INFORMATION Functions: setlocale(3), strcoll(3), strcmp(3), wcsxfrm(3).
PAGE 933
swprintf(3) Guardian Native C Library Calls Reference Manual NAME swprintf - Stores formatted output into a character array LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int swprintf ( wchar_t *string, size_t *n, const wchar_t *format [, value] . . .
PAGE 934
Guardian Native C Library Calls (s) swprintf(3) used, the * (asterisk) specification for field width in precision is replaced by %digit$. If the variable ordering feature is used, it must be specified for all conversions. • • Zero or more flags that modify the meaning of the conversion specification.
PAGE 935
swprintf(3) Guardian Native C Library Calls Reference Manual — The number of digits to appear after the radix character for the e, E, and f conversions. — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 936
Guardian Native C Library Calls (s) swprintf(3) — An L followed by an n conversion specifier indicates that the argument will be treated as a pointer to a long long int. — A t followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a ptrdiff_t or the corresponding unsigned integer type argument. — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t.
PAGE 937
swprintf(3) Guardian Native C Library Calls Reference Manual f Accepts a float or double value and converts it to decimal notation in the format [-]ddd.ddd. The number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified). If a radix character is output, at least one digit is output before it.
PAGE 938
Guardian Native C Library Calls (s) S or ls swprintf(3) Accepts a pointer to an array of wchar_t type. Wide characters from the array 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. If the precision is not specified or is greater than the size of the array of bytes, then the array of wide characters must be terminated by a null wide character.
PAGE 939
swprintf(3) Guardian Native C Library Calls Reference Manual ERRORS None. The swprintf( ) 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 behavior of this function conforms to the ISO/IEC 9899:1999 specification. The POSIX standards leave some features to the implementing vendor to define.
PAGE 940
Guardian Native C Library Calls (s) swscanf(3) NAME swscanf - Converts formatted input read from a wide-character string LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.1 */ int swscanf( const wchar_t *string, const wchar_t *format [, *pointer] . . .
PAGE 941
swscanf(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 942
Guardian Native C Library Calls (s) swscanf(3) — An L followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a long long or an unsigned long long, which is a 64-bit integer data type and an HP extension. — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type.
PAGE 943
swscanf(3) Guardian Native C Library Calls Reference Manual i Accepts a decimal integer unless: — The first digit is a 0 (zero), in which case the integer is interpreted as an octal number. — The first two characters are 0x or 0X, in which case the integer is interpreted as a hexadecimal number. The corresponding pointer parameter should be an integer pointer. n Consumes no input.
PAGE 944
Guardian Native C Library Calls (s) [scanset] swscanf(3) Accepts as input the characters included in scanset. scanset explicitly defines the characters that are accepted in the input string to be those enclosed within [ ] (square brackets). The corresponding pointer parameter should be an array of type char. The leading white space that is normally skipped over is suppressed.
PAGE 945
swscanf(3) Guardian Native C Library Calls Reference Manual RETURN VALUES The swscanf( ) function returns the number of successfully matched and assigned input items. This value can be 0 (zero) if there was an early conflict between an input character and the conversion specification. If the input ends before the first conflict or conversion, EOF (End-ofFile) is returned.
PAGE 946
Guardian Native C Library Calls (s) sysconf(3) NAME sysconf - Gets configurable system variables LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series and J-series native Guardian processes: implicit libraries H-series and J-series OSS processes: implicit libraries SYNOPSIS #include long int sysconf( int name); PARAMETERS name Specifies the system variable to be queried.
PAGE 947
sysconf(3) Guardian Native C Library Calls Reference Manual 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 948
Guardian Native C Library Calls (s) sysconf(3) _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 949
sysconf(3) Guardian Native C Library Calls Reference Manual _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 950
Guardian Native C Library Calls (s) sysconf(3) _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 951
system(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 952
Guardian Native C Library Calls (s) system(3) • If the command parameter is a null pointer, the system( ) function returns a value of 1 only if a command processor is available. • 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).
PAGE 953
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 954
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 955
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-018 • 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 956
tanf(3) Guardian Native C Library Calls Reference Manual NAME tanf - Computes the trigonometric tangent function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float tanf( float x); PARAMETERS x Is the float value for which the trigonometric tangent function is to be computed.
PAGE 957
Guardian Native C Library Calls (t - z) tanh(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 958
tanhf(3) Guardian Native C Library Calls Reference Manual NAME tanhf - Computes the hyperbolic tangent function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float tanhf( float x); PARAMETERS x Is the float value for which the hyperbolic tangent function is to be computed.
PAGE 959
Guardian Native C Library Calls (t - z) tanhl(3) NAME tanhl - Computes the hyperbolic tangent function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 960
tanl(3) Guardian Native C Library Calls Reference Manual NAME tanl - Computes the trigonometric tangent function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 961
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 962
tempnam(3) Guardian Native C Library Calls Reference Manual NAME tempnam - Constructs the name for an OSS temporary file LIBRARY G-series native OSS processes: /G/system/sysnn/zcrtlsrl 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 963
Guardian Native C Library Calls (t - z) terminate_program(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 964
terminate_program(3) Guardian Native C Library Calls Reference Manual 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 965
Guardian Native C Library Calls (t - z) tfind(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 966
tgamma(3) Guardian Native C Library Calls Reference Manual NAME tgamma - Computes the true gamma function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double tgamma( double x); PARAMETERS x Specifies a positive double value. DESCRIPTION The tgamma( ) function computes the true gamma function of x.
PAGE 967
Guardian Native C Library Calls (t - z) tgammaf(3) NAME tgammaf - Computes the true gamma function for a float value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float tgammaf( float x); PARAMETERS x Specifies a positive float value.
PAGE 968
tgammal(3) Guardian Native C Library Calls Reference Manual NAME tgammal - Computes the true gamma function for a long double value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double tgammal( long double x); PARAMETERS x Specifies a positive long double value.
PAGE 969
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 970
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 and J-series native Guardian processes: implicit libraries H-series and J-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 971
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 972
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 973
Guardian Native C Library Calls (t - z) tmpfile64(3) NAME tmpfile64 - Creates a temporary file LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 974
tmpfile64_guardian(3) Guardian Native C Library Calls Reference Manual NAME tmpfile64_guardian - Creates a temporary file (Guardian tmpfile64( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 975
Guardian Native C Library Calls (t - z) tmpfile64_guardian(3) RETURN VALUES Upon successful completion, the tmpfile64( ) function returns a pointer to the stream of the file that is created. Otherwise, it returns a null pointer, and sets errno to indicate the error. ERRORS If any of these conditions occurs, the tmpfile64( ) function sets errno to the corresponding value: [EMFILE] The OPEN_MAX file descriptors are currently open in the calling process.
PAGE 976
tmpfile64_oss(3) Guardian Native C Library Calls Reference Manual NAME tmpfile64_oss - Creates a temporary file (OSS tmpfile64( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 977
Guardian Native C Library Calls (t - z) tmpfile64_oss(3) RETURN VALUES Upon successful completion, the tmpfile64( ) function returns a pointer to the stream of the file that is created. Otherwise, it returns a null pointer, and sets errno to indicate the error. ERRORS If any of these conditions occurs, the tmpfile64( ) function sets errno to the corresponding value: [EINTR] A signal was caught during the tmpfile64( ) function.
PAGE 978
tmpfile_guardian(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 979
Guardian Native C Library Calls (t - z) [ENFILE] Too many files are currently open in the processor. [ENOMEM] Insufficient storage space is available. tmpfile_guardian(3) RELATED INFORMATION Functions: fopen(3), tmpfile(3), tmpfile64_guardian(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 980
tmpfile_oss(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 981
Guardian Native C Library Calls (t - z) tmpfile_oss(3) [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, tmpfile64_oss, tmpnam(3), unlink(2). STANDARDS CONFORMANCE The tmpfile_oss( ) function is an HP extension to the XPG4 Version 2 specification.
PAGE 982
tmpnam(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 983
Guardian Native C Library Calls (t - z) tmpnam_guardian(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 984
tmpnam_guardian(3) Guardian Native C Library Calls Reference Manual 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. 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.
PAGE 985
Guardian Native C Library Calls (t - z) tmpnam_oss(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 986
tmpnam_oss(3) Guardian Native C Library Calls Reference Manual 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 987
Guardian Native C Library Calls (t - z) tmpnam_r(3) NAME tmpnam_r - Constructs the name for a temporary file (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 988
tmpnam_r(3) • Guardian Native C Library Calls Reference Manual Include the stdio.h file To use the Standard POSIX Threads library, you must: • Include the spthread.h file • Link your application to the Standard POSIX Threads library: /G/system/sysnn/zsptsrl (G-series) or /G/system/zdllnnn/zsptdll (H-series or J-series) • Compile your application using the #define_SPT_MODEL_ macro or an equivalent compiler command option.
PAGE 989
Guardian Native C Library Calls (t - z) toascii(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 990
_tolower(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 991
Guardian Native C Library Calls (t - z) tolower(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 992
_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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 993
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 994
towctrans(3) Guardian Native C Library Calls Reference Manual NAME towctrans - Character transliteration function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 995
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 996
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 997
Guardian Native C Library Calls (t - z) trunc(3) NAME trunc - Rounds floating-point number to truncated integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include double trunc( double x); PARAMETERS x Is the double value to be rounded.
PAGE 998
truncf(3) Guardian Native C Library Calls Reference Manual NAME truncf - Rounds float number to truncated integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include float truncf( float x); PARAMETERS x Is the float value to be rounded.
PAGE 999
Guardian Native C Library Calls (t - z) truncl(3) NAME truncl - Rounds long double number to truncated integer value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include long double truncl( long double x); PARAMETERS x Is the long double value to be rounded.
PAGE 1000
tsearch(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1001
Guardian Native C Library Calls (t - z) tsearch(3) 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 1002
twalk(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1003
Guardian Native C Library Calls (t - z) tzset(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1004
tzset(3) Guardian Native C Library Calls Reference Manual 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.
PAGE 1005
Guardian Native C Library Calls (t - z) ungetc(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1006
ungetwc(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1007
Guardian Native C Library Calls (t - z) unordered(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1008
va_arg(3) Guardian Native C Library Calls Reference Manual 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 1009
Guardian Native C Library Calls (t - z) va_end(3) 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 1010
valloc(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include #include
PAGE 1011
Guardian Native C Library Calls (t - z) va_start(3) 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 1012
va_start(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: va_arg(3), va_end(3), vfprintf(3).
PAGE 1013
Guardian Native C Library Calls (t - z) vfprintf(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include
PAGE 1014
vfprintf(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: ’ Format the integer portion of the result of a decimal conversion (%i, %d, %u, %f, %F, %g, or %G) with thousands’ grouping characters, using the nonmonetary grouping character. For other conversions the behavior is undefined. - Left align within the field the result of the conversion.
PAGE 1015
Guardian Native C Library Calls (t - z) vfprintf(3) — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 1016
vfprintf(3) Guardian Native C Library Calls Reference Manual Specifying a field width with a 0 (zero) as a leading character causes the field width value to be padded with leading zeros. 7−64 o Accepts an integer (int) value and converts it to unsigned octal notation. 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 1017
Guardian Native C Library Calls (t - z) vfprintf(3) s Accepts a pointer to an array of char type. Bytes from the array are printed until a null character is encountered or the number of characters indicated by the precision is reached. If no precision is specified, all characters up to the first null character are printed. If the precision is not specified or is greater than the size of the array, then the array must be terminated by a null byte.
PAGE 1018
vfprintf(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. EXAMPLES The following example demonstrates how the vfprintf( ) function can be used to write an error routine: #include #include void { error(char *funct, char *fmt, ...
PAGE 1019
Guardian Native C Library Calls (t - z) vfprintf(3) [ENOMEM] Insufficient storage space was 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 1020
vfscanf(3) Guardian Native C Library Calls Reference Manual NAME vfscanf - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1021
Guardian Native C Library Calls • (t - z) vfscanf(3) 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 1022
vfscanf(3) Guardian Native C Library Calls Reference Manual — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type. — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type.
PAGE 1023
Guardian Native C Library Calls (t - z) vfscanf(3) n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input stream so far by this function. The assignment count returned at the completion of this function is not incremented. o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer.
PAGE 1024
vfscanf(3) Guardian Native C Library Calls Reference Manual is added automatically. The results from the conversion are placed in *pointer unless you specify assignment suppression with an * (asterisk). Assignment suppression provides a way to describe an input field that is to be skipped. The input field is a string of non-white-space characters. It extends to the next inappropriate character or until width, if specified, is reached.
PAGE 1025
Guardian Native C Library Calls (t - z) vfscanf(3) [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. [EOVERFLOW] An attempt was made to read or write at or beyond the file offset maximum. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fvfscanf(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3), strtod(3).
PAGE 1026
vfwprintf(3) Guardian Native C Library Calls Reference Manual NAME vfwprintf - Formats a variable number of parameters for output LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 1027
Guardian Native C Library Calls • (t - z) vfwprintf(3) ’ Format the integer portion of the result of a decimal conversion (%i, %d, %u, %f, %F, %g, or %G) with thousands’ grouping wide-characters, using the nonmonetary grouping wide-character. For other conversions the behavior is undefined. - Left align within the field the result of the conversion. + Begin the result of a signed conversion with a sign (+ or -).
PAGE 1028
vfwprintf(3) Guardian Native C Library Calls Reference Manual specifying field width or precision must appear before the value (if any) to be converted. If the value of the corresponding parameter is negative, it is treated as if the precision 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 1029
Guardian Native C Library Calls (t - z) vfwprintf(3) — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t. — A z followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a size_t or the corresponding signed integer type argument. — A z followed by an n conversion specifier indicates that the argument will be treated as a pointer to a signed integer type corresponding to the size_t argument.
PAGE 1030
vfwprintf(3) Guardian Native C Library Calls Reference Manual digits. e or E Accepts a float or double value and converts it to the exponential form [-]d.ddde+/-dd. There is one digit before the radix character and the number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified).
PAGE 1031
Guardian Native C Library Calls S or ls (t - z) vfwprintf(3) 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 1032
vfwprintf(3) Guardian Native C Library Calls Reference Manual RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned. ERRORS The vfwprintf( ) 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.
PAGE 1033
Guardian Native C Library Calls (t - z) vfwscanf(3) NAME vfwscanf - Converts formatted input read from the standard input stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.1 */ #include /* optional except for POSIX.
PAGE 1034
vfwscanf(3) Guardian Native C Library Calls Reference Manual Conversion Specifications Each conversion specification in the format parameter has the following syntax: %[digit$][*][width][sizecode]convcode • The character % (percent sign) or %digit$. The vfwscanf( ) 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 1035
Guardian Native C Library Calls (t - z) vfwscanf(3) — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type. • 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.
PAGE 1036
vfwscanf(3) Guardian Native C Library Calls Reference Manual n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input stream so far by this function. The assignment count returned at the completion of this function is not incremented. o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer.
PAGE 1037
Guardian Native C Library Calls (t - z) vfwscanf(3) is added automatically. The results from the conversion are placed in *pointer unless you specify assignment suppression with an * (asterisk). Assignment suppression provides a way to describe an input field that is to be skipped. The input field is a string of non-white-space characters. It extends to the next inappropriate character or until width, if specified, is reached. The conversion code convcode indicates how to interpret the input field.
PAGE 1038
vfwscanf(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. [EOVERFLOW] An attempt was made to read or write at or beyond the file offset maximum. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fvfwscanf(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3).
PAGE 1039
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include
PAGE 1040
vprintf(3) Guardian Native C Library Calls Reference Manual [EINTR] The operation was interrupted by a signal that was caught, and no data was transferred. [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.
PAGE 1041
Guardian Native C Library Calls (t - z) vscanf(3) NAME vscanf - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1042
vscanf(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 1043
Guardian Native C Library Calls (t - z) vscanf(3) — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type. — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type.
PAGE 1044
vscanf(3) Guardian Native C Library Calls Reference Manual n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input stream so far by this function. The assignment count returned at the completion of this function is not incremented. o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer.
PAGE 1045
Guardian Native C Library Calls (t - z) vscanf(3) is added automatically. The results from the conversion are placed in *pointer unless you specify assignment suppression with an * (asterisk). Assignment suppression provides a way to describe an input field that is to be skipped. The input field is a string of non-white-space characters. It extends to the next inappropriate character or until width, if specified, is reached. The conversion code convcode indicates how to interpret the input field.
PAGE 1046
vscanf(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. [EOVERFLOW] An attempt was made to read or write at or beyond the file offset maximum. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fscanf(3), getc(3), getwc(3), isnan(3), scanf(3), strtod(3).
PAGE 1047
Guardian Native C Library Calls (t - z) vsnprintf(3) NAME vsnprintf - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1048
vsnprintf(3) Guardian Native C Library Calls Reference Manual character % (percent sign) is replaced by %digit$, where digit is a decimal number in the range from 1 to NL_ARGMAX. Conversion is then applied to the specified argument, rather than to the next unused argument. This feature provides for the definition of format strings in an order appropriate to specific languages. When variable ordering is used, the * (asterisk) specification for field width in precision is replaced by %digit$.
PAGE 1049
Guardian Native C Library Calls (t - z) vsnprintf(3) — The number of digits to appear after the radix character for the e, E, and f conversions. — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 1050
vsnprintf(3) Guardian Native C Library Calls Reference Manual — An L followed by an n conversion specifier indicates that the argument will be treated as a pointer to a long long int. — A t followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a ptrdiff_t or the corresponding unsigned integer type argument. — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t.
PAGE 1051
Guardian Native C Library Calls (t - z) vsnprintf(3) f Accepts a float or double value and converts it to decimal notation in the format [-]ddd.ddd. The number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified). If a radix character is output, at least one digit is output before it.
PAGE 1052
vsnprintf(3) Guardian Native C Library Calls Reference Manual (zero) or null, the results are undefined. S or ls 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 1053
Guardian Native C Library Calls (t - z) vsnprintf(3) RETURN VALUES Upon successful completion, this function returns the number of bytes that would have been stored had n been sufficiently large (not counting the terminating null character). Otherwise, a negative value is returned. Thus, the null-terminated output has been completely stored if and only if the returned value is nonnegative and less than n. The value returned by the vsnprintf( ) function does not include the final ’\0’ (null) character.
PAGE 1054
vsprintf(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1055
Guardian Native C Library Calls (t - z) vsprintf(3) STANDARDS CONFORMANCE The behavior of this function conforms to the ISO/IEC 9899:1999 specification. The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • The output of %p conversion is a decimal integer.
PAGE 1056
vsscanf(3) Guardian Native C Library Calls Reference Manual NAME vsscanf - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1057
Guardian Native C Library Calls (t - z) vsscanf(3) • 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 1058
vsscanf(3) Guardian Native C Library Calls Reference Manual — An L followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a long long or an unsigned long long, which is a 64-bit integer data type and an HP extension. — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type.
PAGE 1059
Guardian Native C Library Calls (t - z) vsscanf(3) — The first two characters are 0x or 0X, in which case the integer is interpreted as a hexadecimal number. The corresponding pointer parameter should be an integer pointer. n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input string so far by this function. The assignment count returned at the completion of this function is not incremented.
PAGE 1060
vsscanf(3) Guardian Native C Library Calls Reference Manual — You can include the ] (right bracket) as an element of scanset if it is the first character of scanset. In this case, it is not interpreted as the bracket that closes scanset. If scanset is an exclusive scanset, the ] is preceded by the ˆ (circumflex) to make the ] an element of scanset. The corresponding pointer parameter must point to a character array large enough to contain the output string with a terminating 0 (zero) appended.
PAGE 1061
Guardian Native C Library Calls (t - z) vsscanf(3) [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fscanf(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3), strtod(3). STANDARDS CONFORMANCE The [EINVAL] errno value is an extension to the the XPG4 Version 2 specification.
PAGE 1062
vswprintf(3) Guardian Native C Library Calls Reference Manual NAME vswprintf - Formats a variable number of parameters for output to a buffer LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 1063
Guardian Native C Library Calls (t - z) vswprintf(3) feature is used, it must be specified for all conversions. • • Zero or more flags that modify the meaning of the conversion specification. The flag characters and their meanings are as follows: ’ Format the integer portion of the result of a decimal conversion (%i, %d, %u, %f, %F, %g, or %G) with thousands’ grouping wide-characters, using the nonmonetary grouping wide-character. For other conversions the behavior is undefined.
PAGE 1064
vswprintf(3) Guardian Native C Library Calls Reference Manual — The maximum number of significant digits for the g and G conversions. — The maximum number of bytes to be printed from a string in the s or S conversion. A field precision can be indicated by an * (asterisk) instead of a digit string. In this case, an integer (int) value parameter supplies the field precision.
PAGE 1065
Guardian Native C Library Calls (t - z) vswprintf(3) — An L followed by an n conversion specifier indicates that the argument will be treated as a pointer to a long long int. — A t followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a ptrdiff_t or the corresponding unsigned integer type argument. — A t followed by an n conversion specifier indicates that the argument will be treated as a pointer to a ptrdiff_t.
PAGE 1066
vswprintf(3) Guardian Native C Library Calls Reference Manual f Accepts a float or double value and converts it to decimal notation in the format [-]ddd.ddd. The number of digits after the radix character is equal to the precision specification. If no precision is specified, six digits are output. If the precision is 0 (zero), no radix character appears (unless the # flag is specified). If a radix character is output, at least one digit is output before it.
PAGE 1067
Guardian Native C Library Calls S or ls (t - z) vswprintf(3) Accepts a pointer to an array of wchar_t type. Wide characters from the array 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. If the precision is not specified or is greater than the size of the array of bytes, then the array of wide characters must be terminated by a null wide character.
PAGE 1068
vswprintf(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The behavior of this function conforms to the ISO/IEC 9899:1999 specification. The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • The output of %p conversion is a decimal integer.
PAGE 1069
Guardian Native C Library Calls (t - z) vswscanf(3) NAME vswscanf - Converts formatted input read from a wide-character string LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 1070
vswscanf(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 1071
Guardian Native C Library Calls (t - z) vswscanf(3) — An L followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a long long or an unsigned long long, which is a 64-bit integer data type and an HP extension. — A t followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a ptrdiff_t or the corresponding unsigned integer type.
PAGE 1072
vswscanf(3) Guardian Native C Library Calls Reference Manual i Accepts a decimal integer unless: — The first digit is a 0 (zero), in which case the integer is interpreted as an octal number. — The first two characters are 0x or 0X, in which case the integer is interpreted as a hexadecimal number. The corresponding pointer parameter should be an integer pointer. n Consumes no input.
PAGE 1073
Guardian Native C Library Calls (t - z) vswscanf(3) itself whenever it is the first or the last character in scanset. — You can include the ] (right bracket) as an element of scanset if it is the first character of scanset. In this case, it is not interpreted as the bracket that closes scanset. If scanset is an exclusive scanset, the ] is preceded by the ˆ (circumflex) to make the ] an element of scanset.
PAGE 1074
vswscanf(3) Guardian Native C Library Calls Reference Manual [EIO] The call is attempting to read from the process’s controlling terminal and either the process is ignoring or blocking the SIGTTIN signal or the process group is orphaned. [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device.
PAGE 1075
Guardian Native C Library Calls (t - z) vwprintf(3) NAME vwprintf - Formats a variable number of parameters for output LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 1076
vwprintf(3) Guardian Native C Library Calls Reference Manual [EINTR] The operation was interrupted by a signal that was caught, and no data was transferred. [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.
PAGE 1077
Guardian Native C Library Calls (t - z) vwscanf(3) NAME vwscanf - Converts formatted input read from the standard input stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.
PAGE 1078
vwscanf(3) Guardian Native C Library Calls Reference Manual Conversion Specifications Each conversion specification in the format parameter has the following syntax: %[digit$][*][width][sizecode]convcode • The character % (percent sign) or %digit$. The vwscanf( ) 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 1079
Guardian Native C Library Calls (t - z) vwscanf(3) — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type. • 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.
PAGE 1080
vwscanf(3) Guardian Native C Library Calls Reference Manual n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input stream so far by this function. The assignment count returned at the completion of this function is not incremented. o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer.
PAGE 1081
Guardian Native C Library Calls (t - z) vwscanf(3) is added automatically. The results from the conversion are placed in *pointer unless you specify assignment suppression with an * (asterisk). Assignment suppression provides a way to describe an input field that is to be skipped. The input field is a string of non-white-space characters. It extends to the next inappropriate character or until width, if specified, is reached. The conversion code convcode indicates how to interpret the input field.
PAGE 1082
vwscanf(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. [EOVERFLOW] An attempt was made to read or write at or beyond the file offset maximum. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fscanf(3), getc(3), getwc(3), isnan(3), printf(3), scanf(3), wcstod(3).
PAGE 1083
Guardian Native C Library Calls (t - z) wcrtomb(3) NAME wcrtomb - Convert a wide-character code to a character (restartable) LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1084
wcrtomb(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE The behavior of this function conforms to the ISO/IEC 9899:1999 standard.
PAGE 1085
Guardian Native C Library Calls (t - z) wcscat(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1086
wcschr(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 1087
Guardian Native C Library Calls (t - z) wcscmp(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1088
wcscoll(3) Guardian Native C Library Calls Reference Manual NAME wcscoll - Compares wide-character strings using collation information LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1089
Guardian Native C Library Calls (t - z) wcscoll(3) ERRORS If any of the following conditions occurs, the wcscoll( ) function sets errno to the corresponding value. [EINVAL] The wide-character string pointed to by the wcs1 or wcs2 sting contained characters outside of the domain of the collating sequence. RELATED INFORMATION Functions: strcoll(3) wcscmp(3), wcsxfrm(3).
PAGE 1090
wcscpy(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1091
Guardian Native C Library Calls (t - z) wcscspn(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1092
wcsftime(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 1093
Guardian Native C Library Calls timeptr (t - z) wcsftime(3) Points to a type tm structure that contains broken-down time information. DESCRIPTION The wcsftime( ) function formats the data in the timptr parameter according to the specification contained in the format parameter and places the resulting wide-character string into the wcs parameter. No more than the number of wide characters specified by the maxsize parameter are written to the array, including the terminating null wide character.
PAGE 1094
wcsftime(3) 7−142 Guardian Native C Library Calls Reference Manual A The long day of the week is output as defined for the current locale (Monday, for example). b or h The short month is output as a string as defined for the current locale (Jan, for example). B The long month is output as a string as defined for the current locale (January, for example). c The date and time are output with the default date and time as defined for the current locale.
PAGE 1095
Guardian Native C Library Calls 527192-018 (t - z) wcsftime(3) Oe Specifies the day of the month using the locale’s alternate numeric symbols. OH Specifies the hour (24-hour clock) using the locale’s alternate numeric symbols. OI Specifies the hour (12-hour clock) using the locale’s alternate numeric symbols. Om Specifies the month using the locale’s alternate numeric symbols. OM Specifies the minutes using the locale’s alternate numeric symbols.
PAGE 1096
wcsftime(3) Guardian Native C Library Calls Reference Manual V The week number of the year (Monday as the first day of the week). Output format is a decimal number between 1 and 53. If the week containing 1 January has four or more days in the new year, it is considered week 1; otherwise it is week 53 of the previous year, and the next week is week 1. w The day of the week is output as a number between 0 (Sunday) and 6. W Specifies the week number of the year (Monday as the first day of the week).
PAGE 1097
Guardian Native C Library Calls (t - z) wcslen(3) NAME wcslen - Determines the number of characters 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1098
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1099
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1100
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1101
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1102
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 1103
Guardian Native C Library Calls (t - z) wcsrtombs(3) NAME wcsrtombs - Convert a wide-character string to a character string (restartable) LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1104
wcsrtombs(3) Guardian Native C Library Calls Reference Manual ERRORS If any of these conditions occurs, errno is set to the corresponding value: [EINVAL] The ps parmeter points to an object that contains an invalid conversion state. [EILSEQ] A wide-character code does not correspond to a valid character. RELATED INFORMATION Functions: mbsinit(3), wcrtomb(3). STANDARDS CONFORMANCE The behavior of this function conforms to the ISO/IEC 9899:1999 standard.
PAGE 1105
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1106
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 1107
Guardian Native C Library Calls (t - z) wcstod(3) entirely of white-space, wide-character codes, or if the first non-white-space, wide-character code is not a sign, a digit, or a radix character. If the subject sequence is valid, the sequence of wide-character codes, starting with the first digit or radix character, whichever occurs first, is interpreted as a floating-point or double-precision, floating-point constant. The locale’s radix character is treated as equivalent to the .
PAGE 1108
wcstod(3) Guardian Native C Library Calls Reference Manual STANDARDS CONFORMANCE This function conforms to the XPG4 Version 2 specification when used for IEEE floating-point format data.
PAGE 1109
Guardian Native C Library Calls (t - z) wcstof(3) NAME wcstof - Converts a wide-character string to a floating-point value LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include float wcstof( const wchar_t *nptr, wchar_t **endptr ); PARAMETERS nptr Points to the wide-character string to be converted.
PAGE 1110
wcstof(3) Guardian Native C Library Calls Reference Manual When the value of the endptr parameter is not (char**) NULL, a pointer to the character that terminated the scan is stored at *endptr. When a floating-point value cannot be formed, *endptr is set to nptr. The setlocale( ) function might affect the radix character used in the conversion result. The radix character is controlled by the LC_NUMERIC category of the setlocale( ) function.
PAGE 1111
Guardian Native C Library Calls (t - z) wcstoimax(3) NAME wcstoimax - Converts a wide-character string to intmax_t integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1112
wcstoimax(3) Guardian Native C Library Calls Reference Manual converted: 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 1113
Guardian Native C Library Calls (t - z) wcstoimax(3) RETURN VALUES The wcstoimax( ) function returns the converted value of intmax_t 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 1114
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS For TNS/E Target Compilations on H06.
PAGE 1115
Guardian Native C Library Calls (t - z) wcstok(3) Usually, the wcstok( ) function is called repeatedly to extract the tokens in a wide-character string. The first time the application program calls the wcstok( ) function, it sets the ws1 parameter to point to the input wide-character string. The function returns a pointer to the first token. Then the application program calls the function again with the ws1 parameter set to the null pointer. This call returns a pointer to the next token in the string.
PAGE 1116
wcstok(3) Guardian Native C Library Calls Reference Manual != NULL) { /* pwcs points to the first token */ printf("Token 1 is %S\n", pwcs); counter = 2; while ((pwcs = wcstok((wchar_t * )NULL, delimiters )) != NULL) { printf("Token %d is %S\n", counter, pwcs); counter++; } } } } } RETURN VALUES Upon successful completion, the wcstok( ) function returns a pointer to the first wide character of a token. A null pointer is returned if there is no token.
PAGE 1117
Guardian Native C Library Calls (t - z) wcstol(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1118
wcstol(3) Guardian Native C Library Calls Reference Manual converted: 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 1119
Guardian Native C Library Calls (t - z) wcstol(3) 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 1120
wcstoll(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1121
Guardian Native C Library Calls (t - z) wcstoll(3) converted: 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 1122
wcstombs(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.
PAGE 1123
Guardian Native C Library Calls (t - z) wcstombs(3) 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 1124
wcstoul(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1125
Guardian Native C Library Calls (t - z) wcstoul(3) converted: 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 1126
wcstoul(3) Guardian Native C Library Calls Reference Manual 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 1127
Guardian Native C Library Calls (t - z) wcstoull(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1128
wcstoull(3) Guardian Native C Library Calls Reference Manual converted: 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 1129
Guardian Native C Library Calls (t - z) wcstoumax(3) NAME wcstoumax - Converts wide-character strings to an uintmax_t integer LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1130
wcstoumax(3) Guardian Native C Library Calls Reference Manual converted: 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 1131
Guardian Native C Library Calls (t - z) wcstoumax(3) RETURN VALUES The wcstoumax( ) function returns the converted value of the uintmax_t 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 1132
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1133
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1134
wcswidth(3) Guardian Native C Library Calls Reference Manual RETURN VALUES The wcswidth( ) function returns the number of display columns to be occupied by the number of wide characters (up to the terminating null wide character specified by the n parameter (or fewer) in the string pointed to by the pwcs parameter. A value of 0 (zero) is returned if the pwcs parameter is a wide-character NULL pointer or a pointer to a wide-character NULL pointer (that is, pwcs or *pwcs is NULL).
PAGE 1135
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1136
wcsxfrm(3) Guardian Native C Library Calls Reference Manual small to hold the entire transformed string. 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.
PAGE 1137
Guardian Native C Library Calls (t - z) wctob(3) NAME wctob - Converts wide-character to single-byte characater LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include #include /* optional except for POSIX.1 */ int wctob(wint_t c); PARAMETERS c The character to be evaluated and converted.
PAGE 1138
wctomb(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1139
Guardian Native C Library Calls (t - z) wctomb(3) 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 1140
wctrans(3) Guardian Native C Library Calls Reference Manual NAME wctrans - Character transliteration function LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include wctrans_t wctrans(const char *charclass); PARAMETERS charclass Describes the transliteration mapping.
PAGE 1141
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1142
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 1143
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include
PAGE 1144
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1145
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 1146
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1147
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1148
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1149
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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1150
wprintf(3) Guardian Native C Library Calls Reference Manual NAME wprintf - Prints formatted output to the standard output stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int wprintf ( const wchar_t *format [, value] . . .
PAGE 1151
Guardian Native C Library Calls • (t - z) wprintf(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 wide-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.
PAGE 1152
wprintf(3) Guardian Native C Library Calls Reference Manual • An optional parameter indicating the size of the argument corresponding to the following character, 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 1153
Guardian Native C Library Calls (t - z) wprintf(3) — A z followed by an n conversion specifier indicates that the argument will be treated as a pointer to a signed integer type corresponding to the size_t argument. • 527192-018 A character that indicates the type of conversion to be applied: % Performs no conversion. Prints %. d or i Accepts an integer (int) value and converts it to signed decimal notation. The precision specifies the minimum number of digits to appear.
PAGE 1154
wprintf(3) Guardian Native C Library Calls Reference Manual specified). The E conversion character produces a number with uppercase E instead of lowercase e before the exponent. The exponent always contains at least two digits. If the value is 0 (zero), the exponent is 0 (zero). g or G Accepts a float or double value and converts it in the style of the e, E, or f conversion characters, with the precision specifying the number of significant digits. Trailing zeros are removed from the result.
PAGE 1155
Guardian Native C Library Calls (t - z) wprintf(3) to the specified width. For TNS/E systems only, the behavior of ls is the same as the behavior of S. p Accepts a pointer to void. The value of the pointer is converted to a sequence of printable characters, the same as unsigned hexadecimal integer (x). n Accepts a pointer to an integer into which is written the number of characters written to the output stream so far by this call. No argument is converted.
PAGE 1156
wprintf(3) Guardian Native C Library Calls Reference Manual [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write at or beyond the file offset maximum. [EILSEQ] An invalid wide character was detected. [EINTR] The operation was interrupted by a signal that was caught, and no data was transferred. [EINVAL] There are insufficient arguments.
PAGE 1157
Guardian Native C Library Calls (t - z) wscanf(3) NAME wscanf - Converts formatted input read from the standard input stream LIBRARY H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll SYNOPSIS #include int wscanf( const wchar_t *format [, *pointer] . . . ); PARAMETERS format Specifies the format conversion.
PAGE 1158
wscanf(3) Guardian Native C Library Calls Reference Manual Conversion Specifications Each conversion specification in the format parameter has the following syntax: %[digit$][*][width][sizecode]convcode • The character % (percent sign) or %digit$. The wscanf( ) 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 1159
Guardian Native C Library Calls (t - z) wscanf(3) — A z followed by a d, i, o, u, x, X, or n conversion code character indicates that the receiving variable is treated as a size_t or the corresponding unsigned integer type. • 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.
PAGE 1160
wscanf(3) Guardian Native C Library Calls Reference Manual n Consumes no input. The corresponding pointer parameter is a pointer to an integer into which is written the number of characters read from the input stream so far by this function. The assignment count returned at the completion of this function is not incremented. o Accepts an octal integer; the corresponding pointer parameter should be an integer pointer.
PAGE 1161
Guardian Native C Library Calls (t - z) wscanf(3) is added automatically. The results from the conversion are placed in *pointer unless you specify assignment suppression with an * (asterisk). Assignment suppression provides a way to describe an input field that is to be skipped. The input field is a string of non-white-space characters. It extends to the next inappropriate character or until width, if specified, is reached. The conversion code convcode indicates how to interpret the input field.
PAGE 1162
wscanf(3) Guardian Native C Library Calls Reference Manual [ENOMEM] Insufficient memory is available for the operation. [ENXIO] A request was made to a nonexistent device, or the request was outside the capabilities of the device. [EOVERFLOW] An attempt was made to read or write at or beyond the file offset maximum. RELATED INFORMATION Functions: atof(3), atoi(3), fp_class(3), fwscanf(3), getc(3), getwc(3), isnan(3), printf(3), swscanf(3).
PAGE 1163
Guardian Native C Library Calls (t - z) y0(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1164
y1(3) Guardian Native C Library Calls Reference Manual 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1165
Guardian Native C Library Calls (t - z) yn(3) 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCREDLL 32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcredll 64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycredll SYNOPSIS #include
PAGE 1166
yn(3) Guardian Native C Library Calls Reference Manual RELATED INFORMATION Functions: fp_class(3), isnan(3), j0(3), j1(3), jn(3), y0(3), y1(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: • 7−214 For IEEE floating-point data, errno is not set to [EDOM] when the value of x is NaN.
PAGE 1167
Permuted Index _____________________________ for a temporary file (OSS tmpnam( file (Guardian tmpfile64( temporary file (Guardian tmpfile( a temporary file (OSS tmpfile64( Opens a stream (Guardian fopen64( Opens a stream (OSS fopen64( Opens a stream (Guardian fopen( Opens a stream (OSS fopen( Opens a stream (OSS freopen64( Opens a stream (Guardian freopen( Opens a stream (OSS freopen( a stream (Guardian freopen64( Removes a file (Guardian remove( Removes a file (OSS remove( Renames a file (Guardian rename(
PAGE 1168
imaxabs: Computes _abs: Expands labs: Computes integer llabs: Computes aclsort: Sorts an function error strerror: function error strerror_r: Sorts an access control list list (ACL) trigonometric cosine function trigonometric cosine function/ hyperbolic cosine function hyperbolic cosine function for a/ hyperbolic cosine function for a/ trigonometric cosine function/ flockfile: Allows a thread to ftrylockfile: Allows a thread to signal signal: Specifies the process /Determines number of a/ dlsym: Obtains the
PAGE 1169
Guardian Native C Library Calls Reference Manual Computes the long double complex catan: Computes the complex Computes the float complex Computes the long double complex bcopy: Copies an bzero: Zeroes an characters with overlapping characters with overlapping wide characters with overlapping bcmp: Compares two carg: Computes the complex cargf: Computes the float complex Expands absolute value of its Computes the long double complex Gets flag letters from the Expands the greater of its two Expands the lesser
PAGE 1170
Permuted Index user/ getpwuid_r: Gets user /Gets file configuration heap consistency is checked of a stream if the stream is __ns_backup_fopen: Performs a __ns_backup_fopen64: Performs a __ns_start_backup: Creates a log10: Computes the float value log10f: Computes the long double/ log10l: Computes the exp2: Computes the float value exp2f: Computes the long double/ exp2l: Computes the log2: Computes the float value log2f: Computes the long double/ log2l: Computes the component of a pathname memory kind, of o
PAGE 1171
Guardian Native C Library Calls Reference Manual /SQL DECIMAL value stored in a DECIMAL value and stores it in a longlong_to_dec: Converts a in a C array of decimal to a absolute value absolute value complex absolute value cosine complex arc cosine hyperbolic cosine complex arc hyperbolic cosine complex arc hyperbolic cosine complex arc cosine the difference between two /error code for the most recent raise: Sends a signal to the array argument argument complex argument Compare two strings, ignoring Compar
PAGE 1172
Permuted Index isdigit: Tests for a digit isgraph: Tests for a graphic islower: Test for lowercase isprint: Tests for printable ispunct: Test for a punctuation isspace: Tests for a white space isupper: Test for an uppercase iswdigit: Tests for a wide digit iswgraph: Tests for wide graphic Stores formatted output into a Stores formatted output into a Stores formatted output into a stream ungetc: Pushes a stream ungetwc: Pushes a wide memchr: Finds a memchr64: Finds a wide-character strings with a wide-charac
PAGE 1173
Guardian Native C Library Calls Reference Manual mbsrtowcs: Convert a strtod: Converts a strtof: Converts a integer atol: Converts a integer atoll: Converts a integer strtol: Converts a long integer strtoll: Converts a strptime: Converts a integer strtoumax: Converts a mbstowcs: Converts a multibyte atoi: Converts a value strtoimax: Converts a long integer strtoul: Converts a in the/ wcsxfrm: Transforms wide fputwc: Writes a wide putwc: Writes a wide mbtowc: Converts a multibyte (restartable) mbrtowc: Conve
PAGE 1174
Permuted Index catalog catclose: fclose: endgrent: endpwent: dlresultcode: Returns the error wcrtomb: Convert a wide-character strxfrm: Transforms string for /wide character strings for wide-character strings using Compares strings using locale system: Executes an OSS shell an OSS shell command or TACL Generates an OSS interprocess case strcasecmp: wmemcmp: memcmp: memcmp64: strcmp: strcmp64: collation strcoll: bcmp: strncmp: strncmp64: case strncasecmp: wcscmp: using collation/ wcscoll: with a character co
PAGE 1175
Guardian Native C Library Calls Reference Manual ccosh: Computes the ccoshf: Computes the float ccoshl: Computes the long double csinh: Computes the csinhf: Computes the float csinhl: Computes the long double ctanh: Computes the ctanhf: Computes the float ctanhl: Computes the long double function clog: Computes the clogf: Computes the float clogl: Computes the long double cpow: Computes the cpowf: Computes the float cpowl: Computes the long double cproj: Computes the cprojf: Computes the float cprojl: Compu
PAGE 1176
Permuted Index conj: ccos: cexp: cosine ccosh: sine csinh: tangent ctanh: logarithm function clog: function cpow: function cproj: function csin: function csqrt: ctan: float value cbrtf: floating-point number cbrt: double value cbrtl: two calendar times difftime: erf: float value erff: long double value erfl: function hypot: function for float/ hypotf: function for long double/ hypotl: radix-independent/ scalbn: radix-independent float/ scalbnf: radix-independent long/ scalbnl: exp: for a float value expf: f
PAGE 1177
Guardian Native C Library Calls Reference Manual long double complex/ cimagl: trigonometric cosine/ acos: trigonometric cosine/ acosf: trigonometric cosine/ acosl: trigonometric sine/ asin: trigonometric sine/ asinf: trigonometric sine/ asinl: trigonometric tangent/ atan2: trigonometric tangent/ atan2f: trigonometric tangent/ atan2l: trigonometric tangent/ atan: trigonometric tangent/ atanf: trigonometric tangent/ atanl: cosine function acosh: cosine function for a/ acoshf: cosine function for a/ acoshl: si
PAGE 1178
Permuted Index float number nextafterl: floating-point/ nexttoward: float number nexttowardf: long double number nexttowardl: between two floating-point/ fdim: between two float values fdimf: between two long double/ fdiml: pow: float value powf: long double value powl: exponent as an integer ilogb: exponent of a float/ ilogbf: exponent of a long/ ilogbl: exponent as a/ logb: exponent as a float/ logbf: exponent as a long double/ logbl: complex value creal: complex value crealf: double complex value creall:
PAGE 1179
Guardian Native C Library Calls Reference Manual to a character string/ wcsrtombs: radix-64 ASCII string l64a: SQL DECIMAL/ longlong_to_dec: double-precision/ atof: long integer atol: long long integer atoll: time value strptime: double-precision/ strtod: floating-point value strtof: signed long integer strtol: signed long long/ strtoll: uintmax_t integer strtoumax: integer atoi: intmax_t value strtoimax: unsigned long integer strtoul: string strftime: wide-character string wcsftime: to a string ecvt: to a
PAGE 1180
Permuted Index strncpy: strncpy64: bcopy: memory memccpy: overlapping areas in/ memmove: overlapping areas in/ memmove64: into another wcscpy: strcpy: strcpy64: with a character count wcsncpy: wmemcpy: overlapping areas in/ wmemmove: of y sign of y for a float value sign of y for a long double/ cosine function cosine function for a float/ cosine function cosine function for a float/ cosine function for a long/ cacos: Computes the complex arc ccos: Computes the complex ccosf: Computes the float complex Compu
PAGE 1181
Guardian Native C Library Calls Reference Manual tmpfile( )/ tmpfile_oss: function sine function hyperbolic sine complex hyperbolic sine complex hyperbolic sine complex sine function square root function complex square root function complex square root function tangent tangent hyperbolic tangent complex hyperbolic tangent complex hyperbolic tangent complex tangent function Epoch into a date and time/ Epoch into a date and time/ cbrtf: Computes the number cbrt: Computes the cbrtl: Computes the setjmp: Saves
PAGE 1182
Permuted Index Associates a stream with a file Maps a stream pointer to a file select: Selects among file status mbsinit: get_max_assign_msg_ordinal: wide-character strings wcswidth: wide characters wcwidth: a multibyte character mblen: value of two/ fmax: value of two float/ fmaxf: value of two long double/ fmaxl: value of two/ fmin: value of two float/ fminf: value of two long double/ fminl: characters in a/ wcslen: wide character iswctype: assert: Inserts program fdim: Computes the positive times difftim
PAGE 1183
Guardian Native C Library Calls Reference Manual code for the most recent call to/ call to dlopen(), dlclose(), or external symbol in a/ /from a specified input stream but to the standard output stream but to a specified output stream but the standard input stream but cabsl: Computes the long cacosl: Computes the long cacoshl: Computes the long sine casinhl: Computes the long catanhl: Computes the long casinl: Computes the long catanl: Computes the long cargl: Computes the long conjl: Computes the long ccos
PAGE 1184
Permuted Index function of 1.0 plus x for a long the power function for a long error function for a long function minus 1.
PAGE 1185
Guardian Native C Library Calls Reference Manual error function error function for a float value error function for a long double/ for a float value for a long double value call/ dlresultcode: Returns the standard output, or standard standard output, or standard erf: Computes the erfc: Computes the complementary erfcf: Computes the complementary erff: Computes the erfcl: Computes the complementary value erfl: Computes the ferror: Tests the a message explaining a function a previous dynamic-link library mess
PAGE 1186
Permuted Index exp2: Computes the base-2 exp: Computes the value exp2f: Computes the base-2 value expf: Computes the exp2l: Computes the base-2 double value expl: Computes the expm1: Computes the for a float/ expm1f: Computes the for a long/ expm1l: Computes the regcomp: Perform regular regerror: Performs regular regexec: Performs regular regfree: Performs regular re_comp: Compiles regular re_exec: Executes regular regcmp: Compiles regular regex: Executes regular dlsym: Obtains the address of an absolute va
PAGE 1187
Guardian Native C Library Calls Reference Manual 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 /Performs a backup open for a character/ mknod: Creates a rename: Renames a function) rename_oss: Renames a remove_oss: Removes a tmpfile_oss: Creates a temporary /Creates a temporary /the name f
PAGE 1188
Permuted Index Sets floating-point exception Raises floating-point exception cabsf: Computes the cacosf: Computes the cosine cacoshf: Computes the tangent catanhf: Computes the casinhf: Computes the casinf: Computes the catanf: Computes the cargf: Computes the conjf: Computes the ccosf: Computes the cexpf: Computes the ccoshf: Computes the csinhf: Computes the ctanhf: Computes the function clogf: Computes the cpowf: Computes the cprojf: Computes the csinf: Computes the function csqrtf: Computes the ctanf: C
PAGE 1189
Guardian Native C Library Calls Reference Manual trigonometric sine function for a hyperbolic sine function for a hyperbolic tangent function for a the true gamma function for a error function for a function minus 1.
PAGE 1190
Permuted Index fp_class: Returns the class of a fpclassify: Classifies a signbit: Tests sign of a /string to a double-precision string to a double-precision string to a double-precision a wide-character string to a Converts a character string to a the multiply-add operation for positive difference between two acquire ownership of a stream numbers to floating-point/ float integers numbers to long double integers fflush: operation for floating-point/ operation for float values operation for long double values
PAGE 1191
Guardian Native C Library Calls Reference Manual array sprintf: Stores array swprintf: Stores stream fprintf: Prints stream fwprintf: Prints output stream printf: Prints output stream wprintf: Prints /Retrieves locale-dependent configuration attributes for an/ floating-point value floating-point value to an output stream specified output stream stream to a specified stream string to a stream /Breaks a float number into a a floating-point number into a a long double number into a double number into integral
PAGE 1192
Permuted Index Computes the hyperbolic cosine Computes the float complex power the long double complex power Computes the complex projection the float complex projection long double complex projection file (Guardian tmpfile64( ) file (Guardian tmpfile( ) temporary file (OSS tmpfile64( ) Computes the float complex sine the long double complex sine Computes the complex square root the float complex square root long double complex square root the long double complex tangent Computes the complementary error Wri
PAGE 1193
Guardian Native C Library Calls Reference Manual /Computes the hyperbolic sine /Computes the trigonometric sine /Computes the hyperbolic tangent /the trigonometric tangent tgammal: Computes the true gamma /Computes the Euclidean distance /Computes the Euclidean distance Opens a stream (OSS freopen64( ) 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 Computes the base-2 logarithm
PAGE 1194
Permuted Index pseudorandom number/ drand48: pseudorandom number/ jrand48: lcong48: Sets rule to seed48: Sets rule to srand48: Sets rule to end the current process abort: communication (IPC) key ftok: srand: random: srandom: pseudorandom number/ erand48: pseudorandom number/ lrand48: pseudorandom number/ mrand48: pseudorandom number/ nrand48: Initialize random number array used by the random number specified assign message assign message by logical-unit/ specified input stream the standard input stream char
PAGE 1195
Guardian Native C Library Calls Reference Manual group database getgrnam: group database/ getgrnam_r: times times: rounding direction fegetround: environment fegetenv: the real user ID of the/ cuserid: time: from the user database getpwent: from the user/ getpwent_r: from the user database getpwnam: from the user/ getpwnam_r: from the user database getpwuid: from the user/ getpwuid_r: process startup message stream a specified input stream from the standard input stream string from the standard input/ a Gua
PAGE 1196
Permuted Index 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 cacosh: Computes the complex arc ccosh: Computes the complex Computes the float complex arc Computes the float complex Computes the long double complex the long double complex arc acosh: Computes the inverse cosh: Computes the acoshf: Computes the inverse acoshl: Computes the inverse float value coshf: Computes the long double/ coshl: Computes the casinh: Co
PAGE 1197
Guardian Native C Library Calls Reference Manual fstat: Provides ANSI I/O /Returns file open state ANSI I/O /Returns the file state ANSI I/O /Sets the file state database getgrent: Gets group database/ getgrent_r: Gets group database getgrgid: Gets group database/ getgrgid_r: Gets group database getgrnam: Gets group database/ getgrnam_r: Gets group /the group name key to get group getpwent: Gets user attribute getpwent_r: Gets user attribute getpwnam: Gets user attribute getpwnam_r: Gets user attribute getp
PAGE 1198
Permuted Index 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 strchr64: Finds an string to a signed long long string to an unsigned long strings to an unsigned long strings to an unsigned long long strings to an uintmax_t of a long double value as an radi
PAGE 1199
Guardian Native C Library Calls Reference Manual Rounds float number to nearest floating-point numbers to nearest Rounds float number to nearest long double number to nearest long double number to nearest key ftok: Generates an OSS or changes the timeout value for a wide-character string to Converts a character string to an library handle and/ dlclose: function acosh: Computes the function/ acoshf: Computes the function/ acoshl: Computes the asinh: Computes the for a float/ asinhf: Computes the for a long/
PAGE 1200
Permuted Index control character properties of a wide character 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 seco
PAGE 1201
Guardian Native C Library Calls Reference Manual number to nearest long long/ nearest long long integer value number to nearest long long/ number to nearest long long/ nearest long long integer value number to nearest long long/ and unloads any dynamically /Opens a dynamic-link library since the Epoch to broken-down since the Epoch to broken-down strcoll: Compares strings using or queries the program’s current string for collation in current for collation in the current locale-dependent formatting/ paramete
PAGE 1202
Permuted Index characters toupper: Translates uppercase characters to characters towupper: Translates uppercase characters to towlower: Translate uppercase to distributed pseudorandom number/ number to nearest long integer/ nearest long integer value to nearest long integer value number to nearest long integer/ nearest long integer value number to nearest long integer/ and update a symbolic link or any file page allocator Guardian file number gfileno: descriptor fileno: Perform regular expression Performs r
PAGE 1203
Guardian Native C Library Calls Reference Manual malloc_pages: Provides a memory page allocator .................................................. malloc_pages(3) Finds a wide character in memory wmemchr: ....................................................... wmemchr(3) Compare wide characters in memory wmemcmp: ..................................................... wmemcmp(3) memset: Sets characters in memory ............................. memset(3) memory memset64: Sets characters in ......................
PAGE 1204
Permuted Index clog: Computes the complex clogf: Computes the float complex /Computes the long double complex log: Computes the float value logf: Computes the long double/ logl: Computes the plus x log1p: Computes the plus x for/ log1pf: Computes the plus x for/ log1pl: Computes the number to nearest integral value to nearest integral value number to nearest integral value roundf: Rounds float number to Rounds floating-point number to Rounds long double number to /Rounds floating-point number to /Rounds flo
PAGE 1205
Guardian Native C Library Calls Reference Manual a radix-independent long double of a radix-independent float initstate: Initialize random state array used by the random stream pointer to a Guardian file radix-independent floating-point frexp: Breaks a floating-point power of/ frexpf: Breaks a float frexpl: Breaks a long double modf: Breaks a floating-point fractional/ modff: Breaks a float modfl: Breaks a long double Tests whether a floating-point whether a value is NaN (not a a radix-independent long doub
PAGE 1206
Permuted Index llrint: Rounds floating-point integer/ llrintf: Rounds float llrintl: Rounds long double llround: Rounds floating-point integer/ llroundf: Rounds float llroundl: Rounds long double trunc: Rounds floating-point truncf: Rounds float truncl: Rounds long double rand: Returns pseudorandom random: Generates random srand: Generates pseudorandom srandom: Generates random numeric value of two float numeric value of two long double numeric value of two float numeric value of two long double rand_r: Ret
PAGE 1207
Guardian Native C Library Calls Reference Manual function) freopen64_oss: specified/ __ns_fopen64_special: specified/ __ns_fopen_special: output, or/ fopen64_std_file: output, or/ fopen_std_file: /the remainder of a division /the remainder of a division /the remainder of a division /the remainder of a division modulo remainder of a division /the remainder of a division fmaf: Computes the multiply-add modulo remainder of a division fma: Computes the multiply-add fmal: Computes the multiply-add /modulo remain
PAGE 1208
Permuted Index memmove64: Copies characters with /Copy wide characters with /Allows a thread to relinquish Allows a thread to acquire /Allows a thread to acquire 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 /Retrieves value of a parameter by /Formats a variable number of /Formats a variable number of /Formats a variable number of Formats a
PAGE 1209
Guardian Native C Library Calls Reference Manual float values fdimf: Computes the positive difference between two .................................. fdimf(3) long double/ fdiml: Computes the positive difference between two .................................. fdiml(3) pow: Computes the power function ............................. pow(3) cpow: Computes the complex power function ............................................................... cpow(3) cpowf: Computes the float complex power function ............
PAGE 1210
Permuted Index /Generates uniformly distributed /Generates uniformly distributed /to generate uniformly distributed /to generate uniformly distributed rand: Returns srand: Generates rand_r: Returns ispunct: Test for a iswpunct: Tests for a wide input stream ungetc: the input stream ungetwc: specified output stream standard output stream to the standard output stream/ specified output stream but does/ variable standard output stream a specified stream to the standard output stream string to the standard outp
PAGE 1211
Guardian Native C Library Calls Reference Manual vscanf: Converts formatted input vwscanf: Converts formatted input wscanf: Converts formatted input symbolic link fread: link readlink: creal: Computes the value crealf: Computes the complex/ creall: Computes the the username associated with the realloc: the error code for the most expressions logarithm of the gamma function logarithm of the gamma function time into a date and time string Coordinated Universal Time from the group database from the group datab
PAGE 1212
Permuted Index remove: ) function) remove_guardian: function) remove_oss: hdestroy: a division operation with/ of a division operation with/ of a division operation with/ /Renames a file (Guardian Renames a file or directory (OSS directory (Guardian rename( ) function) directory (OSS rename( )/ ) function) rename_guardian: rename: rename( ) function) rename_oss: clock: pointer of a stream ftello: pointer of a stream ftello64: pointer of a stream ftell: stream fgetpos: stream fgetpos64: stream fseek: stream
PAGE 1213
Guardian Native C Library Calls Reference Manual environment variable getenv_r: copysign: a float value copysignf: a long double value copysignl: pointer of a stream occurrence of a character numbers to nearest integral/ nearest integral value to nearest integral value cbrtf: Computes the cube Computes the complex square Computes the float complex square the long double complex square sqrtf: Computes the square cbrt: Computes the cube sqrt: Computes the square sqrtl: Computes the square cbrtl: Computes the
PAGE 1214
Permuted Index integral exponent of a/ a radix-independent/ a radix-independent float number a radix-independent long double/ scandir: scandir64: read from the standard input/ occurrence of a character index: of a character rindex: bsearch: Performs a binary lfind: Performs a linear lsearch: Performs a linear tfind: Finds a node in a binary twalk: Traverses a binary Deletes a node from a binary Builds and searches a binary tsearch: Builds and hsearch: wide-character string wcswcs: strrchr: strrchr64: of a
PAGE 1215
Guardian Native C Library Calls Reference Manual direction fesetround: wmemset: array used by the random number/ stream system: Executes an OSS signbit: Tests copysign: Returns x with the copysignf: Returns x with the copysignl: Returns x with the action to take upon delivery of a take upon delivery of a signal abort: Generates a software raise: Sends a floating-point value Converts a character string to a /Converts a character string to a sine function casin: Computes the complex arc Computes the float com
PAGE 1216
Permuted Index fputc: Writes a byte to a putc: Writes a byte to a putc_unlocked: Writes a byte to a Writes a wide character to a Writes a wide character to a nan: Returns quiet Nan for Returns a float quiet NaN for a long double quiet NaN for /Opens an ANSI I/O file to a /Opens an ANSI I/O file to a delivery of a signal signal: to attempt/ heap_min_block_size: strtok: (reentrant) strtok_r: into tokens wcstok: into a character array /Converts a C long long value to a array/ dec_to_longlong: Converts a floati
PAGE 1217
Guardian Native C Library Calls Reference Manual string strcat64: Appends a string to a ..................................... strcat64(3) character in string strchr: Finds an integer ................................................. strchr(3) character in string strchr64: Finds an integer ............................................. strchr64(3) strcmp: Compares strings ............................................. strcmp(3) strcmp64: Compares strings .........................................
PAGE 1218
Permuted Index a string from the standard input character from a specified input character from the standard input fopen_guardian: Opens a fopen64_guardian: Opens a freopen_guardian: Opens a freopen64_guardian: Opens a /thread to acquire ownership of a ownership of a stream if the fopen_oss: Opens a fopen64_oss: Opens a freopen_oss: Opens a function) freopen64_oss: Opens a descriptor fileno: Maps a number gfileno: Maps a output to the standard output a byte to a specified output a byte to the standard outpu
PAGE 1219
Guardian Native C Library Calls Reference Manual strtok: Splits strtok_r: Splits integer to a radix-64 ASCII occurrence of characters in a Returns quiet Nan for specified a float quiet NaN for specified double quiet NaN for specified time into a date and time the Epoch into a date and time /string to a character string to a wide-character of the initial segment of a of the initial segment of a Finds an integer character in Finds an integer character in length of initial segment of Converts a date and time t
PAGE 1220
Permuted Index wcstoul: Converts wide-character wcstoull: Converts wide-character wcscoll: Compares 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 string bytes in a string string to a time value in string in string segment of string string to a double-precision/ string to a floating-point value string to an intmax_t value tokens (reentrant) string to a signed lon
PAGE 1221
Guardian Native C Library Calls Reference Manual the float complex arc hyperbolic the long double complex arc double complex arc hyperbolic Computes the complex hyperbolic the float complex hyperbolic long double complex hyperbolic tan: Computes the trigonometric tanh: Computes the hyperbolic the inverse trigonometric Computes the inverse hyperbolic Computes the long double complex value /the inverse trigonometric /Computes the inverse hyperbolic tanf: Computes the trigonometric tanhf: Computes the hyperbol
PAGE 1222
Permuted Index isalpha: character iswalpha: character isalnum: character iswalnum: isascii: iscntrl: isfinite: isinf: isprint: iswgraph: isunordered: equal to y isgreaterequal: isgreater: greater than y islessgreater: to y islessequal: isless: value signbit: stream ferror: number is infinite finite: a number) isnan: unordered relative to/ unordered: search tree function function for a float value function for a long double value stream flockfile: Allows a stream if/ ftrylockfile: Allows a a stream funlockfi
PAGE 1223
Guardian Native C Library Calls Reference Manual to uppercase characters toupper: to uppercase/ _toupper: wide characters towupper: to lowercase tolower: to lowercase/ _tolower: towctrans: Character wctrans: Character twalk: 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 a/ acosf: Computes the inverse a/ acosl: Computes the inverse a float value cosf: Computes the a long double/ cosl: Comp
PAGE 1224
Permuted Index value is unordered relative to/ wide-character strings to an Converts a character string to an strtoull: Converts a string to an /wide-character strings to an Performs a linear search and environment feupdateenv: /Specifies the action to take isupper: Test for an iswupper: Tests for a wide tolower: Translates characters _tolower: Translates lowercase characters to lowercase characters to characters towlower: Translate towupper: Translates lowercase to /minimum block size to attempt to the use
PAGE 1225
Guardian Native C Library Calls Reference Manual a division operation for a float cosine function for a float cosine function for a long double sine function for a float sine function for a long double tangent function for a float string to a floating-point string to a floating-point x with the sign of y for a float the sign of y for a long double the real part of a complex the real part of a float complex part of a long double complex the error function for a float error function for a long double exponent
PAGE 1226
Permuted Index number to nearest long integer number to nearest long integer number to nearest integral numbers to nearest integral number to truncated integer number to nearest long integer to nearest long long integer to nearest long long integer Tests sign of a floating-point decimal to/ /Converts SQL DECIMAL a character string to a time a character string to an intmax_t is unordered relative to another true gamma function for a float gamma function for a long double function for a long double function f
PAGE 1227
Guardian Native C Library Calls Reference Manual sysconf: Gets configurable system for a variable-length parameter/ flag letters from the argument number of parameters for output read from the standard input/ number of parameters for output input read from the standard/ to/ chvol: Changes default number of parameters for output read from the standard input/ number of parameters for output/ number of parameters for output/ read from a character string number of parameters for output/ input read from a wide-c
PAGE 1228
Permuted Index 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 output stream putwchar: Writes a wctype: Gets a handle to classify wmemcmp: Compare wmemcpy: Copy wmemset: Sets Translate uppercase to lowercase Translates lowercase to
PAGE 1229
Guardian Native C Library Calls Reference Manual in memory memory with overlapping areas in memory memory getw: Gets a putw: Writes a to the standard output stream output stream fputc: output stream putc: output stream but/ putc_unlocked: output stream putchar: output stream/ putchar_unlocked: function error perror: fputs: output stream puts: specified stream fputwc: specified stream putwc: standard output stream putwchar: a stream fputws: the standard output/ putws: putw: fwrite: read from the standard inp
PAGE 1230
-1- Index _____________________________ Symbols __ns_backup_fopen function, 5-23 to 5-24 __ns_backup_fopen64 function, 5-25 to 5-26 __ns_fget_file_open_state function, 5-27 to 5-28 __ns_fget_file_state function, 5-29 to 5-30 __ns_fopen64_special function, 5-31 to 5-33 __ns_fopen_special function, 5-34 to 5-36 __ns_fset_file_state function, 5-37 to 5-38 __ns_start_backup function, 5-39 to 5-41 A a64l function, 1-2 abort fault, and assert macro, 1-31 abort function, 1-3 abs function, 1-5 _abs macro, 1-4 ab
PAGE 1231
atanf function, 1-39 atanh function, 1-40 atanhf function, 1-42 to 1-43 atanhl function, 1-44 to 1-45 atanl function, 1-46 atexit function, 1-47 atof function, 1-48 to 1-49 atoi function, 1-50 atol function, 1-51 atoll function, 1-52 attributes of file, 2-83 B base 10 logarithm functions, 4-46, 4-47 base-2 exponential function, 1-193, 1-194, 1-195 base-2 logarithm, of x, 4-54, 4-55, 4-56 bcmp function, 1-54 bcopy function, 1-55 bessel functions 1st kind, order 0 (zero), 4-2 to 4-3 1st kind, order 1, 4-4 to
PAGE 1232
Guardian Native C Library Calls Reference Manual 3-119, 3-121, 3-124, 3-135 converting multibyte to wide, 4-94 finding length of multibyte, 4-84 getting from input stream, 2-37, 3-72, 3-74 locating first occurrence in a string, 7-149 pushing back, 7-53, 7-54 translating to 7-bit ASCII, 7-37 translating to lowercase, 7-38, 7-39, 7-43 translating to uppercase, 7-40, 7-41, 7-44 character string converting multibyte to wide, 4-93 converting to floating point, 1-48, 6-122, 6-124 converting to integer, 1-50, 1-51
PAGE 1233
Index projection, 1-130, 1-131, 1-132 real part of z, 1-133, 1-134, 1-135 sine, 1-136, 1-137, 1-141 square root, 1-142, 1-143, 1-144 tangent, 1-145, 1-146, 1-150 complex hyperbolic cosine functions, 1-93, 1-94, 1-95 complex hyperbolic sine functions, 1-138, 1-139, 1-140 complex hyperbolic tangent functions, 1-147, 1-148, 1-149 complex natural logarithm of z functions, 1-109, 1-110, 1-111 complex power functions, 1-127, 1-128, 1-129 complex projection functions, 1-130, 1-131, 1-132 complex sine functions, 1-
PAGE 1234
Guardian Native C Library Calls Reference Manual csinf function, 1-137 csinh function, 1-138 csinhf function, 1-139 csinhl function, 1-140 csinl function, 1-141 csqrt function, 1-142 csqrtf function, 1-143 csqrtl function, 1-144 ctan function, 1-145 ctanf function, 1-146 ctanh function, 1-147 ctanhf function, 1-148 ctanhl function, 1-149 ctanl function, 1-150 ctime function, 1-151 ctime_r function, 1-152 to 1-153 cube root function, 1-88 cube root functions, 1-89, 1-90 cuserid function, 1-154 to 1-155 dire
PAGE 1235
Index [EBADF], 3-101 [EDOM], 3-5, 4-29 [EFAULT], 7-19 [EINVAL], 1-103, 3-31, 3-58, 3-63, 5-82, 6-41, 6-165 [EIO], 1-155, 3-25, 3-31, 3-52, 3-58, 3-63 [EISGUARDIAN], 3-101 [EMFILE], 3-25 [ENAMETOOLONG], 2-155 [ENETDOWN], 2-86 [ENOCRE], 1-155, 3-31, 3-52, 3-58, 3-63 [ENOENT], 3-25, 3-31, 3-52, 3-58, 3-63 [ENOMEM], 1-155, 3-25, 3-31, 3-52, 3-58, 3-63 [ENOROOT], 2-155 [ENOTOSS], 5-82, 6-41 [ENOTSUP], 2-71, 2-80, 2-116, 2-123, 2-156 [ERANGE], 3-53, 3-58, 3-63 [EWRONGID], 2-86, 3-25 [[ENAMETOOLONG], 3-58 errno va
PAGE 1236
Guardian Native C Library Calls Reference Manual fflush function, 2-27 to 2-28 ffs function, 2-29 fgetc function, 2-30 to 2-31 fgetpos function, 2-32 fgetpos64 function, 2-33 to 2-34 fgets function, 2-35 to 2-36 fgetwc function, 2-37 to 2-38 fgetws function, 2-39 file, removing, 5-115, 5-116, 5-118 fileno function, 2-40 files attributes of, 2-83 name for temporary, 7-10, 7-30, 7-31, 7-33, 7-35 sorting ACL entries for, 1-6 temporary, 7-20, 7-21, 7-22, 7-24, 7-26, 7-28 finite function, 2-41 finite value, chec
PAGE 1237
Index 2-69 to 2-72 fopen64_guardian function, 2-66 to 2-68 fopen64_oss function, 2-69 to 2-72 fopen64_std_file function, 2-73 to 2-74 fopen_guardian function, 2-75 to 2-77 fopen_oss function, 2-78 to 2-81 fopen_std_file function, 2-82 formatted input, converting, 1-57, 2-130, 2-159, 2-169, 4-86, 4-88, 4-90, 4-91, 6-19, 6-73, 6-155, 7-42, 7-68, 7-81, 7-89, 7-104, 7-117, 7-125, 7-131, 7-151, 7-185, 7-188, 7-205 formatting monetary strings, 6-93 output, 2-91, 2-160, 5-52, 6-58, 6-148, 7-198 output parameters,
PAGE 1238
Guardian Native C Library Calls Reference Manual getpwnam function, 3-54 to 3-55 getpwnam_r function, 3-56 to 3-58 getpwuid function, 3-59 to 3-60 getpwuid_r function, 3-61 to 3-64 gets function, 3-65 to 3-66 getw function, 3-70 to 3-71 getwc function, 3-72 to 3-73 getwchar function, 3-74 getws function, 3-75 get_assign_msg function, 3-8 to 3-9 get_assign_msg_by_name function, 3-10 get_max_assign_msg_ordinal function, 3-40 to 3-41 get_param_by_name function, 3-45 get_param_msg function, 3-46 to 3-47 get_sta
PAGE 1239
Index pushing back character, 7-53, 7-54 input stream getting character from, 2-30, 2-37, 3-11, 3-13, 3-15, 3-17, 3-72, 3-74 getting word from, 2-37, 3-70, 3-72, 3-74 integers absolute value, 1-4, 1-5, 3-94, 4-11, 4-30 division, 1-158, 3-95, 4-20, 4-31 interprocess communications key, generating, 2-154 interval timers changing timeout, 1-16 setting timeout, 1-16 inttypes.
PAGE 1240
Guardian Native C Library Calls Reference Manual 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 ldexpf function, 4-16 to 4-17 ldexpl function, 4-18 to 4-19 ldiv function, 4-20 less than, checking, 3-110 less than or equal, checking, 3-111 less than or greater than, checking, 3-112 lfind function, 4-21 lgamma function, 4-22 to 4-23 lgammaf function, 4
PAGE 1241
Index M malloc function, 4-81 malloc_pages function, 4-82 managing binary search trees, 7-9, 7-13, 7-48, 7-50 manipulating strings, 6-80, 6-81, 6-84, 6-85, 6-87, 6-88 mathematical funcitions, pseudorandom number generation, 1-173 mathematical functions, 1-8 absolute value, 1-4, 1-5, 3-94, 4-11, 4-30 base 10 logarithm, 4-44, 4-46, 4-47 base-2 exponential, 1-193, 1-194, 1-195 base-2 logarithm of x, 4-54, 4-55, 4-56 Bessel 1st kind, order 0 (zero), 4-2 1st kind, order 1, 4-4 1st kind, order n, 4-6 2nd kind, o
PAGE 1242
Guardian Native C Library Calls Reference Manual less than or greater than (check), 3-112 lesser of two arguments, 4-107 logarithm of gamma function, 3-2 logarithm of the gamma function, 4-22, 4-24, 4-26 long integral exponent of radix-independent floating-point, 6-4, 6-6, 6-8 maximum numeric value functions, 2-52, 2-53, 2-54 maximum of two arguments, 4-83 minimum numeric value functions, 2-55, 2-56, 2-57 modulo remainder function, 2-58, 2-62 modulo remainder functions, 2-60 multiply-add functions, 2-46, 2-
PAGE 1243
Index tangent, 7-2, 7-4, 7-8 trigonometric cosine, 1-122, 1-126 true gamma function, 7-14, 7-15, 7-16 unordered (check), 3-120 updating the floating-point environment, 2-26 _max macro, 4-83 maximum numeric value functions, 2-52, 2-53, 2-54 mblen function, 4-84 to 4-85 mbrlen function, 4-86 to 4-87 mbrtowc function, 4-88 to 4-89 mbsinit function, 4-90 mbsrtowcs function, 4-91 to 4-92 mbstowcs function, 4-93 mbtowc function, 4-94 to 4-95 memccpy function, 4-96 memchr function, 4-97 memchr64 function, 4-98 mem
PAGE 1244
Guardian Native C Library Calls Reference Manual finding a character byte, 4-97, 4-98 finding a wide character byte, 7-192 to 7-193 setting area to zero, 1-58 setting characters in, 4-105, 4-106 setting wide characters in, 7-197 memset function, 4-105 memset64 function, 4-106 message, retrieving from message catalog, 1-85 message catalog closing, 1-84 opening, 1-86 retrieving a message from, 1-85 messages, for function errors, 5-42 _min macro, 4-107 minimum numeric value functions, 2-55, 2-56, 2-57 mktime f
PAGE 1245
Index P parameters formatting for output, 7-61, 7-74, 7-87, 7-95, 7-102, 7-110, 7-123 locale-dependent, 4-38 perror function, 5-42 positive difference functions, 2-9, 2-10, 2-11 POSIX User Thread Model asctime_r function, 1-20 ctime_r function, 1-152 flockfile function, 2-42 ftrylockfile function, 2-157 funlockfile function, 2-158 gamma_r function, 3-4 getchar_unlocked function, 3-15 getc_unlocked function, 3-17 getenv_r function, 3-23 gmtime_r function, 3-78 lgamma_r function, 4-28 localtime_r function, 4
PAGE 1246
Guardian Native C Library Calls Reference Manual returning, 5-84, 5-86 rand_r function, 5-86 to 5-87 real part of complex z functions, 1-133, 1-134, 1-135 realloc function, 5-88 regcmp function, 5-95 regcomp function, 5-97 regerror function, 5-97 regex function, 5-105 regexec function, 5-97 regfree function, 5-97 remainder function, 5-109, 5-111 remainder of division operation with quotient functions, 5-120, 5-121, 5-122 remainderf function, 5-111 to 5-112 remainderl function, 5-113 to 5-114 remove function
PAGE 1247
Index signbit function, 6-43 signgam global variable, 3-2 to 3-3, 3-4 to 3-5, 4-22 to 4-23, 4-24 to 4-25, 4-26 to 4-27, 4-28 to 4-29 sin function, 6-44 to 6-45 sinf function, 6-46 sinh function, 6-47 sinhf function, 6-48 sinhl function, 6-49 sinl function, 6-50 snprintf function, 6-51 to 6-57 sorting tables, 5-80 space class type test, 3-100, 3-102, 3-119, 3-124, 3-132 sprintf function, 6-58 to 6-64 SQL, 1-156, 4-69 to 4-70 sqrt function, 6-65 to 6-66 sqrtf function, 6-67 sqrtl function, 6-68 square root fu
PAGE 1248
Guardian Native C Library Calls Reference Manual setting file pointer for, 2-136, 2-139, 2-142, 2-145, 2-146, 5-123 testing EOF on, 2-19 testing error indicator on, 2-21 strerror function, 6-91 strerror_r function, 6-92 strfmon function, 6-93 to 6-96 strftime function, 6-97 to 6-102 string converting character to floating point, 1-48, 6-122, 6-124 converting character to integer, 1-50, 1-51, 1-52, 6-133, 6-136, 6-139, 6-142 converting character to intmax_t, 6-126 converting character to uintmax_t, 6-144 con
PAGE 1249
Index strstr64 function, 6-121 strtod function, 6-122 to 6-123 strtof function, 6-124 to 6-125 strtoimax function, 6-126 to 6-128 strtok function, 6-129 strtok_r function, 6-131 strtol function, 6-133 to 6-135 strtoll function, 6-136 to 6-138 strtoul function, 6-139 to 6-141 strtoull function, 6-142 to 6-143 strtoumax function, 6-144 to 6-145 structures, tms, 7-18 strxfrm function, 6-146 swprintf function, 6-148 to 6-154 swscanf function, 6-155 to 6-160 symbolic value ARG_MAX, 6-161 BC_BASE_MAX, 6-161 BC_DI
PAGE 1250
Guardian Native C Library Calls Reference Manual tgamma function, 7-14 tgammaf function, 7-15 tgammal function, 7-16 Threaded application, using alarm function, 1-16 signal function, 6-40 threads getgrent_r function, 3-26 getgrgid_r function, 3-32 getgrnam_r function, 3-37 getpwent_r function, 3-50 getpwnam_r function, 3-56 getpwuid_r function, 3-61 time conversion, 6-97, 7-140 time conversion functions, 1-19, 1-20 to 1-21, 1-151, 1-152 to 1-153, 1-157, 3-77, 3-78 to 3-79, 4-41, 4-42 to 4-43, 4-108 to 4-109
PAGE 1251
Index true gamma functions, 7-14, 7-15, 7-16 trunc function, 7-45 truncf function, 7-46 truncl function, 7-47 tsearch function, 7-48 to 7-49 twalk function, 7-50 type conversion, 1-156, 4-69 to 4-70 tzname external variable, 7-51 to 7-52 tzset function, 7-51 to 7-52 U ungetc function, 7-53 ungetwc function, 7-54 unordered, checking, 3-120 unordered function, 7-55 UNRESOLVED_PROCEDURE_CALLED function, 1-167 uppercase class type test, 3-100, 3-121, 3-133 user database accessing basic group information, 1-180
PAGE 1252
Guardian Native C Library Calls Reference Manual wcstof function, 7-157 to 7-158 wcstoimax function, 7-159 wcstok function, 7-162 wcstol function, 7-165 wcstoll function, 7-168 wcstombs function, 7-170 to 7-171 wcstoul function, 7-172 wcstoull function, 7-175 wcstoumax function, 7-177 wcswcs function, 7-180 wcswidth function, 7-181 wcsxfrm function, 7-183 wctob function, 7-185 wctomb function, 7-186 to 7-187 wctrans function, 7-188 wctype function, 7-189 wcwidth function, 7-191 wide characters appending, 7-