Metalanguage, letter S

scrollbig, scrollby, scrollmax, scrollmin, scrollrange, scrollsmall, seloff, sepstr, servicename, setargument, setdestination, setdextract, setdpiece, setev, setextract, setleft, setpiece, setqsub, size, SP, ssvn, ssvname, ssvnamind, stackcode, stackcodexpr, startangle, strconst, strlit, sublit, subnonquote, svn, symbol, system, systemexpr


scrollbig

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

This metalanguage symbol represents a numeric value that indicates the value by which the VALUE attribute increases or decreases when an event occurs that causes "big" scrolling to occur (GOUPBIG, GODOWNBIG).


scrollby

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

This metalanguage symbol represents a code that that indicates the value bu which the VALUE attribute increases or decreases when an event occurs that causes scrolling to occur.This metalanguage symbol occurs as an expression that evaluates to a string consisting of two pieces, separated by commas. Both pieces are optional, but at least one must be present at all times. The first piece represents the value that is used when a "small" displacement event occurs. The second piece represents the value that is used when a "big" displacement event occurs.


scrollmax

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

This metalanguage symbol represents a numeric value that indicates the highest value in the value range that a scroll or long list box gadget will display.


scrollmin

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

This metalanguage symbol represents a numeric value that indicates the lowest value in the value range that a scroll or long list box gadget will display.


scrollrange

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

This metalanguage symbol represents the value range that a scroll or long list box gadget will display. This metalanguage symbol occurs as an expression that evaluates to a string consisting of two pieces, separated by commas. Both pieces are optional, but at least one must be present at all times. The first piece represents the lowest value in the range. The second piece represents the highest value in the range.


scrollsmall

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

This metalanguage symbol represents a numeric value that indicates the value by which the VALUE attribute increases or decreases when an event occurs that causes "small" scrolling to occur (GOUP, GODOWN).


seloff

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

This metalanguage symbol represents an integer value that indicates a selection offset range (see also the metalanguage symbol insel.


sepstr

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

This metalanguage symbol represents the value of one of the directives of the FORMAT library function. The value represented by this metalanguage symbol is the "seperator string", a string that contains a series of characters that are used (cyclically) to delimit entities of increasing orders of magnitude.


servicename

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

This metalanguage symbol represents the name of a property or a method of an object. Such a name may be either a M[UMPS] name, or a string literal.


setargument

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

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

The destination can be either the name of a variable (possibly subscripted), or a list of names of variables (possibly subscripted, separated by commas) enclosed in parentheses.

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

The destination can also be a specification of one or more pieces of information in a variable.

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

The destination can also be a specification of one or more characters in a variable.

The destination can also be $DEVICE, $ECODE, $ETRAP, $KEY, $X or $Y.

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

...


setdestination

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

This metalanguage element indicates where a SET command will store the information-specified on the right-hand side of the equal sign. The destination may be either a single one, or a list of destinations (separated by commas) enclosed in parentheses.

For a complete list of all possible destinations in the context of the SET command, see the metalanguage symbol setargument.


setdextract

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

This metalanguage symbol represents the specification of a data record, of which one or more fields may be extracted in the context of a SET $DEXTRACT command.


setdpiece

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

This metalanguage symbol represents the specification of a data record, of which one or more fields may be extracted in the context of a SET $DPIECE command.


setev

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

This metalanguage element represents one possible destination where the SET command may store information. This metalanguage symbol allows for the specification of $ECODE and $ETRAP in this context.

For a complete list of all possible destinations in the context of the SET command, see the metalanguage symbol setargument.


setextract

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

This metalanguage symbol represents the specification of a variable, of which one or more characters may be redefined in the context of a SET command.


setleft

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

This metalanguage element represents one possible destination where the SET command may store information.

For a complete list of all possible destinations in the context of the SET command, see the metalanguage symbol setargument.

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

The destination of a SET command may also be a property of an object.

SET word.bold=1
accesses the object that is accessible through the value of local variable word and sets its property bold to 1 (true).


setpiece

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

This metalanguage symbol represents the specification of a variable, of which one or more pieces of information may be redefined in the context of a SET command.


setqsub

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

This metalanguage symbol represents a reference to the intrinsic function $QSUBSCRIPT, in the context of a SET command, in a reference where the value of one subscript is being replaced.


size

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

This metalanguage symbol represents a specification of the dimensions of an entity. This metalanguage symbol occurs as an expression that evaluates to a string consisting of up to three pieces, separated by commas. All three pieces are optional, but at least one of the first two must be present at all times. The first piece represents the horizontal dimension. The second piece represents the vertical dimension. The third piece represents the units of measure.


SP

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

This metalanguage symbol represents the special character "Space". Since this character is normally not visible in printed text, the representation SP is used in the ANSI M[UMPS] language standard to indicate that this special character is present in a specific location.

Starting from the 1990 ANSI M[UMPS] language standard, this symbol is spelled as SP (underscored).


ssvn

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

This metalanguage symbol represents a structured system variable.

The structured system variables are ^$C[HARACTER](...), ^$D[EVICE](...), ^$G[LOBAL](...), ^$J[OB](...), ^$R[OUTINE](...) and ^$S[YSTEM](...).

Addition in the 1995 ANSI M[UMPS] Windowing Application Programmers Interface standard.

Additional structured system variables are ^$DI[SPLAY](...), ^$E[VENT](...) and ^$W[INDOW](...).


ssvname

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

This metalanguage symbol represents a part of the name of a structured system variable. Possible values are C or CHARACTER, D or DEVICE, G or GLOBAL, J or JOB, LI or LIBRARY, L or LOCK, R or ROUTINE, S or SYSTEM.


ssvnamind

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

This metalanguage symbol represents a part of an indirect reference to a structured system 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, a regular global variable name or an expritem. In this context, the value between the indirection operator must evaluate to a name of a structured system variable, possibly with a list of subscripts enclosed in parentheses.


stackcode

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

This metalanguage symbol represents the expression that qualifies which information about an error trap entry is to be reported. Valid codees are "PLACE", "MCODE" and "ECODE".


stackcodexpr

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

This metalanguage symbol represents the various codes that can be reported about an error trap. Valid codes are "PLACE", "MCODE" and "ECODE".


startangle

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

This metalanguage symbol represents the initial angle in the context of a drawing command (ARC or PIE). The angle is measured in degrees. 0 degrees is horizontal along the positive axis, 90 degrees is vertical along the positive axis.


strconst

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

This metalanguage symbol represents a string constant. A string constant appears in the context of "pattern ranges", and looks like either a string literal, or a reference to the intrinsic function $CHAR.


strlit

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

This metalanguage symbol represents a string literal value. A string literal value is any sequence of printable characters (see the metalanguage symbol nonquote) enclosed in quotes. If the quote character itself is to occur within the string literal value, it must be entered twice adjacently.

Value String literal notation
abcde "abcde"
ab"cde "ab""cde"
empty string ""
" """"
"" """"""


sublit

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

This metalanguage symbol represents a subscript string literal value. A subscript string literal value is any sequence of characters that are allowed in subscripts (see the metalanguage symbol subnonquote) enclosed in quotes. If the quote character itself is to occur within the subscript string literal value, it must be entered twice adjacently.


subnonquote

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

This metalanguage symbol represents any character that is valid in a subscript and that is not the quote character ($CHAR(34) or """").


svn

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

This metalanguage symbol represents a special variable name.

The special variables are $H[OROLOG], $I[O], $J[OB], $S[TORAGE], $T[EST], $X and $Y.

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

This standard introduces the special variables $D[EVICE], $EC[ODE], $ES[TACK], $ET[RAP], $K[EY], $P[RINCIPAL], $Q[UIT], $ST[ACK], $SY[STEM], $TL[EVEL] and $TR[ESTART].


symbol

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

This metalanguage symbol represents an identification of the type of symbols available through the Windowing Application Programmer's Interface. It is a string that evaluates to either one of "M,ERROR", "M,INFO", "M,QUEST" or "M,WARN", or to a value that identifies an external resource.


system

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

This metalanguage symbol represents the implementation-specific syntax for values of the intrinsic special variable $SYSTEM.


systemexpr

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

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


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 "S" 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.