strpattern_match_invoke_action()

Get the action of an invoke associated with a pattern match.

Synopsis:

#include </strpattern.h>

const char* strpattern_match_invoke_action(const strpattern_match *match, int index, int *err)

Arguments:

match: The match containing the invoke whose action is returned.

index: The index of the invoke associated with the match.

err: STRPATTERN_EOK if there is no error.

Library:

libstrpattern

Description:

This function gets the action of an invoke associated with a pattern match and returns a NULL-terminated string with the action. An action is defined by a recognizer on a found match. An invoke means that it was found by a recognizer and a match was created for it. A recognizer is an email address, phone number, PIN, SMS, or URL. Currently, no action is used or set on any of the recognizers.

Returns:

A NULL-terminated string with the action. NULL if no action is set for the invoke or on error. Ownership is retained by the callee.