Difference between revisions of "83Plus:BCALLs:8075"

From WikiTI
Jump to: navigation, search
(but this one does!)
 
(Changed name)
 
Line 1: Line 1:
[[Category:83Plus:BCALLs:By_Name:Other|FindSubFieldApp]] [[Category:83Plus:BCALLs:By_Name|FindSubFieldApp]] [[Category:83Plus:BCALLs:By_Address|8075 - FindSubFieldApp]]
+
[[Category:83Plus:BCALLs:By_Name:Other|FindOSHeaderSubField]] [[Category:83Plus:BCALLs:By_Name|FindOSHeaderSubField]] [[Category:83Plus:BCALLs:By_Address|8075 - FindOSHeaderSubField]]
 
== Synopsis ==
 
== Synopsis ==
'''Unofficial Name:''' FindSubFieldApp
+
'''Unofficial Name:''' FindOSHeaderSubField
  
 
'''BCALL Address:''' 8075
 
'''BCALL Address:''' 8075
  
Search for a subfield of the given app header.
+
Search for a subfield of the given app or OS header.
  
 
=== Inputs ===
 
=== Inputs ===
* AHL = address of the first type byte of the field whose contents you want to search (8000h if you want to search an installed app header)
+
* AHL = address of the first type byte of the field whose contents you want to search (8000h if you want to search an installed app/OS header)
 
* DE = field to search for (e.g. 8010 to search for the key ID)
 
* DE = field to search for (e.g. 8010 to search for the key ID)
  
Line 20: Line 20:
  
 
== Comments ==
 
== Comments ==
This routine is approximately the same as [[83Plus:BCALLs:805D|FindSubField]], but handles an initial long-size field correctly, doesn't handle an initial nibble-size field correctly, and stops at any major type other than those allowed for apps (80h, 2, and 3.)
+
This routine requires that the byte it start at not be set to FF (i.e., empty space) or 00 (i.e., a deleted application.)  The OS uses this routine to search for data in its own header.
 +
 
 +
It is approximately the same as [[83Plus:BCALLs:805D|FindSubField]], but handles an initial long-size field correctly, doesn't handle an initial nibble-size field correctly, and stops at any major type other than those allowed for apps (80h, 2, and 3.)
  
 
It is much like the other field search routines, but starts by skipping to the data section of the given field, and continues from there.
 
It is much like the other field search routines, but starts by skipping to the data section of the given field, and continues from there.
  
 
It does not keep track of whether the "subfield" is actually within the parent field; it simply stops when it reaches a non-app field.
 
It does not keep track of whether the "subfield" is actually within the parent field; it simply stops when it reaches a non-app field.
 +
 +
See also [[83Plus:BCALLs:80AB|FindAppHeaderSubField]].

Latest revision as of 20:39, 29 January 2007

Synopsis

Unofficial Name: FindOSHeaderSubField

BCALL Address: 8075

Search for a subfield of the given app or OS header.

Inputs

  • AHL = address of the first type byte of the field whose contents you want to search (8000h if you want to search an installed app/OS header)
  • DE = field to search for (e.g. 8010 to search for the key ID)

Outputs

  • HL = address of the first type byte of the first matching field
  • NZ set if not found.

Destroys

Comments

This routine requires that the byte it start at not be set to FF (i.e., empty space) or 00 (i.e., a deleted application.) The OS uses this routine to search for data in its own header.

It is approximately the same as FindSubField, but handles an initial long-size field correctly, doesn't handle an initial nibble-size field correctly, and stops at any major type other than those allowed for apps (80h, 2, and 3.)

It is much like the other field search routines, but starts by skipping to the data section of the given field, and continues from there.

It does not keep track of whether the "subfield" is actually within the parent field; it simply stops when it reaches a non-app field.

See also FindAppHeaderSubField.