1 06/26/86  translate_bytes_to_hex9_
 2 
 3 
 4 Entry points in translate_bytes_to_hex9_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: translate_bytes_to_hex9_: 06/26/86  translate_bytes_to_hex9_
 9 
10 Function: translates a bit string to a character string
11 containing the hexadecimal representation of the bits.
12 Each 9-bit byte of the input is translated into two hex
13 digits by using the low-order 8 bits in each byte.
14 
15 
16 Syntax:
17 declare translate_bytes_to_hex9_ entry (bit (*), char (*));
18 call translate_bytes_to_hex9_ (bit_string, hex_string);
19 
20 
21 Arguments:
22 bit_string
23    is the bit string to be translated.  This argument must start on a
24    byte boundary and should be a multiple of 9 bit long.  Any extra
25    bits, not part of a complete byte, are ignored.  (Input)
26 hex_string
27 
28    is the output character string containing hexadecimal digits
29    obtained by translating the low order 8 bits of each 9-bit byte of
30    the input string into 2 hex digits.  If the output string argument
31    is longer than necessary, then it is filled with ASCII "0"
32    characters.  (Output)
33 
34 
35 Notes:  This subroutine uses the hardware mvt instruction with a desc4a
36 descriptor for the input string and a desc9a descriptor for the output
37 string to do the translation.