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

$TEXT

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

7.1.5.20 $Text

$T[EXT] ( textarg )

    textarg::=


+ intexpr [ ^ routineref ]
entryref
@ expratom V textarg



This form returns a string whose value is the contents of the line specified by the argument. Specifically, the entire line, with eol deleted, is returned.

If the argument of $Text is an entryref, the line denoted by the entryref is specified. If entryref does not contain dlabel then the line denoted is the first line of the routine. If the argument is of the form + intexpr [ ^ routineref ], two cases are defined. If the value of intexpr is greater than 0, the intexprth line of the routine is specified; if the value of intexpr is equal to 0, the routinename of the routine is specified. An error condition occurs, with ecode="M5", if the value of intexpr is less than 0. In all cases, if no routine is explicitly specified, the currently-executing routine is used.

If no such line as that specified by the argument exists, an empty string is returned. If the line specification is ambiguous, the results are not defined.

If a Character Set Profile input-transform is in effect, then the string is modified in accordance with the transform.

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 13-Sep-2014, 17:33:50.

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