Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples
Left Hand Pointer

$EXTRACT

1995 Version of ANSI (Equivalent to Current ISO Version) of Standard

Right Hand Pointer

7.1.5.4 $Extract

$E[XTRACT] ( expr )

This form 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] ( expr , intexpr )

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

$E[XTRACT] ( expr , intexpr1 , intexpr2 )

Let n be the integer value of intexpr2. $Extract(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 7.2.1.1, $E(s,m,n) = $E(s,m)_$E(s,m+1)_..._$E(s,m+(n-m)).
  4. m < n and $L(s) < n.
    $E(s,m,n) = $E(s,m,$L(s)).
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-2018 MUMPS Development Committee;
Copyright © Examples: 1995-2018 Ed de Moel;
Copyright © Annotations: 2003-2008 Jacquard Systems Research
Copyright © Annotations: 2008-2018 Ed de Moel.

This page most recently updated on 13-Sep-2014, 16:54:05 .

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