개요

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

gconvert(3c)

Standard C Library Functions                                      econvert(3C)



NAME
       econvert,  fconvert,  gconvert, seconvert, sfconvert, sgconvert, qecon‐
       vert, qfconvert, qgconvert - output conversion

SYNOPSIS
       #include <floatingpoint.h>

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


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


       char *gconvert(double value, int ndigit, int trailing, char *buf);


       char *seconvert(single *value, int ndigit, int *decpt, int *sign,
            char *buf);


       char *sfconvert(single *value, int ndigit, int *decpt, int *sign,
            char *buf);


       char *sgconvert(single *value, int ndigit, int trailing, char *buf);


       char *qeconvert(quadruple *value, int ndigit, int *decpt, int *sign,
            char *buf);


       char *qfconvert(quadruple *value, int ndigit, int *decpt, int *sign
            char *buf);


       char *qgconvert(quadruple *value, int ndigit, int trailing, char *buf);

DESCRIPTION
       The econvert() function converts the value to a null-terminated  string
       of ndigit  ASCII digits in buf and returns a pointer to buf. buf should
       contain at least ndigit+1 characters. The position of the decimal point
       relative  to  the  beginning of the string is stored indirectly through
       decpt. Thus buf == "314" and *decpt == 1 corresponds to  the  numerical
       value  3.14,  while  buf  ==  "314" and *decpt == −1 corresponds to the
       numerical value .0314. If the sign of the result is negative, the  word
       pointed to by sign is nonzero; otherwise it is zero. The least signifi‐
       cant digit is rounded.


       The fconvert() function works much like  econvert(),  except  that  the
       correct  digit  has  been  rounded as if for sprintf(%w.nf) output with
       n=ndigit digits to the right of the decimal point. ndigit can be  nega‐
       tive  to indicate rounding to the left of the decimal point. The return
       value  is  a  pointer   to   buf.   buf   should   contain   at   least
       310+max(0,ndigit) characters to accommodate any double-precision value.


       The  gconvert()  function converts the value to a null-terminated ASCII
       string in buf and returns a pointer to buf. It produces ndigit signifi‐
       cant  digits in fixed-decimal format, like sprintf(%w.nf), if possible,
       and otherwise  in  floating-decimal  format,  like  sprintf(%w.ne);  in
       either  case  buf  is  ready  for printing, with sign and exponent. The
       result corresponds to that obtained by

         (void) sprintf(buf, "%w.ng", value);



       If trailing = 0, trailing zeros and a trailing point are suppressed, as
       in  sprintf(%g).  If trailing != 0, trailing zeros and a trailing point
       are retained, as in sprintf(%#g).


       The seconvert(), sfconvert(), and sgconvert() functions are single-pre‐
       cision  versions  of  these  functions, and are more efficient than the
       corresponding double-precision versions.  A  pointer  rather  than  the
       value  itself  is passed to avoid C's usual conversion of single-preci‐
       sion arguments to double.


       The qeconvert(), qfconvert(), and qgconvert() functions are  quadruple-
       precision  versions  of  these  functions. The qfconvert() function can
       overflow the decimal_record field ds if value is  too  large.  In  that
       case, buf[0] is set to zero.


       The  ecvt(),  fcvt()  and  gcvt() functions are versions of econvert(),
       fconvert(), and gconvert(), respectively, that are  documented  on  the
       ecvt(3C)  manual  page.  They  constitute the default implementation of
       these functions and conform to the  X/Open  CAE  Specification,  System
       Interfaces and Headers, Issue 4, Version 2.

USAGE
       IEEE  Infinities  and  NaNs  are  treated similarly by these functions.
       "NaN" is returned for NaN, and "Inf" or "Infinity"  for  Infinity.  The
       longer form is produced when ndigit >= 8.

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 _ MT-LevelMT-Safe


SEE ALSO
       ecvt(3C), sprintf(3C), attributes(7)



Oracle Solaris 11.4               14 May 2018                     econvert(3C)