개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

ecvt(3c)

Standard C Library Functions                                          ecvt(3C)



NAME
       ecvt, fcvt, gcvt - convert floating-point number to string

SYNOPSIS
       #include <stdlib.h>

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


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


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

DESCRIPTION
       The  ecvt(), fcvt() and gcvt() functions convert floating-point numbers
       to null-terminated strings.

   ecvt()
       The ecvt() function converts  value  to  a  null-terminated  string  of
       ndigit  digits  (where ndigit is reduced to an unspecified limit deter‐
       mined by the precision of a  double)  and  returns  a  pointer  to  the
       string.  The  high-order  digit is non-zero, unless the value is 0. The
       low-order digit is rounded. The position of the radix  character  rela‐
       tive to the beginning of the string is stored in the integer pointed to
       by 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 integer pointed to by sign is non-zero,  other‐
       wise it is 0.


       If  the  converted  value  is out of range or is not representable, the
       contents of the returned string are unspecified.

   fcvt()
       The fcvt() function is identical to ecvt() except that ndigit specifies
       the number of digits desired after the radix point. The total number of
       digits in the result string is restricted to an  unspecified  limit  as
       determined by the precision of a double.

   gcvt()
       The gcvt() function converts value to a null-terminated string (similar
       to that of the %g format of printf(3C)) in the array pointed to by  buf
       and  returns  buf. It produces ndigit significant digits (limited to an
       unspecified value determined by the precision of a  double)  in  %f  if
       possible,  or  %e  (scientific  notation)  otherwise.  A  minus sign is
       included in the returned string if value is less than 0. A radix  char‐
       acter  is  included in the returned string if value is not a whole num‐
       ber. Trailing zeros are suppressed where value is not a  whole  number.
       The  radix  character  is  determined  by the current locale. If setlo‐
       cale(3C) has not been called successfully, the default  locale,  POSIX,
       is used. The default locale specifies a period (.) as the radix charac‐
       ter. The LC_NUMERIC category determines the value of the radix  charac‐
       ter within the current locale.

RETURN VALUES
       The  ecvt()  and fcvt() functions return a pointer to a null-terminated
       string of digits.


       The gcvt() function returns buf.

ERRORS
       No errors are defined.

USAGE
       The return values from ecvt() and fcvt() might point to thread-specific
       data  that can be overwritten by subsequent calls to these functions by
       the same thread.


       For portability to implementations conforming to  earlier  versions  of
       Solaris, sprintf(3C) is preferred over this function.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelSafe _ Standard‐
       See standards(7).


SEE ALSO
       printf(3C), setlocale(3C), sprintf(3C), attributes(7), standards(7)



Oracle Solaris 11.4               18 May 2004                         ecvt(3C)