$len

Returns the length of a piece of text, i.e. the number of characters in it.

$len(text)

$len(test string) returns 11.

$len() is a simple, but powerful tool for processing strings.

Examples

This example turns uppercase letters to lowercase and vice-versa.
$len is used to get the length of the string (the value given to the alias) and loop through its every character.

alias changecase {
  var %i = 1, %str, %c
  while (%i <= $len($$1-)) {
    %c = $mid($1-, %i, 1)
    if ($isupper(%c)) {
      %str = %str $+ $lower(%c)
    }
    else {
      %str = %str $+ $upper(%c)
    }
    inc %i
  }
  return %str
}

echo -a $changecase(Hello)
; returns hELLO