8.4 File-selector library

int16_t fsel_boxinput ( int16_t *global, int8_t *fs_einpath,
                        int8_t *fs_einsel,
                        int16_t *fs_eexbutton,
                        int8_t *elabel,
                        FSEL_CALLBACK callback )
{
  void *aespb[6], *addrin[6], *addrout[6];
  int contrl[5], intin[16], intout[7];

  aespb[0] = contrl;
  aespb[1] = global;
  aespb[2] = intin;
  aespb[3] = intout;
  aespb[4] = addrin;
  aespb[5] = addrout;

  contrl[0] = 91;
  contrl[1] = 0;
  contrl[2] = 2;
  contrl[3] = 4;
  contrl[4] = 0;

   addr_in[0] = fs_einpath;
   addr_in[1] = fs_einsel;
   addr_in[2] = elabel;
   addr_in[3] = callback;

  _crystal((AESPB *)aespb);

   *fs_eexbutton = int_out[1];
   return ( int_out[0] );
}

int16_t fsel_exinput (int8_t *fs_einpath, int8_t *fs_einsel,
                      int16_t *fs_eexbutton, int8_t *elabel)
{
   addr_in[0] = fs_einpath;
   addr_in[1] = fs_einsel;
   addr_in[2] = elabel;

   crys_if (91);

   *fs_eexbutton = int_out[1];
   return ( int_out[0] );
}

int16_t fsel_input (int8_t *fs_iinpath, int8_t *fs_iinsel,
                    int16_t *fs_iexbutton)
{
   addr_in[0] = fs_iinpath;
   addr_in[1] = fs_iinsel;

   crys_if (90);

   *fs_iexbutton = int_out[1];
   return ( int_out[0] );
}

• The inpath parameter can contain not only the traditional * and ? wildcards, but can also contain regular expressions using [] and {}:
  • Any characters contained between square brackets ("[]") define a list of acceptable characters to substitute into that one position. This can either be individual characters, like "[ABCD]", a range separated by a hyphen like "[A-D]", or a mix of the two, like "[A-DXYZ]".
  • A list of words contained within curly brackets ("{}") defines one or more acceptable values. The values must be separated by commas.
• The pathlen parameter defines the maximum length of inpath. If the user adds too many extensions or the path otherwise grows too long, an error alert will appear.
• Upon successful return, files can contain up to sels filenames. Each name in the list is followed by a NULL character (ASCII 0) and the last filename is followed by a final NULL. The exception to this rule is when sels is one, in which case the final NULL is not used; For all other cases, the area pointed to by files must be at least (13 * sels)+1 bytes long.

int16_t x_fsel_input( int8_t *inpath, int16_t pathlen, int8_t
*files, int16_t sels, int16_t *exbutton, int8_t *label )
{
   int_in[0] = pathlen;
   int_in[1] = sels;

   addr_in[0] = inpath;
   addr_in[1] = files;
   addr_in[2] = label;

   crys_if(28960);

   *exbutton = int_out[1];

   return ( int_out[0] );
}