/*
    ####             #    #     # #
    #   #            #    #       #          The FreeWare C library for 
    #   #  ##   ###  #  # #     # ###             RISC OS machines
    #   # #  # #     # #  #     # #  #   ___________________________________
    #   # ####  ###  ##   #     # #  #                                      
    #   # #        # # #  #     # #  #    Please refer to the accompanying
    ####   ### ####  #  # ##### # ###    documentation for conditions of use
    ________________________________________________________________________

    File:    Validation.h
    Author:  Copyright  1992 Jason Williams
    Version: 1.00 (22 Mar 1992)
    Purpose: Scanning of validation strings for various fields
*/


#ifndef __dl_validation_h
#define __dl_validation_h

#ifdef __cplusplus
extern "C" {
#endif



extern int Validation_ScanString(char *string, char tag);
/*
 * Scan the passed-in string for the special tag character, and return the
 * index of the next char. e.g. scanning "a0-9;b3" for the bordertype can be
 * done as follows:
 *
 * if (border = Icon_ScanValidString(icon.data.indirecttext.validstring, 'B'))
 * {
 *   border = icon.data.indirecttext.validstring[border] - '0';
 *   switch (border)
 *   ...
 *
 * If the tag is not found, a value of 0 will be returned, else the value
 * is the index of the character FOLLOWING the tag in the string.
 * (NOTE that the tag must be either the first character, or must directly
 *  follow a semicolon)
 *
 */

#ifdef __cplusplus
}
#endif


#endif
