MAILREAD()

From Recital Documentation Wiki
Revision as of 11:54, 23 March 2009 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Class

Mail


Purpose

Function to read the specified mail message


Syntax

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


See Also

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


Description

The MAILREAD() 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 MAILREAD() fails.


Example

number = mailread(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