Difference between revisions of "READMAIL()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=READMAIL()=
 
 
 
==Class==
 
Mail
 
 
 
 
==Purpose==
 
==Purpose==
 
Function to read the specified mail message
 
Function to read the specified mail message
Line 15: Line 8:
  
 
==See Also==
 
==See Also==
[[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILOPEN()]], [[MAILREAD()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[SENDMAIL()]]
+
[[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILATTACH()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILOPEN()]], [[MAILREAD()]], [[MAILSAVEAS()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[SENDMAIL()]]
  
  
Line 52: Line 45:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital, Recital Server
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Category:Mail]]
 +
[[Category:Mail Functions]]

Latest revision as of 12:52, 4 July 2011

Purpose

Function to read the specified mail message


Syntax

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


See Also

CLOSEMAIL(), COUNTMAIL(), DELETEMAIL(), MAILATTACH(), MAILCLOSE(), MAILCOUNT(), MAILDELETE(), MAILERROR(), MAILHEADER(), MAILNODENAME(), MAILOPEN(), MAILREAD(), MAILSAVEAS(), 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, Recital Server