@lower |

Lowercase representation of a string.

Syntax: @lower(str)

str: string, alpha, svector

Return: string, alpha, svector

Returns the lowercase representation of the string str.

Lower triangular matrix of a matrix.

Syntax: @lower(m[, n])

m: matrix, sym

n (optional) integer

Return: matrix

Returns a matrix whose elements on and below the n-th diagonal match the corresponding elements of the matrix m, but whose elements above the n-th diagonal are zero.

By default, n is has a value of zero, indicating the main diagonal. Positive values of n indicate super-diagonals, while negative values of k indicate sub-diagonals.

Examples

String

If we define the string object

string s1 = "I did NOT do it"

the commands

@lower("I did NOT do it")

@lower(s1)

return the string “i did not do it”.

If ALPHA1 is an alpha series,

alpha alphalwr = @lower(alpha1)

returns the lowercase of the strings in ALPHA1 for each observation in the workfile sample.

If SVEC1 is an string vector,

svector sveclen = @lower(svec1)

returns a string vector containing the lowercased elements of SVEC1.

Matrix

The commands

matrix(3,3) m1

m1.fill 1, 2, 3, 4, 5, 6, 7, 8, 9

matrix l1 = @lower(m1)

matrix l2 = @lower(m1, 1)

matrix l3 = @lower(m1, -1)

create a matrix M1

the matrix L1 containing,

the matrix L2 containing,

and the matrix L3 containing

If we have the commands,

sym s = @rwish(@identity(5), 5)

matrix s1 = @lower(s)

matrix s2 = @lower(s, -1)

then S is a sym matrix and S1 is a lower triangular matrix with elements at or below the main diagonal equal to those in S, and elements below the main diagonal equal to zero. S2 is a strictly lower triangular matrix that is equal to S1, but with the main diagonal elements also set to 0.

Cross-references

See also
@upper.