Utility: Put-Bytes; Utility: Put_Bytes - HP 9835A Programming Manual

124 Communication Between BASIC and Assembly Language
Exit Conditions: There are no error exits from the utility. It always returns to the instruction
following the call.
Here is an example call, storing information from Value into element 0 of an integer array -
ISOURCE Array info:BSS 30
EQU Array info+16
ISOURCE Parameter: INT
C*)
I ::;
(1
tJ t::~ C: E
I::; Ci jJ
F.~
C: E
I :=;Cilj
F.:C:E
I ~=;
(1
fJ ~~ C: E
I ~=; Ci tJF.~ C: E
I::;;
i]
iJ
F:~ C: E
I :::ClljF:C:E
I :::; Ci
iJ
F.~ C: E
UTILITY : Put_bytes
L Ii :B ::: Fi
t-· i'-'
·::i ::) i
t-l
f" c=
.J :::; t:1 F:
i.A
t ~:' 1 ~::' Hi ~:'
!o·Oj
t
General Procedure: This is similar to the "Put_value" utility. This utility changes the value
of a substring which is part of a string variable or an individual element of a string array, having
been given the starting byte and the number of bytes to be changed as well as the new
characters.
Special Requirements:
• The bytes to be transferred are preceded by two words in the storage area. The two words
contain the starting byte for the substring and the number of bytes to be transferred .
• A string variable or an element of a string array must have been passed as an argument for
the utility to work properly.
Calling Procedure:
1. Store the number of the starting byte of the substring to be changed into the first word of
the storage area. (Note that bytes 0 and 1 are the length word of the string)
2. Store the number of bytes in the substring into the second word of the storage area.
3. Load register A with the address of the storage area.