TIpClientPop() > Methods

oTIpClientPop:top()

Retrieves the headers of an eMail (no body).

Syntax

:top( <nMail> ) --> cMailHeaders

Arguments

<nMail>

This is a numeric value specifying the ordinal number of the mail to get header information from.

Description

Methop :top() reads the headers of the mail with number <nMail> from the mail server and downloads them. The mail body and file attachments, if any, are not downloaded. This allows for a quick lookup for mail subject and sender. The headers can be decomposed by passing the returned string to oTIpMail():fromString(), and querying individual mail header fields with method oTIpMail():getFieldPart() and/or oTIpMail():getFieldOption()