API-интерфейс модуля Net::POP3. Для модуля Net::POP3 предусмотрен простой API-интерфейс. Он позволяет уста­навливать и разрывать соединение с сервером, получать список сообщений, выби­рать заголовки сообщений и сами сообщения, а также удалять ненужные сообщения.

$рор = Net::POP3->new([$host] [, $opt1>$vall, $opt2=>$val2. . .,])

Метод new() создает новый объект Net::pop3. Первый, необязательный параметр представ­ляет собой имя или IP-адрес хоста почтового ящика. За ним может следовать ряд пар “опция/значение”. Если хост не указан, его имя будет взято из параметра P0P3_hosts модуля Net::Config, указанного при инсталляции модуля libnet; его опции будут перечислены далее.

Опция ResvPort применяется с некоторыми серверами POP3, которые требуют от клиентов подключения из зарезервированных портов. В случае неудачного завершения метод new() возвращает значение undef и в переменной устанавливается определенный код ошибки.

$messages = $pop->login([$usename[, $password] ])

Метод login() предпринимает попытку зарегистрироваться на сервере с использованием ука­занного имени пользователя и пароля. Если не указано имя пользователя или пароль либо не ука­заны оба значения, метод login() ищет информацию аутентификации для данного хоста в файле .netrc пользователя.

При успешном выполнении метод login() возвращает общее число сообщений, находящихся в почтовом ящике пользователя. Если там нет сообщений, метод login( ) возвращает число с плавающей точкой 0Е0, которое рассматривается как истинное значение при использовании его в качестве логического значения для про­верки того, была ли регистрация успешной. Однако число 0Е0 принимает нулевое значение при его применении для подсчёта числа доступных сообщений. При воз­никновении ошибки метод login() возвращает значение undef и переменная $pop->message() содержит сообщение об ошибке.