Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

NetBSD 6.1.5 - man page for strspct (netbsd section 3)

STRPCT(3)			   BSD Library Functions Manual 			STRPCT(3)

NAME
     strpct, strspct -- decimal percent formatters

LIBRARY
     System Utilities Library (libutil, -lutil)

SYNOPSIS
     #include <util.h>

     char *
     strpct(char *buf, size_t bufsiz, uintmax_t numerator, uintmax_t denominator,
	 size_t precision);

     char *
     strspct(char *buf, size_t bufsiz, intmax_t numerator, intmax_t denominator,
	 size_t precision);

DESCRIPTION
     The strpct() function formats the fraction represented by numerator and denominator into a
     percentage representation with given number of digits of precision without using floating
     point arithmetic.

RETURN VALUES
     strpct() and strspct() always return a pointer to a NUL-terminated (unless buflen is 0) for-
     matted string which is placed in buf and is up to buflen characters.  If there was an over-
     flow, the formatted string will reflect that precision loss.

EXAMPLES
	   strpct(buf, buflen, 1, 16, 3);
	   => "6.250"
	   strpct(buf, buflen, 1, 2, 0);
	   => "50"

HISTORY
     strpct() was originally implemented in csh(1) for NetBSD 1.3.  It printed into a static buf-
     fer, was not locale aware, handled unsigned long numbers, and printed a ``%'' at the end of
     the number.  Other programs such as df(1) and time(1) started using it.  strpct() and
     strspct() appeared separately in libutil for NetBSD 6.0.

AUTHORS
     Erik E. Fair <fair@netbsd.org>

BSD					 January 7, 2012				      BSD


All times are GMT -4. The time now is 03:45 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password