☜	$EXTRACT 1977 Version of ANSI Standard					☞

3.2.8 Functions function

$E[XTRACT]( expr₁ , intexpr₂ )

returns the intexpr₂th character of the value of expr₁. That is, let m be the value of intexpr₂. If m is less than 1 or greater than $L(expr₁), the value of $E is the empty string. Otherwise, the value of $E is the mth character of the value of expr₁. (1 corresponds to the leftmost character; $L(expr₁) corresponds to the rightmost character.)

$E[XTRACT]( expr₁ , intexpr₂ , intexpr₃ )

returns the string between positions intexpr₂ and intexpr₃ of the value of expr₁. Let m be the value of intexpr₂ and let n be the value of intexpr₃. The following cases are defined:

1. m > n. Then the value of $E is the empty string.
2. m = n. $E(expr₁,m,n) = $E(expr₁,m).
3. m < n < $L(expr₁). $E(expr₁,m,n) = $E(expr₁,m) concatenated with $E(expr₁,m+l,n).
4. m < n and $L(expr₁) < n. $E(expr₁,m,n) = $E(expr₁,m,$L(expr₁)).

See also the transition diagram for $Extract.

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)