Click above to get retro games delivered to your door ever month!

FILE LOOKUP (L)

Purpose: Find record location of a given string within a specific file; put
         that record location in a numeric register.

Format:  Ln1 {1} {2} {3} {4}

Remarks: L         File lookup command.

         n1        File name (A-Z).

         {1}       optional starting record location, which can be one of
                   the following:

                   #d        Numeric register.

                   n         Literal number.

                   If not specified, the default starts at record 0.

         {2}       Optional given string, which can be:

                   "data"    Literal data.  Quotation marks are manditory.

                   X(n)      Record n in file X.

                   $i        String register $i (0-3).

                   If not specified, the default is the contents of string
                   register $0.

         {3}       Optional result register, can be any numeric register.
                   If not specified, the default is numeric register #0.
                   If the search string is found, the record location will
                   be stored in the result register.  If the string is not
                   found, the result register will be set to the number of
                   records in the file.

         {4}       Optional wild card indicator:

                   *         The asterisk indicates that the string contains
                             wild card characters.

                   If not specified, default is to perform search without
                   wild cards.

         Wild Card
         Character:          Good for:

         ?                   Any alphanumeric character (includes symbols)

         #                   Any number

         @                   Any letter

         The File Lookup command ceases execution after finding the first
         occurrence of the given string.  To continue searching a specific
         file for a given string, set the optional starting record location
         to one greater than the record location stored in the result
         register, then execute the File Lookup command again.

Examples:

         LA  searches file A starting at record location 0.  The object of
         the search is the string contained in string register $0.  The
         result of the search is placed in numeric register #0.

         LA"####"#1*  searches file A starting at record location 0.
         The object of the search is a string containing any four digits.
         The result of the search is placed in numeric register #1.

         LZ(#1)B(#3)#9  searches file Z, starting at the record location
         contained in numeric register #1.  The object of the search is
         the string contained in file B starting at the record location
         stored in numeric register #3.  THe result of the search is placed
         in numeric register #9.