char *mi_func_commutator(funcdesc_ptr)
   MI_FUNC_DESC *funcdesc_ptr;

funcdesc_ptr

is a pointer to a function descriptor for a user-defined function.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
No	Yes

The mi_func_commutator( ) function obtains the name of the commutator function for the user-defined function associated with the funcdesc_ptr function descriptor. When you register a user-defined function, you can use the COMMUTATOR routine modifier of the CREATE FUNCTION statement to associate a commutator function with the user-defined function. To be a commutator function, a user-defined function must have either of the following similarities to the registered user-defined function:

• The commutator function takes the same arguments as the registered user-defined function but in opposite order.
• The commutator function returns the same result as the registered user-defined function.

The mi_func_commutator( ) function is one of the functions of the Fastpath interface.

A char pointer

is a pointer to the name of the commutator function for the user-defined function that the funcdesc_ptr function descriptor identifies.

NULL

indicates that the function was not successful.

See also the descriptions of mi_cast_get( ), mi_fparam_get( ), mi_func_handlesnulls( ), mi_func_isvariant( ), mi_func_negator( ), mi_routine_get( ), mi_routine_get_by_typeid( ), mi_routine_id_get( ), and mi_td_cast_get( ).