READMAIL()

From Recital Documentation Wiki
Revision as of 15:58, 28 October 2009 by Helengeorge (Talk | contribs)

Jump to: navigation, search


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