fsel_exinput() displays the system file selector and offers the user an opportunity to choose a complete GEMDOS path specification.

91 (0x5B)

Available from AES version 1.40.

path should be a pointer to a character buffer at least 128 bytes long (applications wishing to access CD-ROM's should allocate at least 200 bytes). On input the buffer should contain a complete GEMDOS path specification including a drive specifier, path string, and wildcard mask as follows: 'drive:\path\mask'. The mask can be any valid GEMDOS wildcard (usually *.*).

On function exit, path contains final path of the selected file (you will have to strip the mask).

file should point to a character buffer 13 bytes long (12 character filename plus NULL). On input its contents will be placed on the filename line of the selector (usually this value can simply be a empty string). On function exit, file contains the filename which the user selected.

button is a short pointer which upon function exit will contain FSEL_CANCEL (0) if the user selected CANCEL or FSEL_OK (1) if OK.

title should be a pointer to a character string up to 30 characters long which contains the title to appear in the file selector (usually indicates which action the user is about to take).

addrin[0] = path;
addrin[1] = file;
addrin[2] = label;

crys_if(0x5B);

*button = intout[1];

return intout[0];

fsel_exinput() returns 0 if an error occured and 1 otherwise.

Some 'C' compilers (Lattice for example) provide a special function which allows fsel_exinput() to be used even on earlier AES versions.

The path parameter to this function should be validated to ensure that the path actually exists prior to calling this function to prevent confusing the user.
This call should always be used as opposed to fsel_input()? when it is available. Otherwise, the user has no reminder as to what function s/he is actually undertaking.