Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples
☜

$EXTRACT

1984 Version of ANSI Standard

☞

3.2.8 Functions function

$E[XTRACT]( expr )

returns the first (leftmost) character of the value of expr. If the value of expr is the empty string, the empty string is returned.

$E[XTRACT]( expr1 , intexpr2 )

Let s be the value of expr1, and let m be the integer value of intexpr2. $E(s,m) returns the mth character of s. If m is less than 1 or greater than $L(s), the value of $E is the empty string. (1 corresponds to the leftmost character of s; $L(s) corresponds to the rightmost character.)

$E[XTRACT]( expr1 , intexpr2 , intexpr3 )

Let n be the integer value of intexpr3. $E(s,m,n) returns the string between positions m and n of s. The following cases are defined:

  1. m > n. Then the value of $E is the empty string.
  2. m = n. $E(s,m,n) = $E(s,m).
  3. m < n < $L(s). $E(s,m,n) $E(s,m) concatenated with $E(s,m+1,n) That is, using the concatenation operator _ of Section 3.3.5, $E(s,m,n) _ $E(s,m) $E(s,m+1,n).
  4. m < n and $L(s) < n. $E(s,m,n) $E(s,m,$L(s)).

See also the transition diagram for $Extract.

Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples

Copyright © Standard Documents; 1977-2024 MUMPS Development Committee;
Copyright © Examples: 1995-2024 Ed de Moel;
Copyright © Annotations: 2003-2008 Jacquard Systems Research
Copyright © Annotations: 2008-2024 Ed de Moel.

This page most recently updated on 15-Nov-2023, 13:08:30.

For comments, contact Ed de Moel (demoel@jacquardsystems.com)