format - UDM Command

Owned by Stonebranch (Deactivated)
Jul 15, 2024

Syntax

format variable_name [{string_1|expression_1} [align={center|left|right|justify}] [pad=sequence] [trunc=yes|no] [length=length]]...[{string_n|expression_n} [align=center|left|right|justify] [pad=sequence] [trunc=yes|no] [length=length]]

Description

The format command creates a formatted string.

The first parameter, variable_name, is the variable or list element in which the newly formatted string is stored.

The second parameter, string_1 (or expression_1), is the first section of the string. Each additional, optional parameter specifies formatting that affect that string.

All following parameters, string_n (or expression_n), are the next sections of the string. Each additional, optional parameter specifies formatting that affect that string.

Parameters

Parameter

Description

variable_name

Variable or list element in which the newly formatted string is stored

string_1 | expression_1

First section of the string

align=center | left | right | justify

Method of how the value is aligned within the given space.

Default alignment is left.

pad=sequence

Character(s) used to pad out the formatted value.

Default is space character.

trunc=yes | no

Truncates the value to the length given by length if it is longer than that value.

Default is to not truncate.

length=length

Length of the formatted field.

Default is length of the value specified.

Examples


The following examples demonstrate the format command.

set firstname="Stonebranch"
set lastname="Incorporated"
format mystring "First Name: " "$(firstname)"  " Last Name: " +
"$(lastname)" length=3 trunc=yes*
echo "$(mystring)"*

Output:
First Name: Stonebranch Last Name: Inc

format mystring "The " "Value " "Is: " 4 length=8 align=right pad=0*
echo "$(mystring)"
The Value Is: E8E8E804