1 06/25/81  add_bit_offset_
 2 
 3 
 4 Entry points in add_bit_offset_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: add_bit_offset_: 06/15/81  add_bit_offset_
 9 
10 Function: returns a pointer to a bit relative to the bit referenced by
11 the input pointer.  The displacement to the desired bit may be
12 positive, negative, or zero.
13 
14 
15 Syntax:
16 dcl add_bit_offset_ entry (ptr, fixed bin (24)) returns (ptr)
17      reducible;
18 new_pointer_value = add_bit_offset_ (pointer_value, bit_displacement);
19 
20 
21 Arguments:
22 pointer_value
23    is the original pointer to which the bit displacement is applied.
24    (Input)
25 bit_displacement
26    is the displacement in bits to be applied to the above pointer.
27    (Input)
28 new_pointer_value
29    is the result of this operation.  (Output)
30 
31 
32 Notes: If the result of applying the displacement would cause the
33 pointer to reference outside the legal boundaries of a segment (either
34 a negative offset or an offset beyond 256K words), the result of the
35 call is not defined.