mchartable_map - Call a function for characters in a chartable.
, void *
, void(*)(int, int
, void *, void *) func
, void *
Call a function for characters in a chartable.
The mchartable_map() function calls function func for characters in chartable
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;
and arg .
from and to (both
inclusive) defines the range of characters that have value val .
the same as func_arg .
This function always returns 0.
Copyright (C) 2001 Information-technology Promotion Agency (IPA)
Copyright (C) 2001-2009 National Institute of Advanced Industrial Science and
Permission is granted to copy, distribute and/or modify this document under the
terms of the GNU Free Documentation License