Monarch 9460 WHILE

5-86 Command Reference

WHILE

Purpose Repeats a sequence of commands as long as a condition is true.

Syntax WHILE

buffer-field1 comparison buffer-field2

.

.

.

ENDWHILE

Process The WHILE command repeats a sequence of commands as long as a condition is

true.

If the condition is true, the script executes the commands listed between WHILE

and ENDWHILE. When script reaches ENDWHILE, it checks the condition again. If

the condition still exists, it executes the commands again. If the condition is false,

the script branches to the line after ENDWHILE.

Buffer-field1

and

buffer-field2

are the compared items in the condition. They can

be one of the following:

Buffer-field

Description

INPUT Input Buffer

Logical Field Name

(TEMP1)

Temporary Buffer

Field

Logical Field Name (LU1) Lookup Buffer Field

Logical Field Name (PR1) Printer Buffer Field

Number

String

Number prefixed by a

number sign (#)

ASCII string delimited

by double quotes.

Must be one

character long

Comparison is the operator used to compare

buffer-field1

and

buffer-field2

. It can

be one of the following:

Comparison

Description

= Equals

== Equals

<> Not equal

!= Not equal

> Greater than

>= Greater than or equal

< Less than

<= Less than or equal

NOTE: Use the BREAK command to break out of a WHILE loop prematurely. For example,

you could use it when an error occurs. Also, Do Not use WHILE inside a macro.

Contents

Main Page TABLE OF CONTENTS Page Page Page OVERVIEW How to Use this Manual A Review of Terms Page USING THE SOFTWARE System Requirements Quick Reference Operators Handbook Installing the Software Getting Started Page Saving a File About Projects 1. 2. 3. Building Projects Changing the Download Settings If you select COM1 - COM4: 4. If you select LPT1 LPT2: 5. Downloading a Project Editing Existing Projects Page PRINTER PROCEDURES Displaying the Ready Prompt No Application Loaded Application 1. Loading Applications Restarting Existing Applications Loading New Applications PROGRAM STRUCTURE Functions Starting a Script Files and Buffers Lookup Table Definition Temporary Storage Definition Printer Definition Scope of Field Names Script Flow Control Comments in a Script Data Storage Data Coding COMMAND REFERENCE Programming Conventions Field Names Keywords Page Special Characters Script Flow When a label is NOT defined... When a label is defined... Functional Relationships Math Commands Script Control Commands Compiler Directives Data Manipulation Commands File Management Commands Input/Output Commands ADD APPVERSION ARGREAD ASC AUTOSTART AVAILABLEDATA BITCLEAR BITMASK BITSET BITSHIFT BITTEST BSEARCH CALL param1, param2, ,paramX Example 1 Param param Page CHARTYPE CHECK Page CHR CLEAR item Example 2 Example 1 Item CLOSECOMM COMPARE CONCAT CSTRIP DATATYPE DEC DEFINE Field-type data-typ field-type Data-type Page DELAY DISABLE DIVIDE ENABLE EXIT FETCH FIELDLEN FIXDATA Buffer-field1 Example Buffer Field1 GENERATE GET HOTKEY IF buffer-field2 Buffer-fields buffer-fields Page INC INCLUDE INSERT JUMP label Example LABELCOUNT LEFT LINKFILE file-name Example 1 format-name\file-name LOCATE LOWER LSTRIP MACRO Page MID MOVE Page MULTIPLY OPENCOMM PAD PARSE , valid label Example valid labels Invalid PRINT QUERY Page READ RESTORESCREEN RETURN RIGHT RSTRIP SAVESCREEN SEEK SUB SWITCH Page SYSSET parameter2 function, parameter1, and parameter2 parameter2 parameter1 Function/Description Parameter1 Parameter2 Example TOKEN TSTRIP UPPER VALIDATE , valid label Example valid labels Invalid WHILE buffer-field1 comparison buffer-field2 Comparison Buffer-field Page Page SAMPLE SCRIPT A Page Page Page INDEX A B C D F G H I J Q R S T