AIPS NRAO 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


AIPS