pop3.h

Go to the documentation of this file.

//
// Copyright 2002, Lowell Boggs Jr.
//
// This file or directory, containing source code for a computer program,
// is Copyrighted by Lowell Boggs, Jr.  987 Regency Drive, Lewisville
// TX (USA), 75067.  You may use, copy, modify, and distribute this
// source file without charge or obligation so long as you agree to
// the following:
//
//  1.  You must indemnify Lowell Boggs against any and all financial
//      obligations caused by its use, misuse, function, or malfunction.
//      Further, you acknowledge that there is no warranty of any kind,
//      whatsoever.
//
//  2.  You agree not to attempt to patent any portion of this original
//      work -- though you may attempt to patent your own extensions to
//      it if you so choose.
//
//  3.  You keep this copyright notice with the file and all copies
//      of the file and do not change it anyway except language translation.
//
// You are responsible for enforcing your own compliance with these
// conditions and may not use this source file if you cannot agree to the
// above terms and conditions.
//
// Warning:  not all files in this directory structure are covered by the
// same copyright.  Some of them are part of the GNU source distribution
// and you must obey the GPL copyright for those files.

#ifndef POP3_CLASS_HEADER
#define POP3_CLASS_HEADER

#include <string>
#include <list>
#include <cxxtls/file.h>

class POP3
  //
  //
  //
{
  struct Impl;           
  Impl*  impl_;          

public:

  typedef std::string            string;
  typedef std::list<string>      stringlist_t;

  enum constants
  {
    ok,                          // must be zero
    connected,
    not_connected,
    connect_failed,
    last_constant
  };

  POP3();
 ~POP3();

  char const* connect(string server, string user, string password);
    //
    //
                
  int connect_status() const;
    //
    //

  void disconnect();
    //
    //

  struct User
  {
    string email_address_;  
    string user_name_;      

    User(string const &email="")
    : email_address_(email)
    {
    }

  };

  typedef std::list<User>  userlist_t;

  struct Header
  {
    userlist_t        to_;        
    userlist_t        from_;      
    userlist_t        bcc_;       
    string            subject_;   

    cxxtls::FileTime  date_;      


                                
    stringlist_t      options_;  


    string            id_;        
  };

  struct Attachment
  {
    string              name_;
    string              mime_type_;
    string              encoding_;
    stringlist_t        lines_;
  };

  struct Body
  {
    stringlist_t             lines_;
    std::list<Attachment*>   attachments_;

  };

  struct Message
  {
    Header header_;
    Body   body_;
  };


  size_t messages() const; 

  char const *message_header(size_t message_number, Header **header);
    //

  char const *message_body(size_t message_number, Body **header);
    //


};


#endif