83Plus:BCALLs:42F1

From WikiTI
Revision as of 18:49, 4 January 2012 by Zeda (Talk | contribs)

Jump to: navigation, search

Synopsis

Official Name: ChkFindSym

BCALL Address: 42F1

Recalls various pointers and information for a symbol in the VAT.

Inputs

  • OP1 = Name of variable (with proper initial defining byte, see example)

Outputs

  • HL = VAT pointer
  • DE = Data location (if in archive, will be address when page is put into bank A)
  • B = Flash Page, or 0 if in RAM
  • C = Length of Variable Name
  • A = the lower 5 bits is the type. Use the mask 1Fh.
  • carry flag is set if the variable is not found in the VAT

Registers Destroyed

'All'


Example

ld hl,varname
B_CALL Mov9toOp1
B_CALL ChkFindSym
jr c,notfound      ;carry flag is set if the VAT entry is not found
ex de,hl           ;put data pointer into hl 
xor a 
cp  b              ;see if b is 0, and the program is in the ram
jr z,unarchived      ;if so, jump to unarchived 

;do something to get it into RAM

unarchived:

;do something once it is in RAM

varName:
.db AppVarObj, "APPVAR",0