The Annoyance Filter.pdf - Fourmilab

108 MAIL FOLDER ANNOYANCE-FILTER §129
129. Mail folder.
The mailFolder class returns successive lines from a mail folder bound to an input stream.
〈 Class definitions 10 〉 +≡
〈 Configure compression suffix and command 132 〉
class mailFolder {
public:
istream ∗is ; /∗ Stream to read mail folder from ∗/
dictionaryWord ::mailCategory category ; /∗ Category (Mail or Junk) ∗/
unsigned int nLines ; /∗ Number of lines in folder ∗/
unsigned int nMessages ; /∗ Number of messages read so far ∗/
bool newMessage ; /∗ On first line of new message ? ∗/
bool expectingNewMessage ; /∗ Expecting start of new message ? ∗/
bool lastLineBlank ; /∗ Was last line in mail folder blank ? ∗/
bool BSDfolder ; /∗ Mail folder uses “pure BSD” message boundary semantics ∗/
bool inHeader ; /∗ Within message header section ∗/
string lookAheadLine ; /∗ Line to save look ahead while parsing headers ∗/
bool lookedAhead ; /∗ Have we a look ahead line ? ∗/
ifstream isc; /∗ Input stream for (possibly compressed) input file ∗/
#if defined (COMPRESSED_FILES) ∧ defined (HAVE_FDSTREAM_COMPATIBILITY)
fdistream iscc; /∗ Pipe input stream to read compressed input file ∗/
#endif
string fromLine ; /∗ “From␣” line for diagnostics ∗/
string messageID ; /∗ Message ID for diagnostics ∗/
string lastFromLine ; /∗ Last “From␣” line shown in diagnostics ∗/
string lastMessageID ; /∗ Last message ID shown in disgnostics ∗/
/∗ Compressed file decoding ∗/
#if defined (COMPRESSED_FILES) ∨ defined (HAVE_DIRECTORY_TRAVERSAL)
FILE ∗ip; /∗ File handle used for popen pile to decompressor ∗/
#endif
#ifdef HAVE_DIRECTORY_TRAVERSAL /∗ Directory traversal ∗/
bool dirFolder ; /∗ Are we reading a directory folder ? ∗/
DIR ∗ dh ; /∗ Handle for readdir ∗/
string dirName , cfName ; /∗ Directory name and current file name in directory ∗/
string pathSeparator ; /∗ System path separator ∗/
#ifdef HAVE_FDSTREAM_COMPATIBILITY
fdistream ifcdir ; /∗ Stream to read compressed file in directory ∗/
#endif
ifstream ifdir ; /∗ Stream to read file in directory ∗/
istringstream nullstream ; /∗ Null stream for empty directory case ∗/
#endif /∗ Body encoding properties ∗/
string bodyContentType ; /∗ Content−Type ∗/
string bodyContentTypeCharset ; /∗ charset= ∗/
string bodyContentTypeName ; /∗ name= ∗/
string bodyContentTransferEncoding ; /∗ Content−Transfer−Encoding ∗/
/∗ MIME multi-part separators and status ∗/
string partBoundary ; /∗ Mime part boundary sentinel ∗/
bool multiPart ; /∗ Is message MIME multi-part ? ∗/
bool inPartHeader ; /∗ In MIME part header ? ∗/
unsigned int partHeaderLines ; /∗ Number of lines in part header ∗/