Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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) formatted string which is placed in buf and is up to
     buflen characters.	 If there was an overflow, 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 buffer, was not locale aware, handled unsigned long num‐
     bers, 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 sep‐
     arately in libutil for NetBSD 6.0.

AUTHORS
     Erik E. Fair ⟨fair@netbsd.org⟩

BSD				January 7, 2012				   BSD

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome