1.2.3.1 The TABLE statement

The driver language lets you define translation tables which do such conversions while the driver performs a PRINT, INPUT, READ or WRITE statement. Tables are defined with the TABLE statement:

The TABLE keyword is followed by a name for this table and the table definition in double quotes. The table definition contains assignments A=B, separated by commas. Strings containing commas or equal characters cannot be translated through a table.

    TABLE tModulation   "BPSK=BPS,QPSK=QPS,8PSK=8PS"

In the table definition, the A value is the string visible at the user interface of the software, the B value is used when communication with the device. The driver translates in a PRINT or WRITE statement BPSK -> BPS, QPSK -> QPS or 8PSK -> 8PS if the table tModulation shown in the example above is referenced. With an INPUT or READ statement, the table automatically translates the values the other way round.

For some applications a table definition may become quite large. The driver syntax permits to split up the table definition in multiple string/lines. Each string/line must be enclosed in double quotes and must contain at least one translation pair. Commas at the end of a line are omitted. Below an example for such a multi line table definition is shown.

    TABLE tVideoTest    "NRM=00,625.1=01,625.2=02,625.3=03,625.4=04,625.5=05"
                        "625.6=06,625.7=07,625.8=08,625.9=09,625.10=10,625.11=11"
                        "625.12=12,625.13=13,625.14=14,625.15=15,625.16=16"
                        "525.1=17,525.2=18,525.3=19,525.4=20,525.5=21,525.6=22"
                        "525.7=23,525.8=24,525.9=25,525.10=26,525.11=27,525.12=28"
                        "525.13=29,525.14=30,525.15=31,525.16=32"

Remarks

• If a table translation is invoked with a value which is not contained in the table, the translation returns the first value in the table.
• To define a table it may be useful to copy the definition of the CHOICE variable which shall be translated at the place of the table statement. this copy then can be extended to the table definition.
• Don't add whitespace characters in the table definition to make this better readable. The driver would treat these characters as part of the strings to translate!