substring - UDM Command

Syntax

substring variable_name string {pos=position | startseq=sequence [startseqnum=number]} {length=length | endseq=sequence [endseqnum=number]} [case=yes|no]

Description

The substring command finds a substring in an existing string and stores it in a variable.

The first parameter, variable_name, specifies the name of the variable into which the substring is placed. The string parameter specifies the string from which the substring is taken.

The beginning of the substring is marked either by a position or a start sequence and optional sequence occurrence number (similar to deletestring). The end of the substring is determined by specifying the length of the substring or an ending sequence and optional sequence occurrence number, also similar to deletestring.

The case parameter specifies whether comparisons for start and end sequences are case sensitive (yes) or case insensitive (no). [Default is no.]

_lastrc.message is set to NO_MATCH if a start or end sequence was specified and could not be found. If the position or length are specified and contain invalid values, _lastrc.message will contain INVALID_VALUE.

Parameters

Parameter

Description

variable_name

Name of the existing variable into which the substring is placed.

string

String from which the substring is taken.

pos=position

Starting position of string to be taken (one based index)

startseq=sequence

Starting position of string to be taken (following a specific character sequence)

startseqnum=number

Occurrence number of starting position of string to be taken (following a specific character sequence)

length=length

Length of the string to be taken

endseq=sequence

Ending position of string to be taken (following a specific character sequence)

endseqnum=number

Occurrence number of ending position of string to be taken (following a specific character sequence

case=yes | no

Specification for whether or not the comparisons of the start and end sequences are case sensitive (yes) or case insensitive (no).

Default is no.

Examples

The following examples illustrate the substring command:

substring res "This is fun" pos=6 length=2
echo "$(res)"
is

substring res "This is less fun" startseq=" " endseq=" "
echo "$(res)"
is

substring res "This This is fun fun" startseq=" " endseq=" " +
          endseqnum=3
echo "$(res)"
This is fun