AIPS HELP file for REHEX in 31DEC25
As of Wed Dec 11 4:37:30 2024
REHEX: Verb to convert extended hex strings to decimal numbers
INPUTS
$ Input/output adverbs
EHNUMB $ Extended hexadecimal version
DENUMB $ 0.0 1679616. Decimal number:
$ 0 -> login user number
The extended hex string may also given as an immediate
argument. Example: REHEX '10'
HELP SECTION
REHEX
Type: Verb
Use: REHEX will convert a string adverb or an immediate argument from
an "extended-hexidecimal" (base 36) string to a decimal integer.
Examples:
>REHEX '1aj'
AIPS 2: Decimal number 1675 is '1AJ' in extended hex
>REHEX '0GH'
AIPS 2: Decimal number 593 is '0GH' in extended hex
>REHEX 'gh'
AIPS 2: Decimal number 593 is 'GH' in extended hex
>task = 'imagr'
>REHEX TASK
AIPS 2: Decimal number 31273083 is 'IMAGR' in extended hex
>DENUMB = 0
>REHEX
AIPS 2: Decimal number 36 is '0010' in extended hex
>REHEX SOURCES
AIPS 2: Decimal number 36 is '0010' in extended hex
AIPS 2: INTERP: STACKS NOT EMPTY WHEN LINE DONE
Note that the login user number is converted if no argument is
given AND there is no other string on the stack. The input string
must be <= 4 characters (each of SOURCES is 16 characters).
Note that, if REHEX is used in a FOR or WHILE loop or in an
IF-THEN-ELSE construct, then the immediate argument is required.
Otherwise, some item necessary to the loop/construct will be
taken as the immediate argument.
Input/output adverbs:
EHNUMB......Hexadecimal number in 4 or fewer characters, left
justified to be converted if there is no immediate
string argument. If there is an immediate argument
EHNUMB is set to it on output.
DENUMB......Decimal number equivalent to the extended hexadecimal
string. If the input string is blank, DENUMB's value is
used as the immediate argument with the login user
number as the default.
EXPLAIN SECTION