HC_Begin_Glyph_Search
-
void
HC_Begin_Glyph_Search(void) - void HC_Begin_Glyph_Search(void)
These routines recall all the defined glyph names.
These routines are used to find all of the glyph definitions that exist in the database. For example,
Begin_Glyph_Search () while (Find_Glyph (the_name)) Show_Glyph(the_name, definition) End_Glyph_Search ()
retrieves all the known names, in the style in which they were originally defined. If you need to know how many glyph definitions will be returned (possibly for allocating a data structure to hold them) call Show_Glyph_Count() after initiating the search.
Find_Glyph() returns the names (one at a time). The function returns false when all glyph names have been returned.
End_Glyph_Search() terminates the process and frees any involved memory. This last step can be done any time after the initial call to Begin_Glyph_Search().
After calling Begin_Glyph_Search(), if a glyph becomes undefined (via UnDefine_Glyph()), subsequent calls to Find_Glyph() will not return it. If a glyph is redefined, the new definition will be returned. If a new glyph is defined, it will not be returned in this search sequence.
Show_Glyph_Count() is only valid between Begin_Glyph_Search() and End_Glyph_Search(). It will always return the total number of glyphs defined as opposed to the remaining number of glyph definitions.
Glyph name searches can be nested. A user program can call Begin_Glyph_Search() and look at the defined glyph names without interfering with a glyph name search that might already have been activated by another portion of the program. When End_Glyph_Search() is called, the previously active glyph name search (if any) becomes current.
HC_Define_Glyph, HC_Show_Glyph, HC_Parse_String