Difference between revisions of "READMAIL()"

From Lianjapedia
Jump to: navigation, search
m (1 revision)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Function to read the specified mail message
 
Function to read the specified mail message
 
  
 
==Syntax==
 
==Syntax==
 
READMAIL(<expN>, <expC1>, [ ,<expC2>])
 
READMAIL(<expN>, <expC1>, [ ,<expC2>])
 
  
 
==See Also==
 
==See Also==
 
[[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILATTACH()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILOPEN()]], [[MAILREAD()]], [[MAILSAVEAS()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[SENDMAIL()]]
 
[[CLOSEMAIL()]], [[COUNTMAIL()]], [[DELETEMAIL()]], [[MAILATTACH()]], [[MAILCLOSE()]], [[MAILCOUNT()]], [[MAILDELETE()]], [[MAILERROR()]], [[MAILHEADER()]], [[MAILNODENAME()]], [[MAILOPEN()]], [[MAILREAD()]], [[MAILSAVEAS()]], [[MAILSEND()]], [[MAILUSERNAME()]], [[OPENMAIL()]], [[SENDMAIL()]]
 
  
 
==Description==
 
==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.
 
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.
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 29: Line 25:
 
|-
 
|-
 
|}
 
|}
 
  
 
The MAILERROR() function can be used to return the error message if the READMAIL() fails.
 
The MAILERROR() function can be used to return the error message if the READMAIL() fails.
 
  
 
==Example==
 
==Example==
Line 43: Line 37:
 
</code>
 
</code>
  
 
==Products==
 
Recital, Recital Server
 
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
[[Category:Mail]]
 
 
[[Category:Mail Functions]]
 
[[Category:Mail Functions]]

Revision as of 09:26, 7 December 2012

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.