ViGYAN's DESL

( BU) Details concerning the DESL register command.

(See example(s) of the use of the register command.)

[Jump to the list of available options.]

General description of the register command :

The purpose of this command is to give the user the means to set, show, clear DESL user/system name/value registers. These register settings can be referenced by the "if", "else", and "while" commands, in any command argument list, and via the "reg" function in an "eqn" equation file.
.
(Begin modifications on 111302)
There are 99 "name" (*N) and 99 "value" (*V) registers addressable on DESL command lines and in DESL function argument lists.
See an additional discussion of DESL registers.

Registers 1 through 10, referenceable by the names *N1, *N2, ... , *N10 and *V1, *V2, ... , *V10, are "system" registers. They are user readable but not user writable. (See copy command's system option.)
Registers 11 through 99, referenceable by the names *N11, *N12, ... , and *N99 and *V11, *V12, ... , and *V99, are "user" registers and can be set to whatever is desired, adhering to the limits on string lengths of 16 for the name-type (*N) registers.
(End modifications on 111302)

.
(Begin modifications on 062805)
Register names can also be specified using the alternate pound sign (#) first character. This alternate form of register names can avoid conflicts where asterisks are used for other purposes.
(End modifications on 062805)

There are several structures which can follow the register function's command name or abbreviation on the command line. ONE of the structures is REQUIRED. (See examples.)

The three basic capabilities of the "register" command are to set, show, and clear registers. The set and clear subfunctions cannot be used on registers 1 through 10 since they are SYSTEM registers and are therefore NOT writable. Other than these restrictions, there are no other cases of unreferenceable registers.

reg(ister) clear

The clear register subfunction allows the user to reset one or more User registers to their default states :

for "name" registers (*N11 --> *N99) the default setting is blank

for the "value" registers (*V11 --> *V99) the default is 0

The structure of the "reg(ister) clear" command is :

reg(ister) clear ( *N# *N# *V# ... )

where,

# represents a register number 11-->99

*N or *V followed by a register number implies a "name" or "value" register, respectively, and parentheses enclose enclose optional items.

Name and value register names can be mixed on the command line. Specifying no register names after clear implies a clear of all User registers; i.e., a resetting to their default settings.

reg(ister) show

The show register subfunction allows the user to display one or more User or System registers. The structure of the reg(ister) show command is :



reg(ister) show ( *N# *N# *V# ... )

where,

# represents a register number 11-->99
*N or *V followed by a register number implies a name or value register, respectively, and parentheses enclose enclose optional items.

Name and value register names can be mixed on the command line. Specifying no register names after show implies a show of all registers.

reg(ister) set

The set register subfunction allows the user to change the value of one or more User registers.

The type register on the left of the equal sign (=) determines what type operation will be attempted (string or value).

For setting name or value type registers, the structure of the reg(ister) set command is :



reg(ister) set *N# = *N# ( op *N# )
reg(ister) set *V# = *V# ( op *V# )
reg(ister) set str1 ( op str2 )
reg(ister) set ###1 ( op ###2 )
reg(ister) set ^ENV ( op ^ENV )

where,

*N# and *V# represent name and value registers, respectively
# is a user register number 11 --> 99,
str and ### represent an arbitrary string and value, respectively
op is one of the string/value operators below

.
(Begin modifications on 090904)
A User Value register CANNOT be set to a Name register.
A User Name register CAN be set to a Value register but certain rules will apply. It is recommended that any value that is going to be set to a Name register be a positive or negative integral value. If the value is non-integral it is encoded into the Name register string with the G14.7 Fortran-type format.
(End modifications on 090904)

String ops :

pfx ...... prefix str2 to str1

sfx ...... concatenate str2 to str1

shiftl ... shift str1 left ###2 characters

shiftr ... shift str1 right ###2 characters

rotl ..... rotate str1 left ###2 characters

rotr ..... rotate str1 right ###2 characters

maskl .... mask str2 into str1 on left end

maskr .... mask str2 into str1 on right end

justl .... left justify str1

justr .... right justify str1

Value ops :

+ ....... add ###2 to ###1

- ....... subtract ###2 from ###1

* ....... multiply ###1 and ###2

/ ....... divide ###1 by ###2

^ ....... raise ###1 to ###2 power

aint .... truncate ###2 to integer

anint ... round ###2

log ..... log to base 10 of ###2

sin ..... sine of ###2; ###2 in radians

cos ..... cosine of ###2; ###2 in radians

tan ..... tangent of ###2; ###2 in radians

sind .... sine of ###2; ###2 in degrees

cosd .... cosine of ###2; ###2 in degrees

tand .... tangent of ###2; ###2 in degrees

asin .... arcsine of ###2; result in radians

acos .... arccosine of ###2; result in radians

atan .... arctangent of ###2; result in radians

asind ... arcsine of ###2; result in degrees

acosd ... arccosine of ###2; result in degrees

atand ... arctangent of ###2; result in degrees

All value op codes except first 5, above, require only one following argument.

[Top][Bottom][Option list]

ViGYAN, Inc.

DESL Manager at ViGYAN, Inc.

30 Research Drive
Hampton, VA 23666
Voice: (757) 865-1400
Toll Free: (800) 288-3998
FAX: (757) 865-8177

( BU) Details concerning the DESL register command.

© 1998 ViGYAN, Inc.