.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

.\" SUCH DAMAGE.

.\"

.Dt PKG_PRINTF 3

.Os

.Sh NAME

.Fa size

were unlimited

(again, not including the final

and the two functions

.Fn pkg_sbuf_printf

and

.Fn pkg_sbuf_vprintf

which return the given sbuf pointer, or

.Dv NULL

.Pp

The

.Fn pkg_asprintf

.It

Zero or more of the following flags:

.Bl -tag -width ".So \  Sc (space)"

The value should be converted to the

.Dq first alternate form .

.Pp

.Cm ( A, B , C , D , F , G , L , O , U , d ,

and

.Cm r )

.Cm ( t ) .

Which conversion characters are permissible in the row format is

context dependent.

.Sx FORMAT CODES

section for details.

.El

.Ss SCALE FACTORS

Humanized number conversions scale the number to lie within

the range 1 \- 1000 (power of ten conversions using the

format modifier) or 1 \- 1024 (power of two conversions using the

.Cm #

format modifier) and append a scale factor as follows:

.It Li Pi Ta No pebi   Ta 1,125,899,906,842,624

.It Li Ei Ta No exbi   Ta 1,152,921,504,606,846,976

.El

.Ss FORMAT CODES

Format codes will format the output classified as the type shown in

square brackets.

.It Cm %M

Package message [string]

.Vt struct pkg *

Repository identity [string]

.Vt struct pkg *

.It Cm \^%O

and the user's login shell; equivalent to one line from

.Fa /etc/master.passwd

as described in

.It Cm \^%V

Old version [string].

Valid only during operations when one version of a package is being

a numeric field;

if the result of a conversion is wider than the field width, the field

is expanded to contain the conversion result.

.Ss ARRAY VALUES

Effective format modifiers:

.Bl -tag -width ".So \  Sc" -offset indent

1st Alternate Form: 0 if the array is empty, 1 if it has any number

of elements within it

.It Cm #

2nd Alternate Form: The number of elements in the array

.El

.Ss STRING VALUES

Effective format modifiers:

.Bl -tag -width ".So \  Sc" -offset indent

.It Cm \-

Left align

.El

.Ss INTEGER VALUES

Effective format modifiers:

.Bl -tag -width ".So \  Sc" -offset indent

.It Cm \-

Left align

1st Alternate Form: humanized number (decimal)

.It Cm #

2nd Alternate Form: humanized number (binary)

.It Sq Cm '

Thousands separator

.El

.Ss BOOLEAN VALUES

The two possible values

.Sq true

.Sq false

may be output in one of three different styles: plain; or alternate

forms 1 and 2 specified using format modifiers.

.Bl -column "FALSE" "Plain (%a)" "Alt 1 (%?a)" "Alt 2 (%#a)" -offset indent

.It Sy "Value" Ta Sy "Plain (%a)" Ta Sy "Alt 1 (%?a)" Ta Sy "Alt 2 (%#a)"

.It Li FALSE Ta No false Ta no  Ta \^

.Pp

Effective format modifiers:

.Bl -tag -width ".Cm #" -offset indent

1st Alternate Form

.It Cm #

2nd Alternate Form

.It Cm \-

Left align

.El

.Ss FILE MODE VALUES

The file mode is a bitmap representing setid, user, group and other

permissions.

Whilst the second alternate form produces a string in the style of

.Xr strmode 3 :

.Bd -literal -offset indent

.Ed

.Pp

Note: there is always a space at the end of the

Additionally, when the value is printed as an integer (ie. plain

or alternate form 1), these additional modifiers take effect:

.Bl -tag -width ".So \  Sc" -offset indent

1st Alternate Form: add leading zero to octal integer

.It Cm 0

Zero pad

.El

.Ss LICENSE LOGIC VALUES

License-logic  is a three-valued type: one of

.Sq SINGLE ,

these should be treated as alternatives or applied in agregate.

There are three different output styles: plain; or alternate forms 1

and 2 specified using format modifiers.

.Bl -column "SINGLE" "Plain (%l)" "Alt 1 (%?l)" "Alt 2 (%#l)" -offset indent

.It Li SINGLE Ta No single Ta \^ Ta ==

.It Li OR     Ta No or     Ta |  Ta ||

.El

.Pp

Effective format modifiers:

.Bl -tag -width ".Cm #" -offset indent

1st Alternate Form

.It Cm #

2nd Alternate Form

.It Cm \-

Left align

.El

.Ss DATE-TIME VALUES

When used outside of a

.Dq row format

which will be used to format the timestamp.

Otherwise the timestamp is printed as an integer value of the

number of seconds since the Epoch (00:00:00 UTC, 1 January 1970; see

.Pp

Effective format modifiers:

.Bl -tag -width ".Cm \-" -offset indent

.Pp

Additionally, when the value is printed as an integer (ie. without

.Xr strftime 3

.Cm %{

and

.Cm %} ,

the following format modifiers are also effective:

.Bl -tag -width ".So \  Sc" -offset indent

1st Alternate Form: humanized number (decimal)

.It Cm #

2nd Alternate Form: humanized number (binary)

.It Sq Cm '

Thousands separator

.El

.Sh EXAMPLES

To print the package installation timestamp in the form

.Dq Li "Sunday, July 3, 10:02" ,