Validates an Internet address based on the RFC 822 or RFC 821 Address Format Syntax.

Note This @function is new with Release 5.

Syntax

@ValidateInternetAddress( [ addressFormat ] ; Address )

Parameters

[ addressFormat ]

Keyword. Specifies the formatting with which to validate an Internet address. Can be one of the following keywords:

[ADDRESS821]

Requests input address be validated based on RFC821 Address Format Syntax.

SStreitfeld@gazette.com

[ADDRESS822]

Requests input address be validated based on RFC822 Address Format Syntax.

"Streitfeld, Sara (Miami)" <SStreitfeld@gazette.com>

Input address string

• If validation is successful, the NULL string is returned.
• If validation fails, an error message string is returned to the user specific to the failure. More error message strings will be added in the future as necessary.

"Invalid Input Parameter"

Invalid parameters to @function - @ValidateInternetAddress.

"Invalid RFC821 syntax, no Phrase required."

When a phrase is present in an address requiring an RFC821 syntax.

"Invalid Phrase or character found."

Phrase part of 822 address invalid.

"Invalid Quoted String or mismatched quotes found."

Quoted string is invalid within the address.

"Invalid comment or mismatched parenthesis found."

Embedded (comment(s)) within address is invalid.

"Invalid or missing Domain."

Invalid or missing Domain part of Address.

"Invalid LocalPart or character found."

Invalid LocalPart specified.

Usage

@ValidateInternetAddress is currently used in location records to validate Internet address fields as well as in mail forms. This function is most useful in field validation formulas where users are asked to input their Internet address or in computed fields where Internet addresses are inherited.

Note Multi-byte, or 8-bit characters, are allowed in the Phrase part of an RFC 822 format Internet address. They are not allowed anywhere else. Also, the Group syntax (i.e. several Internet addresses combined into one group name, such as "Customers") is not supported in the validator.

Example

Glossary