Manpage of ECVTBUF

Google
Web www.fiveanddime.net

ECVTBUF

Section: NEWLIB (3)
Updated: 2005 Feb 23
Index Return to Main Contents
 

NAME

1.14 `ecvtbuf', `fcvtbuf'--double or float to string

 

SYNOPSIS


     #include <stdio.h>


     char *ecvtbuf(double VAL, int CHARS, int *DECPT,
         int *SGN, char *BUF);


     char *fcvtbuf(double VAL, int DECIMALS, int *DECPT,
         int *SGN, char *BUF);  

DESCRIPTION

`ecvtbuf' and `fcvtbuf' produce (null-terminated) strings of digits representating the `double' number VAL.


   The only difference between `ecvtbuf' and `fcvtbuf' is the interpretation of the second argument (CHARS or DECIMALS). For `ecvtbuf', the second argument CHARS specifies the total number of characters to write (which is also the number of significant digits in the formatted string, since these two functions write only digits). For `fcvtbuf', the second argument DECIMALS specifies the number of characters to write after the decimal point; all digits for the integer part of VAL are always included.


   Since `ecvtbuf' and `fcvtbuf' write only digits in the output string, they record the location of the decimal point in `*DECPT', and the sign of the number in `*SGN'. After formatting a number, `*DECPT' contains the number of digits to the left of the decimal point. `*SGN' contains `0' if the number is positive, and `1' if it is negative. For both functions, you supply a pointer BUF to an area of memory to hold the converted string.

 

RETURNS

Both functions return a pointer to BUF, the string containing a character representation of VAL.

 

PORTABILITY

Neither function is ANSI C.


   Supporting OS subroutines required: `close', `fstat', `isatty', `lseek', `read', `sbrk', `write'.

 

SEE ALSO

ecvtbuf is part of the libc library. The full documentation for libc is maintained as a Texinfo manual. If info and libc are properly installed at your site, the command
info libc

will give you access to the complete manual.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURNS
PORTABILITY
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:25:16 GMT, May 16, 2005



www.fiveanddime.net








Google
Web www.fiveanddime.net