Metalanguage, letter R

radius, RB, rcolor, readargument, readcount, recordfieldglvn, recordfieldvalue, relation, repcount, restartargument, rexpratom, rgvn, rlvn, rnref, routine, routineargument routineattribute routinebody, routinehead, routinekeyword routinename, routineparam routineparameters routineref, routinexpr, rowattribute, rowcol, rowcolsize, rowcolspec, rowkeyword, rssvn


radius

Introduced in the 1995 ANSI M[UMPS] Windowing Application Programmer's Interface standard.

This metalanguage symbol represents the radius in the context of a drawing command (ARC or PIE). The unit of measure for this value is determined by the value of the UNITS element attribute for the gadget in question.


RB

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents the special character "Right bracket" ("]"). This metalanguage element is used to avoid confusion between the metalanguage symbol that implies an optional element with the actual character.


rcolor

Introduced in the 1995 M[UMPS] Windowing Application Programmer's Interface.

This metalanguage symbol represents the level of the red component of a color. A color component level is an integer value (0 value 65,535).


readargument

Introduced in the 1977 ANSI M[UMPS] language standard.

This metalanguage symbol represents an occurrence of an argument of the READ command. Examples of valid arguments for the READ command appear in an earlier section. The argument of the READ command is either one of a list described below, or an indirection operator (@) followed by an expression that evaluates to a list (separated by commas) of such arguments.

A directly specified READ argument can be a string literal, a format specification, a name of a local variable (possibly subscripted), optionally followed by a colon and a time-out specification, or an asterisk followed by the name of a local variable (possibly subscripted), optionally followed by a colon and a time-out specification.

Modified in the 1995 ANSI M[UMPS] language standard.

A name of a global variable may also occur as an argument of the READ command.

A format specification can also be a reference to a device control function (see the metalanguage symbols mnemonicspace and controlmnemonic.


readcount

Introduced in the 1984 ANSI M[UMPS] language standard.

This metalanguage symbol represents the number of characters that will satisfy the current argument of the READ command.

The syntax definition of readcount includes the number sign (#) and the expression that evaluates to a numeric value.


recordfieldglvn

Approved for inclusion in a future ANSI M[UMPS] Language standard.

This metalanguage symbol represents a parameter of the intrinsic functions $DEXTRACT and $DPIECE. This parameter is a list (separated by commas) of destinations where values from fields in data records may be stored. Such destinations are typically local or global variables.


recordfieldvalue

Approved for inclusion in a future ANSI M[UMPS] Language standard.

This metalanguage symbol represents a parameter of the intrinsic functions $DEXTRACT and $DPIECE. This parameter is the value that will replace one field in a data record that is being manipulated by either of these functions.


relation

Introduced in the 1977 ANSI M[UMPS] language standard.

This metalanguage symbol represents any of the relational binary operators, i.e. one of =, <, >, [, ] or ]].


repcount

Introduced in the 1984 ANSI M[UMPS] language standard.

This metalanguage symbol represents the number of times that a certain pattern element may occur in the total pattern.

Examples:

12 exactly 12
. any number
5. at least 5
.9 at most 9


restartargument

Introduced in the 1995 ANSI M[UMPS] language standard.

This metalanguage symbol represents a list of variables that is to be reset when a transaction is restarted.

The specification of which variables to reset at a restart may look like:


rexpratom

Introduced in the 1984 ANSI M[UMPS] language standard.

This metalanguage symbol represents a part of an indirect reference to a global or local variable. In the context of an indirection of the type @name@(subscripts), this metalanguage symbol corresponds to the part between the indirection operators. This entity may be a regular local variable name (see metalanguage symbol rlvn, a regular global variable name (see metalanguage symbol rgvn or an expritem.

Approved for addition in a future ANSI M[UMPS] language standard.

The possibility that a rexpratom is a regular structured system variable name is added.


rgvn

Introduced in the 1984 ANSI M[UMPS] language standard.

This metalanguage symbol represents a regular global variable name. A regular global variable name may look like a name of a global variable (possibly with a list of subscripts enclosed in parentheses); it may look like a naked reference, or it may look like an indirection operator, followed by an expression that evaluates to a name of a global variable (possibly with a list of subscripts enclosed in parentheses), or it may look line an indirection operator followed by an expression that evaluates to a name of a global variable (possibly followed by a list of subscripts enclosed in parentheses, followed by an indirection operator, followed by a list of subscripts enclosed in parentheses.

Modified in the 1995 ANSI M[UMPS] language standard.

A non-naked reference to a global variable may include an environment specification.


rlvn

Introduced in the 1984 ANSI M[UMPS] language standard.

This metalanguage symbol represents a regular local variable name. A regular local variable name looks like either a name of a local variable (possibly with a list of subscripts enclosed in parentheses) or an indirection operator, followed by an expression that evaluates to a name of a local variable (possibly with a list of subscripts enclosed in parentheses), or it may look line an indirection operator followed by an expression that evaluates to a name of a local variable (possibly followed by a list of subscripts enclosed in parentheses, followed by an indirection operator, followed by a list of subscripts enclosed in parentheses.


rnref

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents a "regular" reference to a name. Such a reference can be either direct, or indirect.

Names, in this context, may reference local as well as global variables, with or without an environment specification, and with or without a list of subscripts.


routine

Introduced in the 1977 ANSI M[UMPS] language standard.

This metalanguage symbol represents the unit of program interchange. It begins with a header (see metalanguage symbol routinehead), which is not executable, followed by the executable code (see metalanguage symbol routinebody, followed by an "end of routine" marker (see metalanguage symbol eor).


routineargument

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents an argument of either of the commands RSAVE and RLOAD.

Such arguments look like the name of a routine, followed by a colon and the name of an array, optionally followed by another colon and a list of parameters, or an indirection operator (@) followed by an expression that evaluates to a list (separated by commas) of such arguments.


routineattribute

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents the name of an attribute for which a value may be defined in a parameter of an argument of the commands RSAVE and RLOAD.


routinebody

Introduced in the 1977 ANSI M[UMPS] language standard.

This metalanguage symbol represents the executable part of a routine. The routine body consists of one or more lines of M[UMPS] code, followed by an "end-of-routine" marker (see metalanguage symbol eor.


routinehead

Introduced in the 1977 ANSI M[UMPS] language standard.

This metalanguage symbol represents the header of a routine. This header consists of a text string that is equal to the name of the routine, followed by an "end-of-line" marker (see metalanguage symbol eol.


routinekeyword

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents the name of an keyword that may occur in a parameter of an argument of the commands RSAVE and RLOAD.


routinename

Introduced in the 1977 ANSI M[UMPS] language standard.

This metalanguage symbol represents the name of a routine.


routineparam

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents a parameter of an argument of the commands RSAVE and RLOAD. Such a parameter is either a keyword or a combination of the name of an attribute, an equal sign and a value.


routineparameters

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents the list of parameters that may occur in arguments of the commands RSAVE and RLOAD. Such a parameter list is either a single parameter or a list of parameters, enclosed in parentheses and separated by colons.


routineref

Introduced in the 1977 ANSI M[UMPS] language standard.

This metalanguage symbol represents a reference to a routine, either "directly" or "indirectly".

Modified in the 1995 ANSI M[UMPS] language standard.

A reference to a routine may include an environment specification.


routinexpr

Introduced in the 1995 ANSI M[UMPS] language standard.

This metalanguage symbol represents an expression that evaluates to the name of a routine.


rowattribute

Approved for inclusion in a future ANSI M[UMPS] Windowing Application Programmer's Interface standard.

This metalanguage symbol represents an expression that evaluates to the value "ROWHEIGHT" or to an implementation-specific value (starts with "Z").


rowcol

Introduced in the 1995 ANSI M[UMPS] Windowing Application Programmer's Interface standard.

This metalanguage symbol represents a code for the positioning of choices within a gadget. This metalanguage symbol occurs as an expression that evaluates to either of the values "COL" or "ROW".


rowcolsize

Introduced in the 1995 ANSI M[UMPS] Windowing Application Programmer's Interface standard.

This metalanguage symbol represents a numeric value that is one of the dimensions of the matrix in which the choices within a gadget are positioned. If the positioning is specified as "ROW", this value identifies the number of rows, if the positioning is specified as "COL", this value identifies the number of columns.


rowcolspec

Introduced in the 1995 ANSI M[UMPS] Windowing Application Programmer's Interface standard.

This metalanguage symbol represents a specification of how choices are positioned within a gadget. This metalanguage symbol occurs as an expression that evaluates to a string consisting of up to three pieces, separated by colons. The first piece is always present and identifies the orientation (row or column). The second piece is optional and identifies the dimension along the main orientation. The third piece is optional and identifies the direction for area-fill activity (horizontal or vertical).


rowkeyword

Approved for inclusion in a future ANSI M[UMPS] Windowing Application Programmer's Interface standard.

This metalanguage symbol represents an expression that evaluates to the value "ROW".


rssvn

Approved for inclusion in a future ANSI M[UMPS] language standard.

This metalanguage symbol represents a regular name for a structured system variable. A regular structured system variable name may look like a name of a structured variable (with a list of subscripts enclosed in parentheses); or it may look like an indirection operator, followed by an expression that evaluates to a name of a structured system variable (with a list of subscripts enclosed in parentheses), or it may look line an indirection operator followed by an expression that evaluates to a name of a structured system variable (possibly followed by a list of subscripts enclosed in parentheses, followed by an indirection operator, followed by a list of subscripts enclosed in parentheses.


This document is © Ed de Moel, 1995-2005.
It is part of a book by Ed de Moel that is published under the title "M[UMPS] by Example" (ISBN 0-918118-42-5).
Printed copies of the book are no longer available.

This document describes the various metalanguage terms starting with the letter "R" that are used throughout the M[UMPS] standards, as well as some other terms that may not be obvious to all readers of the M[UMPS] language standards.

The information in this document is NOT authoritative and subject to be modified at any moment.
Please consult the appropriate (draft) language standard for an authoritative definition.

In this document, information is included that will appear in future standards.
The MDC cannot guarantee that these 'next' standards will indeed appear.