Difference between revisions of "MAILREAD()"

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

Latest revision as of 13:48, 4 July 2011

Purpose

Function to read the specified mail message


Syntax

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


See Also

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