Tcl_GetIndexFromObj is a C function in the [Tcl C API].

Documentation: http://www.tcl.tk/man/tcl8.5/TclLib/GetIndex.htm
----

This function is useful when you need to tell what subcommand or other predefined argument has been given by the user. Let's assume, you have a typical command procedure in C:

 myCmd(ClientData clientData, Tcl_Interp *interp, int objc, Tcl_Obj *const objv[]) {
   /* some useful code here */
 }

Now, if the Tcl level command, that is processed here, has some keyword-like argument, e.g. [[myTclCmd start]], [[myTclCmd stop]], and [[myTclCmd rewind]], use Tcl_GetIndexFromObj like this:
===
 myCmd(ClientData clientData, Tcl_Interp *interp, int objc, Tcl_Obj *const objv[]) {
    ''/* the following array lists all keywords and is terminated by a NULL element */''
    const char *subCmds[] = {"start", "stop", "rewind", NULL};
    ''/* the following enumeration reflects the array and allows to use the index, which is assigned in Tcl_GetIndexFromObj */''
    enum keywordIdx {startIdx, stopIdx, rewindIdx};
    
    ''/* this will take the first argument given to the Tcl level command''
       ''and compare it with the keywords listed in subCmds.''
       ''If there is no match, and error is raised and an error message ''
       ''is automatically generated with the word ‘action’ -> bad action "...": must be start, stop, or rewind''
       ''If there is a match, the index of the matched item in the arry is assigned to the ‘index’ variable */''
    int index;
    if ('''Tcl_GetIndexFromObj'''(interp, objv[[1]], subCmds, "action", 0, &index) != TCL_OK) {
        return TCL_ERROR;
    }
    
    ''/* now use the enumeration to do your work depending on the keyword */''
    switch (index) {
            case startIdx: {
                 ''/* do the start action */''
            }
            case stopIdx: {
                ''/* do the stop action */''
            }
            case rewindIdx: {
                ''/* do rewind action here */''
            }
    }
 }
===
----
This function is frequently used in conjunction with [Tcl_WrongNumArgs].
----
!!!!!!
%| [Category Tcl Library] | [Category Example] |%
!!!!!!