NAME

       mchartable_map - Call a function for characters in a chartable.

SYNOPSIS

       int mchartable_map (MCharTable * table, void * ignore, void(*)(int, int, void *, void *)
       func, void * func_arg)

DESCRIPTION

       Call a function for characters in a chartable. The mchartable_map() function calls
       function func for characters in chartable table.  No function call occurs for characters
       that have value ignore in table.  Comparison of ignore and character value is done with
       the operator ==.  Be careful when you use string literals or pointers.

       Instead of calling func for each character, mchartable_map() tries to optimize the number
       of function calls, i.e. it makes a single function call for a chunk of characters when
       those consecutive characters have the same value.

       No matter how long the character chunk is, func is called with four arguments; from, to,
       val, and arg.  from and to (both inclusive) defines the range of characters that have
       value val.  arg is the same as func_arg.

RETURN VALUE

           This function always returns 0.

COPYRIGHT

       Copyright (C) 2001 Information-technology Promotion Agency (IPA)
       Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology
       (AIST)
       Permission is granted to copy, distribute and/or modify this document under the terms of
       the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.