Radio Shack TRS-80 Model II Reference Manual page 224

Modell! TRSDOS
When
B
= I, the other register contents are:
(HL)
=
File specification to be checked against the mask; file specification
must be terminated with a carriage return.
When
B
=
2, the other register contents are:
(HL)
=
An II-byte buffer defined as follows: First comes an eight-byte name
field. Then comes a three-byte extension field. Both must be left
justified with trailing spaces as required to fill the field. For example:
NAME
1lJ1tJ1tJ1tJ
EXT
The symbol' '1tJ" represents a blank space and is used only where
needed for emphasis or illustration.
(DE)
=
A 13-byte destination buffer to hold the compressed file specification
contained in (HL).
Exit Conditions
After entry with B
=
0,
the exit conditions are:
NZ = Invalid mask specification
After entry with B
=
I, the exit conditions are:
NZ
=
File does not match mask or no mask has been set
After entry with B
=
2, the exit conditions are:
(DE)
=
13-byte buffer containing a filename/extension followed by a carriage
return. The filename/extension is created from the
I I
-byte source text (HL) on entry
withB
=
2.
Following the example given above, (DE) would contain: NAME/EXT followed by a
carriage return
User Notes
Calling any other TRSDOS SYC may clear the mask. Therefore you should use this
procedure:
I. Get the file specification(s) to be checked.
2. Set mask by calling WILD with B
=
°
3. Compare the file specification with the mask by calling WILD with B
=
I
4. Repeat Step 3 until all file specifications have been checked.
5. Each time you call anotherTRSDOS SYC, you may have to reset the mask.
260