[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


NAME
    FindToolType - find the value of a ToolType variable.

SYNOPSIS
    value = FindToolType(toolTypeArray, typeName)
      D0                      A0           A1

    char *FindToolType(char **, char *);

FUNCTION
    This function searches a tool type array for a given entry,
    and returns a pointer to that entry.  This is useful for
    finding standard tool type variables.  The returned
    value is not a new copy of the string but is only
    a pointer to the part of the string after typeName.

INPUTS
    toolTypeArray - an array of strings (char **).
    typeName - the name of the tooltype entry (char *).

RESULTS
    value - a pointer to a string that is the value bound to typeName,
            or NULL if typeName is not in the toolTypeArray.

EXAMPLE
    Assume the tool type array has two strings in it:
        "FILETYPE=text"
        "TEMPDIR=:t"

    FindToolType( toolTypeArray, "FILETYPE" ) returns "text"
    FindToolType( toolTypeArray, "filetype" ) returns "text"
    FindToolType( toolTypeArray, "TEMPDIR" )  returns ":t"
    FindToolType( toolTypeArray, "MAXSIZE" )  returns NULL

SEE ALSO
    MatchToolValue()

BUGS
    None