Find a string -- reverse

From CometWiki

Revision as of 11:48, 13 June 2009

DOS pseudo functions: Find a string -- reverse

Syntax:

 DOSMS(AX-value, BX-value, CX-value, DX-value) EXCP=statement-label  

Entry:

   AX = "@FFFB@"
                                                                                                                          .
    Upon execution of the DOSMS function, the AX register acts as
    a "countdown" field. If the number of occurrences of the
    search string is found, the value in this register is 0. A
    non-0 value means that a beginning-of-file was encountered
    before the specified number of occurrences were found.
                                                                                                                        .         BX = file handle
   CX = number of occurrences to find (in hex)
   DX = the search string

Discussion:
This pseudo function searches an entire file for a specified string in reverse record order (physical order).
If the string is found anywhere within the file, the file pointer is positioned at the physical record where the string was found.
The search starts at current position in the file.