/usr/man2/cat3/fmt.3.Z

NAME

       fmt - string formatting routines

SYNOPSIS

       #include <ast.h> #include <ls.h>

       char*       fmtbase(long number, int base, int prefix); char*      fmt-
       dev(struct stat* st); char*      fmtelapsed(unsigned  long  count,  int
       persec)  char*       fmterror(int errno); char*      fmtesc(const char*
       string); char*      fmtfs(struct stat* st); char*      fmtgid(int gid);
       char*       fmtmatch(const  char* re); char*      fmtmode(int mode, int
       external); char*      fmtperm(int perm); char*       fmtre(const  char*
       pattern); char*      fmtsignal(int sig); char*      fmttime(const char*
       format, time_t tm); char*      fmtuid(int uid);

DESCRIPTION

       These routines return a pointer  to  a  formatted  string  for  various
       numeric  and  string  entities.  Some routines may cache information to
       speed up the next call.  Most of the routines return  a  pointer  to  a
       private  buffer, the contents of which are overwritten on the next call
       to that routine.  Most fmt routines have a  corresponding  str  routine
       that  converts  in  the  other direction.  There is nothing spectacular
       about this collection other than that it provides a single place  where
       the exact format is spelled out.

       fmtbase  formats a base base representation for number.  If prefix != 0
       then the base prefix is included in the formatted string.  If number ==
       0 or base == 0 then the output is signed base 10.

       fmtdev  returns  the device handle name specified by the stat structure
       st.  This is the device information displayed by ls -l.

       fmtelapsed formats the elapsed time for  (count/persec)  seconds.   The
       two largest time units are used, limiting the return value length to at
       most 6 characters.  The units are:

       s      seconds

       m      minutes

       h      hours

       days

       weeks

       M      months

       Y      years

       S      scores

       fmterror returns the system error message text  for  the  error  number
       errno.

       fmtesc formats non-ASCII characters in string into C-style \ sequences.
       These sequences are understood by chresc and chrtoi.

       fmtfs returns the file system  type  name  corresponding  to  the  stat
       structure st.

       fmtgid returns the group name for gid.

       fmtmatch  returns  the  strmatch  equivalent  pattern  for  the regular
       expression pattern re.  0 is returned for invalid re.

       fmtmode returns the ls -l mode string for the file mode bits  in  mode.
       If external != 0 then mode is modecanon(3) canonical.

       fmtperm  returns the chmod permission string for the permission bits in
       perm.

       fmtre returns the regular expression equivalent pattern  for  the  str-
       match pattern pattern.  0 is returned for invalid pattern.

       fmtsignal returns the signal name, sans SIG, for the signal number sig.
       If sig < 0 then the description text for -sig is returned.

       fmttime returns the results of tmfmt(buf,sizeof(buf),format,tm) in  the
       private buffer buf.

       fmtuid returns the user name for uid.

SEE ALSO

       modecanon(3), str(3)

                                                                        FMT(3)