◆ MapApplyFuncToElements()

EXTERN_C bool Chusov::MapApplyFuncToElements	(	HCHSVMAP	hMap,
		PMAPELEMENTFUNCTION	lpfnCallback,
		void *	lpCallbackArg
	)

The function implements calling the specified callback function called over each element of the map.

Parameters

[in]	hMap	is a handle to the specified map or multimap containing elements being processed by the call.
[in]	lpfnCallback	is a pointer to a callback function of the PMAPELEMENTFUNCTION type.
[in]	lpCallbackArg	is a pointer to a user-defined argument passed "as-is" to each call of the callback function as the forth parameter.

Returns: On success the function returns the conjunction of the return values of the calls to the callback function over each map element. On failure it returns false.

Remarks: Declared in chsvmap.h.; The function itself throws nothing but passes exceptions originated in the callback up to the caller without internal processing.