format: formatting utilities

center

center text in given width
form: width center text

clipfmt

format data for clipboard
format array of rank 0 1 or 2 for clipboard.
columns are separated by TAB, rows by CRLF.

clipunfmt

unformat data read from clipboard
returns boxed matrix from clipboard result,
recognizing TAB and CRLF as separators.
characters are not converted to numbers.
e.g. try:  clipunfmt clipfmt i.5 6

colhdr

define column headers
returns matrix of column headers.

y = list with columns delimited by semicolons; and lines
     in each column delimited by commas.
x is wid or (wid;just), where:
  wid  = column widths
  just = a singleton or vector of:
       0 = centre header, then right justify (default)
       1 = center header in wid
       2 = right justify
       3 = left justify

e.g.  hdr=. 'Number,of,employees;Total,salary;Monthly,net,payment'
      (15 12 12;1) colhdr hdr

expandby

expand data with a given value
e.g.    0 1 0 0 1 expandby 99 [ 10 20
     99 10 99 99 20

expandn

expand data at every nth item
n expandn dat
expand array at every nth cell.
e.g. 'ABC DEF G' = 3 expandn 'ABCDEFG'

flatten

flatten array to a character string
flattens array to a character string with same display

fold

fold text to width
syntax:   {width} fold data
data is character vector
width defaults to screenwidth

nfmt

simple numeric formatter
simple format of numeric vector or matrix in readable form.
opt is optional, up to 3 elements:
  0 = maximum decimal places, max 9  (4)
  1 = minimum field width            (0)
  2 = display width                  (screenwidth)

ruler

formatted ruler
returns a formatted ruler
e.g.    ruler 75      horizontal
      1 ruler 30      vertical

sqzint

squeeze list of positive integers into short form
Squeeze list of positive integers into short character list.
If x = 1, sort y first.
e.g.  sqzint 1 2 3 7 8 9 10  =  1-3,7-10
see also <sqzrun>

sqzrun

squeeze list of numbers into short form
Squeeze list of numbers into short character list.
e.g.  sqzrun 1.1 1.1 1.1 7 9 9 10.25 = 3#1.1,7,2#9,10.25
See also <sqzint>.

xfmt

format extended integers
form: [width] xfmt number
groups in 3's up to 1e12, and 5's thereafter