Back to libut API Reference


SYNOPSIS

    #include "libut/ut.h"
    int UT_stridx(char *string, char *strary[]);


DESCRIPTION

This function looks to see if the given string appears in the strary array of strings. If it does, the index in strary is returned. Otherwise, -1 is returned.

The comparison is by string equality, not by pointer equality.

This is useful for testing a string against a list of allowed values, particularly when the index into the allowed values is a state variable.


EXAMPLE

    char *in, *modes[] = { "wait", "run", "stop" };
    int i;
    
    in = "stop";  /* imagine this is user input */
    
    i = UT_stridx( in, modes);
    if (i != -1) UT_LOG(Info, "Mode set to %d (%s)", i, modes[i]);
    
    /* logs "Mode set to 2 (stop)" */


SEE ALSO

UT_strncpy(3)


AUTHOR

Troy D. Hanson <thanson@users.sourceforge.net>