Home | Previous Page | Next Page   Function Descriptions >

mi_trigger_get_new_row( )

The mi_trigger_get_new_row( ) function returns the name of the new row value if the MI_TRIGGER_FOREACH_EVENT bit is set, which implies that neither the MI_TRIGGER_BEFORE_EVENT nor the MI_TRIGGER_AFTER_EVENT bits are set.

Syntax

MI_ROW *mi_trigger_get_new_row(void)
Valid in Client LIBMI Application? Valid in User-Defined Routine?
No Yes

Usage

For an INSERT or UPDATE statement, the mi_trigger_get_new_row( ) function returns the new row being inserted or the updated value of the row. It returns NULL when called in other trigger action statements.

Return Values

An MI_ROW pointer
is a pointer to the new row.
NULL
indicates the function was one of the following:
  • not successful.
  • not in the trigger action.
  • not in the FOR EACH row trigger.
  • not in one of the INSERT or UPDATE triggers.

Related Topics

See also descriptions of mi_trigger_event( ), mi_trigger_get_old_row( ), mi_trigger_level( ), mi_trigger_name( ), and mi_trigger_tabname( ).

Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]