BTRON MicroScript Reference Manual

Display


_____
APPEAR
Syntax
Function
_____The APPEAR statement displays a specified segment in a window (in a case where another segment has been displayed, it is displayed by overlapping on top of it). In a case where the segment has already been displayed, it does nothing.
_____In specifying a segment, there is the method of directly specifying the segment name, the method of specifying a symbol variable in which the segment has been stored, and the method of specifying a variable segment variable. We can specify multiple segments by punctuating segment names, symbol variables, and variable segment variables with ' , ' and lining them up. In a case where a specified symbol variable or variable segment variable is empty (a state in which nothing has been specified), nothing will be displayed, and it also will not result in an error.
_____In a case where the SCENE statement has not yet been executed, a segment will be displayed in its original position in the figure. In a case where the SCENE statement has already been executed, the segment group displayed with the SCENE statement becomes the reference. Also, it is possible to move a segment and put it in place by using the MOVE statement beforehand.
_____In a case where we have attached ' ; ' after the APPEAR statement, or in a case where 'UPDATE 0' has been executed, the segment will not be immediately displayed, and execution will move to the next statement. We use this in making smooth, continuous displays, such as animation. In a case where nothing is attached at the end, the segment will be displayed immediately.
_____In a case where we have attached an effect name or step expression at the end of the APPEAR statement, an effect will be attached to the display of the segment. For effect names, please refer to the "EFFECT NAMES" entry (p. 77).
Errors that Occur at Startup Time
An item has not been defined
The segment name, symbol variable, or name of the variable segment variable is incorrect. Also, please confirm if you have not forgotten to insert " : " before the effect name.
Errors that Occur During Execution (only in the case of DEBUG 1; refer to p. 39)
There was an item that was not a segment
Something that is not a segment has been loaded in the symbol variable.
Errors that Are Stored into $ERR (refer to p. 170 concerning $ERR)
0_____ When we execute this statement, 0 gets loaded.
70, 71

_____
DISAPPEAR
Syntax
Function
_____The DISAPPEAR statement erases a specified segment from the top of the window.
_____In specifying a segment, there is the method of directly specifying the segment name, the method of specifying a symbol variable in which the segment has been stored, and the method of specifying a variable segment variable. We can specify multiple segments by punctuating segment names, symbol variables, and variable segment variables with ' , ' and lining them up. In a case where a specified symbol variable or variable segment variable is empty (a state in which nothing has been specified), nothing will be erased, and it also will not result in an error.
_____As to movement of the segment position based on the execution of the MOVE statement, there will be no return to its origin based on the execution of the DISAPPEAR statement.
_____In a case where we have attached ' ; ' after the DISAPPEAR statement, or in a case where 'UPDATE 0' has been executed, the segment will not be immediately erased, and execution will move to the next statement. We use this in making smooth, continuous displays, such as animation. In a case where nothing is attached at the end, the segment will be erased immediately.
_____In a case where we have attached an effect name or step expression at the end of the DISAPPEAR statement, an effect will be attached to the erasing of the segment. For effect names, please refer to the "EFFECT NAMES" entry (p. 77).
Errors that Occur at Startup Time
Please specify the segment
A numerical value, character string, etc., has been specified in the segment name.
An item has not been defined
The segment name, symbol variable, or name of the variable segment variable is incorrect. Also, please confirm if you have not forgotten to insert " : " before the effect name.
Errors that Occur During Execution (only in the case of DEBUG 1; refer to p. 39)
There was an item that was not a segment
Something that is not a segment has been loaded in the symbol variable.
72

I Reference Section

SCENE
Syntax
Function
_____The SCENE statement erases all the segments on a window, and then displays specified segments in their places in the window. In a case where multiple segments have been specified, they are displayed on top of each other in a specified order. In a case where not even one segment has been specified, the segments on top of the window will simply all be erased.
_____In specifying a segment, there is the method of directly specifying the segment name, the method of specifying a symbol variable in which the segment has been stored, and the method of specifying a variable segment variable. We can specify multiple segments by punctuating segment names, symbol variables, and variable segment variables with ' , ' and lining them up. In a case where a specified symbol variable or variable segment variable is empty (a state in which nothing has been specified), nothing will be erased, and it also will not result in an error.
_____The SCENE statement slides the positions of all segments in a manner in which the segment groups that will be displayed position exactly in the upper left of the window (it is similar to displaying by scrolling with the figure editor, but the upper left of the window is as is (0, 0) ). Accordingly, after we execute the SCENE statement, it will come about that positions of the segments displayed with the APPEAR statement, and the positions of the segments obtained with the .X state name and the .Y state name will change, so please be careful. In a case where we have not specified even one segment with the SCENE statement, changes of position based on the SCENE statement will be canceled.
_____For segments to be displayed with the SCENE statement, you can move their positions and put them in place by using the MOVE statement.
_____In a case where "UPDATE 0" has been executed, the segments will not be immediately displayed, and processing will proceed to the next statement.
_____In a case where we have attached an effect name and step expression at the end of the SCENE statement, effects will be attached to the display of the segments. For effect names, please refer to the items under "EFFECT NAMES" (p. 77). Step expressions specify the speed of the effect. If the step expression is large, the effect becomes slow.
Errors that Occur at Startup Time
Please specify the segment
A numerical value, character string, etc., has been specified in the segment name.
An item has not been defined
The segment name, symbol variable, or name of the variable segment variable is incorrect. Also, please confirm if you have not forgotten to insert " : " before the effect name.
Errors that Occur During Execution (only in the case of DEBUG 1; refer to p. 39)
There was an item that was not a segment
Something that is not a segment has been loaded in the symbol variable.
Errors that Are Stored in $ERR (in regard to $ERR, refer to p. 170)
0_____ When we execute this statement, 0 gets loaded.
73, 74

I Reference Section

MOVE
Syntax
Function
_____This moves the location of a specified segment. In a case where the segment is in display status, the results are reflected on the screen. In a case where a segment is in non-display status, the display will not change, but when we put the segment in display status by means of the APPEAR statement, etc., the results of the MOVE statement will be displayed in the reflected location.
_____In a case where we have omitted a standard segment, we move the segment relative to the extent of the specified X coordinate and Y coordinate. Even in a case where we have specified multiple segments as the targets of processing, each segment moves from its original position to the extent of the X coordinate and the Y coordinate.
_____In a case where we have specified a standard segment, we move the segment to the location of the X coordinate and the Y coordinate from the upper left of the standard segment. In specifying a standard segment also, a segment name, a symbol variable, or a variable segment variable can be used in the same manner as specifying the segment that is the target of processing.
_____In a case where we have specified @ instead of a standard segment, the segment will move to the location of the X coordinate and Y coordinate, after making the upper left of the window work region (0, 0). The work region refers to the range in which drawing can actually take place inside the window, and the window frame is not included.
_____When we specify :DUP, the segment is not moved, rather it is duplicated. The duplicated segment group is handled as one thing overall. Furthermore, a character segment or a virtual object segment cannot be duplicated.
_____In a case where we have omitted the specification of coordinates, we return to the initial location of the specified segment (the position of the segment created with the Basic Figure Editor). Moreover, duplications are all deleted.
Errors that Occur at Startup Time
Please specify the segment
The description of the movement target segment or standard segment is incorrect.
Please specify the integer items
Please use integers in the specification of the coordinates.
Please specify DUP
Please specify : DUP to leave the previous display.
Errors that Occur During Execution (only in the case of DEBUG 1; refer to p. 39)
There was an item that was not a segment
Something that is not a segment has been loaded in the symbol variable.
Errors that Are Stored in $ERR (in regard to $ERR, refer to p. 170)
0_____ When we execute this statement, 0 gets loaded.

75, 76

I Reference Section

EFFECT NAMES
Function
_____Effect names are things that specify display effects in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Among the effect names, there are the following types.
WIPE_D WIPE_U WIPE_R WIPE_L
SCRL_D SCRL_U SCRL_R SCRL_L
WIPE_V WIPE_H WIPE_C
STRP_H STRP_V MOSAIC
_____Concerning the respective display effect, please refer to the following pages. Also, concerning the methods of using display effects, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
77, 78, 79

_____
MOSAIC
Syntax
Function
_____MOSAIC is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
80

I Reference Section

SCRL_D
Syntax
Function
_____SCRL_D is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).

81

_____
SCRL_L
Syntax
Function
_____SCRL_L is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
82

I Reference Section

SCRL_R
Syntax
Function
_____SCRL_R is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).

83

_____
SCRL_U
Syntax
Function
_____SCRL_U is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
84

I Reference Section

STRP_H
Syntax
Function
_____STRP_H is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).

85

_____
STRP_V
Syntax
Function
_____STRP_V is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
86

I Reference Section

WIPE_C
Syntax
Function
_____WIPE_C is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).

87

_____
WIPE_D
Syntax
Function
_____WIPE_D is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
88

I Reference Section

WIPE_H
Syntax
Function
_____WIPE_H is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).

89

_____
WIPE_L
Syntax
Function
_____WIPE_L is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
90

I Reference Section

WIPE_R
Syntax
Function
_____WIPE_R is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).

91

_____
WIPE_U
Syntax
Function
_____WIPE_U is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).
92

I Reference Section

WIPE_V
Syntax
Function
_____WIPE_V is an effect name that is used in the APPEAR statement, the DISAPPEAR statement, and the SCENE statement. Concerning the actual display effect, there is a list at "EFFECT NAMES." Moreover, concerning the method of using effect names, please refer to the APPEAR statement (p. 70), the DISAPPEAR statement (p. 72), and the SCENE statement (p. 73).

93

_____
TEXT
Syntax
Function
_____The TEXT statement sets in a character segment a character string specified in a form character string or an expression.
_____For the details on form character strings and expressions, please refer to the item on FORM CHARACTER STRINGS (p. 96).
_____In a case where a character segment is in display status, display will be updated. However, the display region of the character segment will not be updated as it originally was. In a case where you have set a long character string that cannot fit in the display region, what will actually be displayed is just the portion that fits into the display region.
_____A character string that has been entered into a character segment will be lost.
_____The character attributes of a character segment will not be updated as they originally were. In a case where the beginning character of a character string that has been entered into a character segment is half-width, the newly set character string will become a half-width character string.
_____A character string that can be set as a character segment is 1,024 characters at maximum. Mixing together half-width characters and full-width characters is not possible.
Errors that Occur at Startup Time
A necessary item is lacking
Please confirm whether the character segment has been properly specified.
Please specify the character segment
Please confirm whether the character segment has been properly specified.
An item has not been defined
Please confirm whether the character segment has been properly specified.
Please specify a character string or a character array
Please confirm whether a character sting or a character array has been specified as a from character string.
There is no h at the end@of the character string
Please confirm whether the hh correspondence of the form character string or argument character string is correct.
Errors that Occur During Execution (only in the case of DEBUG 1; refer to p. 39)
There was an item that was not a character string or a character array
In spite of the fact that the argument should be a character string, it is not made up so. Please confirm whether or not the correspondence between the form character string and the argument is correct.
Errors that Are Stored into $ERR (refer to p. 170 concerning $ERR)
0_____ When we execute this statement, 0 gets loaded.
94

I Reference Section

MESG
Syntax
Function
_____The MESG statement outputs in the system area a character string specified in a form character string or an expression. This can be used for such things as the display of what's still in progress. In TiPO, even if you execute this statement, there will be no effect.
_____For the details on form character strings and expressions, please refer to the item on FORM CHARACTER STRINGS (p. 96).
Errors that Occur at Startup Time
Please specify a character string or a character array
Please confirm whether a character sting or a character array has been specified as a from character string.
There is no h at the end@of the character string
Please confirm whether the hh correspondence of the form character string or argument character string is correct.
Errors that Occur During Execution (only in the case of DEBUG 1; refer to p. 39)
There was an item that was not a character string or a character array
In spite of the fact that the argument should be a character string, it is not made up so. Please confirm whether or not the correspondence between the form character string and the argument is correct.
Errors that Are Stored into $ERR (refer to p. 170 concerning $ERR)
0_____ When we execute this statement, 0 gets loaded.

95

_____
FORM CHARACTER STRINGS
Function
_____Form character strings are used in the TEXT statement, the MESG statement, and the LOG statement, and they can include "form specifications" that specify the display style of numerical values and characters. The form specification inside a form character string corresponds in order to the expression that follows at the end of the form character string.
_____Among the form specifications, there are the following types. Moreover, in a case where you would like to describe % itself in a form character string, make it as "%%."
Decimal %d
Hexadecimal %x %X
Floating point %f %e %E %g %G
Character %c
Character string %s
_____For example, when we execute
_____
TEXT Segment, "Processing: %s(%d%%)", "Text", 20
_____
the form character string "Processing:" is output as is, and, "Text," which is the first expression, corresponds with "%s." The following "(" is output as is, and 20, which is the second expression, corresponds with "%d." "%%" are output as "%," and then ")" is output. As a result, the character string "Processing: Text(20%)" is stored in Segment.
_____It is also possible to enter control characters using "" inside a form character string. Please refer to "" (p. 4).
96

I Reference Section

%
Function
_____"%" means form specification inside a form character string. Form character strings are used in the TEXT statement, the MESG statement, and the LOG statement. Please refer to FORM CHARACTER STRINGS (p. 96).

97

_____
%%
Syntax
Function
_____"%%" can be output as "%" by using it inside a form character string. Form character strings are used in the TEXT statement, the MESG statement, and the LOG statement. Please refer to FORM CHARACTER STRINGS (p. 96).
98

I Reference Section

%c
Syntax
Function
_____"%c" is one form specification, which can output a character by regarding a numerical expression as a character code. It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____"%c" cannot output floating point values or character strings. Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).

99

_____
%d
Syntax
Function
_____"%d" is one form specification, which can specify outputting a numerical value in decimal form. It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where we have specified the "number of characters," we use at least a width to the extent of the number of characters. If we do not attach "0," the remaining places become spaces, and when we attach "0," the remaining places become "0." If we do not specify "-," the numerical value is output with right justification, and when we specify "-," the numerical value is output with left justification.
_____In cases where the number of characters have not been specified or the actual number of places is greater than the number of characters, the whole is output as is.
_____For example, the result of
TEXT Segment, "[%d] [%8d][%-8d][%08d]", 31,31,31,31
becomes as follows:
[31][      31][31      ][00000031]
_____Furthermore, we cannot output floating point values and character strings with "%d." Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).
100

I Reference Section

%E
Syntax
Function
_____"%E" is one form specification, which specifies outputting a numerical value in floating point format (1.234567E+02). It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where the "number of places below the decimal point" has not been specified, six places below the decimal point will be output. In a case where the number of places below the decimal point has been specified, the numerical value will be output with that number of places.
_____In a case where we have specified the "number of characters," we use at least a width to the extent of the number of characters. If we do not attach "0," the remaining places become spaces, and when we attach "0," the remaining places become "0." If we do not specify "-," the numerical value is output with right justification, and when we specify "-," the numerical value is output with left justification.
_____In cases where the number of characters have not been specified or the actual number of places is greater than the number of characters, the whole is output as is.
____For example, the result of
TEXT Segment, "[%E] [%15E][%-15E][%15.2E][%-15.2E]",1.234,1.234,1.234,1.234,1.234
becomes as follows:
[1.234000E+00][      1.234000E+00][1.234000E+00      ][      1.23E+00]
[1.23E+00      ]
_____Furthermore, we can handle numerical values, but we cannot output character strings with "%E." Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).

101

_____
%e
Syntax
Function
_____"%e" is one form specification, which specifies outputting a numerical value in floating point format (1.234567e+02). It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where the "number of places below the decimal point" has not been specified, six places below the decimal point will be output. In a case where the number of places below the decimal point has been specified, the numerical value will be output with that number of places.
_____In a case where we have specified the "number of characters," we use at least a width to the extent of the number of characters. If we do not attach "0," the remaining places become spaces, and when we attach "0," the remaining places become "0." If we do not specify "-," the numerical value is output with right justification, and when we specify "-," the numerical value is output with left justification.
_____In cases where the number of characters have not been specified or the actual number of places is greater than the number of characters, the whole is output as is.
____For example, the result of
TEXT Segment, "[%e] [%15e][%-15e][%15.2e][%-15.2e]",1.234,1.234,1.234,1.234,1.234
becomes as follows:
[1.234000e+00][      1.234000e+00][1.234000e+00      ][      1.23e+00]
[1.23e+00      ]
_____Furthermore, we can handle numerical values, but we cannot output character strings with "%e." Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).
102

I Reference Section

%f
Syntax
Function
_____"%f" is one form specification, which specifies outputting a numerical value in floating point format (123.4567). It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where the "number of places below the decimal point" has not been specified, six places below the decimal point will be output. In a case where the number of places below the decimal point has been specified, the numerical value will be output with that number of places.
_____In a case where we have specified the "number of characters," we use at least a width to the extent of the number of characters. If we do not attach "0," the remaining places become spaces, and when we attach "0," the remaining places become "0." If we do not specify "-," the numerical value is output with right justification, and when we specify "-," the numerical value is output with left justification.
_____In cases where the number of characters have not been specified or the actual number of places is greater than the number of characters, the whole is output as is.
____For example, the result of
TEXT Segment, "[%f] [%10f][%-10f][%10.2f][%-10.2f]",1.234,1.234,1.234,1.234,1.234
becomes as follows:
[1.234000][  1.234000][1.234000  ][      1.23][1.23      ]
_____Furthermore, we can handle numerical values, but we cannot output character strings with "%f." Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).

103

_____
%G
Syntax
Function
_____"%G" is one form specification, which specifies outputting a numerical value in floating point format. It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where the absolute value of the numerical expression is less than 0.0001, or in a case where the integer portion of the numerical value is not able to fit into the "number of places below the decimal point" (in a case where it has not been specified, it's 6), it becomes the same as "%E." If that's not the case, it becomes the same as "%f."
____For example, the result of
TEXT Segment, "[%G] [%G][%G][%G][%.2G]",0.1234567,0.0001,0.00009,123,123
becomes as follows:
[0.123457][0.0001][9E-05][123][1.2E+02]
_____Furthermore, we can handle numerical values, but we cannot output character strings with "%G." Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).
104

I Reference Section

%g
Syntax
Function
_____"%g" is one form specification, which specifies outputting a numerical value in floating point format. It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where the absolute value of the numerical expression is less than 0.0001, or in a case where the integer portion of the numerical value is not able to fit into the "number of places below the decimal point" (in a case where it has not been specified, it's 6), it becomes the same as "%e." If that's not the case, it becomes the same as "%f."
____For example, the result of
TEXT Segment, "[%g] [%g][%g][%g][%.2g]",0.1234567,0.0001,0.00009,123,123
becomes as follows:
[0.123457][0.0001][9e-05][123][1.2e+02]
_____Furthermore, we can handle numerical values, but we cannot output character strings with "%g." Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).

105

_____
%s
Syntax
Function
_____"%s" is one form specification, which specifies outputting a character string. It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where a valid number of characters has been specified, only to the extent of the character string length will be output (in a case where the character string is shorter than the valid number of characters, only to the extent of the character string length will be output). In a case where the valid number of characters has not been specified, the whole character string will be output.
_____In a case where one has specified the "number of characters,"we use at the very least a width proportional to the number of characters. If we do not specify "-," the numerical value is output with right justification, and when we specify "-," the numerical value is output with left justification. Spaces will be output in the parts that are open.
_____In cases where the number of characters have not been specified or the actual number of places is greater than the number of characters, the whole is output as is.
____For example, the result of
TEXT Segment, "[%s] [%10s][%-10s][%10.2s][%-10.2s]", "abc", "abc", "abc", "abc", "abc"
becomes as follows:
[abc][       abc][abc       ][        ab][ab        ]
_____Furthermore, with "%s," we can handle character strings and character-type array variables (even array sections are possible), but we cannot output numerical values. Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).
106

I Reference Section

%X
Syntax
Function
_____"%X" is one form specification, which specifies outputting numerical values in hexadecimal (1`9, A`F) format. It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where we have specified the "number of characters," we use at least a width to the extent of the number of characters. If we do not attach "0," the remaining places become spaces, and when we attach "0," the remaining places become "0." If we do not specify "-," the numerical value is output with right justification, and when we specify "-," the numerical value is output with left justification.
_____In cases where the number of characters have not been specified or the actual number of places is greater than the number of characters, the whole is output as is.
For example, the result of
TEXT Segment, "[%X] [%8X][%-8X][%08X]", 31, 31, 31, 31
becomes as follows:
[1F][      1F][1F      ][0000001F]
_____Furthermore, with "%X," we cannot output floating point values or character strings. Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).

107

_____
%x
Syntax
Function
_____"%x" is one form specification, which specifies outputting numerical values in hexadecimal (1`9, a`f) format. It can be described inside "form character strings" used in the TEXT statement, the MESG statement, and the LOG statement.
_____In a case where we have specified the "number of characters," we use at least a width to the extent of the number of characters. If we do not attach "0," the remaining places become spaces, and when we attach "0," the remaining places become "0." If we do not specify "-," the numerical value is output with right justification, and when we specify "-," the numerical value is output with left justification.
_____In cases where the number of characters have not been specified or the actual number of places is greater than the number of characters, the whole is output as is.
For example, the result of
TEXT Segment, "[%x] [%8x][%-8x][%08x]", 31, 31, 31, 31
becomes as follows:
[1f][      1f][1f      ][0000001f]
_____Furthermore, with "%x," we cannot output floating point values or character strings. Concerning other form expressions, please refer to FORM CHARACTER STRINGS (p. 96).
108

I Reference Section

UPDATE
Syntax
Function
_____When the value of an expression is 0, this suspends the updating of the display inside the window. When the value of an expression is not 0, this resumes the updating of the display.
_____In UPDATE 0 state, just the updating of the display is not carried out; script execution itself is not suspended.
Errors that Occur at Startup Time
Please specify the integer item
Please specify the integer item in the expression.
Errors that Are Stored in $ERR (in regard to $ERR, refer to p. 170)
0_____ When we execute this statement, 0 gets loaded.

109


The above contents of BTRON MicroScript Reference Manual were translated and loaded onto this Web page with the permission of Personal Media Corporation.

Copyright (c) 1997 Personal Media Corporation

Copyright (c) 2009 Sakamura Laboratory, University Museum, University of Tokyo