FMT(3ast)

NAME
fmt - string formatting routines

SYNOPSIS
    #include <ast.h>
    #include <ls.h>
    char*      fmtint(intmax_t number, int unsign);
    char*      fmtdev(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 routines have a corresponding 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.

is a performance-optimized function for formatting a base-10 integer number. If unsign != 0 then the number is treated as unsigned.

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

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

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

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

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

returns the group name for gid.

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

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

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

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

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

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

returns the user name for uid.

SEE ALSO
modecanon(3), str(3)