Pop3Client Module Introduction

The Pop3Client module provides the Pop3Client class for retrieving emails from a POP3 server, with or without TLS/SSL encryption.

To use this module, use "%requires Pop3Client" in your code. See examples/pop3.q for an example program using this module.

All the public symbols in the module are defined in the Pop3Client namespace.

The main classes are:

Pop3Client: provides an interface to a POP3 server for retrieving emails
Pop3Connection: provides a connection object to a POP3 server (based on the ConnectionProvider module)

Example:: #!/usr/bin/env qore

%new-style

%strict-args

%require-types

%enable-all-warnings

%requires Pop3Client

sub log(string msg) {

printf("%y: %s\n", now_ms(), vsprintf(msg, argv));

}

string url = "pop3s://username:[email protected]";

Pop3Client pop3(url, \log(), \log());

# do not send a QUIT so changes will not be committed

pop3.noquit(True);

*hash<auto> h = pop3.getMail();

printf("Mailbox Summary:\n");

map printf("%s: From: %s (size: %d bytes, attachments: %d)\n", $1.key, $1.value.msg.getFrom(), $1.value.size, $1.getvalue.msg.getAttachments().size()), h.pairIterator();

if (!h)

printf("no messages\n");

now_ms
date now_ms()

printf
string printf(string fmt,...)

vsprintf
string vsprintf(string fmt, auto varg)

Pop3Client Module Release Notes

implemented support for a data provider scheme cache and rich option information for connections (issue 4025)

removed the Pop3Connection::getConstructorInfo() and Pop3Connection::getConstructorInfoImpl() methods (issue 3696)
added support for socket events (issue 3425)

added the Pop3Connection::getConstructorInfo() method to allow connections to be created dynamically, potentially in another process from a network call (removed in Pop3Client 1.8) (issue 2628)