The /returnex command immediately leaves the current subroutine and returns a given value back to the calling routine (if one exists). This command performs the same operation as /return with the exception of how it handles multiple spaces. All spaces, including leading, trailing, and multiple, are retained. (Normally multiple spaces are collapsed into a single space and leading and trailing spaces are trimmed off).

Synopsis

/returnex [value]

Switches

None

Parameters

• [value] - The value to return to the calling routine

Example

alias space_example {
  ; Prints 9: <space>A<space><space>B<space><space>C<space>
  echo -a $len($preserve_space)
 
  ; Prints 5: A<space>B<space>C
  echo -a $len($strip_space)
}
 
; Return with the spaces intact 
alias preserve_space returnex $get_abc
 
; Collaps spaces
alias strip_space return $get_abc
 
; Just an example string "<space>A<space><space>B<space><space>C<space>"
alias get_abc returnex $+($chr(32), A, $chr(32), $chr(32), B, $chr(32), $chr(32), C, $chr(32))

Compatibility

Added:

Added On:

Note: Individual switches were not taken into consideration.

See also

• List of commands
• List of identifiers
• $result
• /alias
• /return