READMAIL()

Purpose

Function to read the specified mail message

Syntax

READMAIL(<expN>, <expC1>, [ ,<expC2>])

See Also

CLOSEMAIL(), COUNTMAIL(), DELETEMAIL(), MAILCLOSE(), MAILCOUNT(), MAILDELETE(), MAILERROR(), MAILHEADER(), MAILNODENAME(), MAILOPEN(), MAILREAD(), MAILSEND(), MAILUSERNAME(), OPENMAIL(), SENDMAIL()

Description

The READMAIL() function will read the mail message specified by the number <message>, returning the number of elements in the array that it creates. If you are not connected to a mail server, it will return an error. You can use the MAILUSERNAME() or MAILNODENAME() function to check if you are connected.

Parameters	Required	Default	Description
<expN>	Yes	None	Numeric value specifying the mail message to read
<expC1>	Yes	None	The name of the array to be created to contain the lines of the mail message
<expC2>	No	"ALL"	The text that will be read from the mail message. This can be any one of the following: "ALL" "HEADER" "BODY" "ATTACHMENT"

The MAILERROR() function can be used to return the error message if the READMAIL() fails.

Example

number = readmail(1, "mail_mes", "BODY")
? number
        30
? mail_mes[30]
This is the last line in the mail message.

Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer