ecvt(3) [ultrix man page]

ecvt(3) 						     Library Functions Manual							   ecvt(3)

Name
       ecvt, fcvt, gcvt - output conversion

Syntax
       char *ecvt(value, ndigit, decpt, sign)
       double value;
       int ndigit, *decpt, *sign;

       char *fcvt(value, ndigit, decpt, sign)
       double value;
       int ndigit, *decpt, *sign;

       char *gcvt(value, ndigit, buf)
       double value;
       char *buf;

Description
       The routine converts the value to a null-terminated string of ndigit ASCII digits and returns a pointer thereto.  The position of the radix
       character relative to the beginning of the string is stored indirectly through decpt (negative means to the left of the	returned  digits).
       If the sign of the result is negative, the word pointed to by sign is non-zero, otherwise it is zero.  The low-order digit is rounded.

       The routine is identical to except that the correct digit has been rounded for FORTRAN F-format output of the number of digits specified by
       ndigits.

       The routine converts the value to a null-terminated ASCII string in buf and returns a pointer to buf.  It attempts to produce  ndigit  sig-
       nificant digits in FORTRAN F format if possible, otherwise E format is used, ready for printing.  Trailing zeros may be suppressed.

       The  symbol used to represent a radix character is obtained from the last successful call to category The symbol can be determined by call-
       ing:
       nl_langinfo (RADIXCHAR);

       If category has not been called successfully, or if the radix character is not defined  for  a  supported  language,  the  radix  character
       defaults to a period (.).

   International Environment
       LC_NUMERIC     If  this	environment  is set and valid, uses the international language database named in the definition to determine radix
		      character rules.

       LANG	      If this environment is set and valid, uses the international language database named in the definition  to  determine  radix
		      character rules. If is defined, its definition supercedes the definition of

Restrictions
       The return values point to static data whose content is overwritten by each call.

See Also
       setlocale(3), nl_langinfo(3int), printf(3int), printf(3s)
       Guide to Developing International Software

																	   ecvt(3)

ecvt(3C)																  ecvt(3C)

NAME

       ecvt(), fcvt(), gcvt() - convert floating-point number to string

SYNOPSIS

   Obsolescent Interfaces
DESCRIPTION

       Converts    value  to  a  null-terminated  string  of ndigit digits and returns a pointer to the string.  The high-order digit is non-zero,
		   unless the value is zero.  The low-order digit is rounded.  The position of the radix character relative to	the  beginning	of
		   the	string is stored indirectly through decpt (negative means to the left of the returned digits).	The radix character is not
		   included in the returned string.  If the sign of the result is negative, the word pointed to by sign is non-zero, otherwise	it
		   is zero.

		   One	of  three  non-digit characters strings could be returned if the converted value is out of range.  A or is returned if the
		   value is larger than the exponent can contain, and is negative, or positive, respectively.  The third string is returned if the
		   number is illegal, a zero divide for example.  The result value is Not A Number (NAN) and would return a character.

       Identical to
		   except  that  the  correct  digit  has  been  rounded for printf (FORTRAN F-format) output of the number of digits specified by
		   ndigit.

       Converts the
		   value to a null-terminated string in the array pointed to by buf and returns buf.  It produces  ndigit  significant	digits	in
		   FORTRAN  F-format  if  possible,  or  E-format  otherwise.  A minus sign, if required, and a radix character is included in the
		   returned string.  Trailing zeros are suppressed.  The radix character is determined by the  currently  loaded  NLS  environment
		   (see  setlocale(3C)).   If  has  not  been  called  successfully, the default NLS environment, "C", is used (see lang(5)).  The
		   default environment specifies a period as the radix character.

   Obsolescent Interfaces
       and convert floating-point number to string.

EXTERNAL INFLUENCES

   Locale
       The category determines the value of the radix character within the current NLS environment.

WARNINGS

       The values returned by and point to an array whose content is overwritten by subsequent calls to these interfaces by the same thread.

       and are obsolescent interfaces supported only for compatibility with existing DCE applications. New multi-threaded applications should  use
       and

AUTHOR

       and were developed by AT&T.  was developed by AT&T and HP.

SEE ALSO

       setlocale(3C), printf(3S), lang(5), thread_safety(5), glossary(9).

STANDARDS CONFORMANCE

																	  ecvt(3C)