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>

Text or text list. Input address string

Text or text list.
• If validation is successful, an empty 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.

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

Phrase part of 822 address invalid.

Quoted string is invalid within the address.

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

Invalid or missing Domain part of Address.

Invalid LocalPart specified.

@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.

If the second parameter is a list, the function operates on each element of the list, and the return value is a list with the same number of elements.

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 (that is, several Internet addresses combined into one group name, such as "Customers") is not supported in the validator.

Example

Glossary