| SYNOPSIS |
#include <dkim.h>
int dkim_mail_parse_multi(
char *line,
char **users_out,
char **domains_out
);
Parse an RFC2822 header for a set of users and hostnames. Intended for use on
header fields that might contain multiple addresses, such as To: and Cc:.
|
|---|
| DESCRIPTION |
|
|---|
| ARGUMENTS |
| Argument | Description |
|---|
| line |
Input line, not including the name of the header.
|
| users_out |
Pointer to a variable of type (unsigned char **) that
will be set to point to an array of "local-part"s (user ID) found
in the input.
|
| domains_out |
Pointer to a variable of type (unsigned char **) which
will be set to point to an array of domains found in the input.
|
|
|---|
| RETURN VALUE |
0 on success, other on failure. The failure codes are internal to the library
for now.
|
|---|
| NOTES |
- line is modified.
- The arrays returned will be of the same size and entries are correspondent,
so the first element from each refer to the first address found, etc.
- The caller is responsible for deallocating the returned arrays once they
are no longer needed.
- This function is not part of the DKIM specification. It
is provided as a facility to implementors to reduce code duplication.
|
|---|