Function:     GgiKeyIdent

Purpose:      Obtain identification number for a keyword.

Category:     USER-INTERFACE, SYSTEM

File:         ggi.src

Author:       J.P. Terlouw

Use:          
              #include "ggi.h"

              int  result;
              char *keyword; 

              result = GgiKeyIdent(keyword);

                 result  -  identification number

Description:  GgiKeyIdent() returns an identification number given a
              text string. It is used for generating unique keywords
              on the basis of other keywords when combining the keywords
              themselves would result in too long a keyword.

              The function makes use of a moderately large hash table,
              which makes it likeley, but not certain, that in different
              runs the same identification number will be generated.
              If it is necessary that identification numbers for certain
              keywords will be the same, the application should present
              these keywords to GgiKeyIdent() before any other calls.

Updates:      Jul 11, 2000: JPT, Document created.