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

Syntax

MASK_FOR( cCue, xcKey, cPic [, cHeader ;
          [, xcValid [, lExact_on [, nColour ]]]])

Purpose

Split a concatenated index key into individual gets, READ them and return
the concatenated result. Search targets for complex index expressions are
often handled with pictures such as "@R XXX / XXX", which users (in our
experience) find unacceptable.

Arguments

     cCue -- prompt string

     xcKey -- index key(s) string

     cPic -- picture string(s)

     cHeader -- message to display atop the search box

     xcValid -- validation string(s) to restrict entries

     lExact_on -- if passed, do not trim the manufactured key

     nColour -- if passed, colour to use, else 8

Setup

cCue and xcKey have identical numbers of parts.

Example

     target = MASK_FOR( "Customer No./Invoice No.", ;
                        "CUST_CODE+INVOICE_NO", ;
                        "@R !!!-99/@9", .F., ;
                        { || EXIST( target ) } )

Returns

The items entered by the user, concatenated and ready for use (as a search
target, typically).

Side Effects

Crash on bad data.

Artful Calls

ASK_FOR, ABREAK, LONGEST, MAKE_STR, ATRANSFORM, ATOS, PUSH/POP_SCR,
SHADOWBOX, BLANK, CENTRE

Source File

AA_MASKF.PRG