Article Class Reference

#include <Article.h>

List of all members.

Public Types
enum	{ Head = 0x1, Body = 0x2 }
Public Member Functions
	Article ()
	Article (Article *a)
	Article (int artnbr)
	Article (int artnbr, const char *text, int textlen=0)
	~Article ()
void	read (std::istream &is)
void	setnbr (int nbr)
void	clear (void)
void	settext (const std::string &text)
int	getnbr (void) const
std::string	GetText (void)
const char *	c_str (void)
int	length (void) const
int	has_field (const char *ifld)
std::string	getfield (const char *ifld, int Full=0) const
void	setfield (const char *ifld, const char *field_data)
std::ostream &	write (std::ostream &os, int flags=Head|Body)
Protected Attributes
int	_nbr
std::string	_text
const char *	_ctext
Private Member Functions
const char *	find_field (const char *ifld) const
Friends
std::ostream &	operator<< (std::ostream &os, Article &art)

---

Detailed Description

Author:

Thomas Gschwind

Handle a Article

Bug:

Method documentation is missing.

Definition at line 36 of file Article.h.

---

Member Enumeration Documentation

anonymous enum

Enumeration values: Head  Body  Definition at line 52 of file Article.h. { Head = 0x1, Body = 0x2 };

---

Constructor & Destructor Documentation

Article::Article (   )

Definition at line 51 of file Article.cc. { }

Article::Article (  Article *  a  )

Definition at line 55 of file Article.cc. References _ctext, _nbr, _text, getnbr(), and GetText(). : _nbr(a->getnbr()), _text(a->GetText()), _ctext(_text.c_str()) { _nbr = a->getnbr(); _text = a->GetText(); _ctext = _text.c_str(); }

Article::Article (  int  artnbr  )

Definition at line 64 of file Article.cc. References setnbr(). { setnbr(artnbr); }

Article::Article (  int  artnbr, const char *  text, int  textlen = 0 )

Definition at line 69 of file Article.cc. References _ctext, _text, and setnbr(). : setnbr(artnbr), _text.assign(text, textlen), _ctext = _text.c_str() { setnbr(artnbr); _text.assign(text, textlen); _ctext = _text.c_str(); }

Article::~Article (   )

Definition at line 77 of file Article.cc. { }

---

Member Function Documentation

const char * Article::c_str (  void   )

Definition at line 117 of file Article.cc. References _ctext. Referenced by checkArticle(), and NVNewsgroup::setarticle(). { return _ctext; }

void Article::clear (  void   )

Definition at line 94 of file Article.cc. References _ctext, _nbr, and _text. { _nbr = 0; _text = ""; _ctext = _text.c_str(); }

const char * Article::find_field (  const char *  ifld  )  const [private]

Return the position of a given field in the article's header. Parameters: ifld  The name of the field to be searched for including `:' Exceptions: InvalidArticleError  If a syntactic error is detected. Definition at line 137 of file Article.cc. References _ctext, ERROR_LOCATION, slog, and VERB. Referenced by getfield(), has_field(), and setfield(). { char hdrbuf[513], *p; const char *q, *fld; const char *ifp; unsigned int i; i = 1; p = hdrbuf; ifp = ifld; while (i < sizeof(hdrbuf) && (*p = tolower(*ifp))) { i++; p++; ifp++; } if (i == sizeof(hdrbuf)) { p--; VERB(slog. p(Logger:: Error) << "Article::find_field: field exceeds 512 characters! Contact maintainer!\n"); } *p = '\0'; q = _ctext; for (;;) { p = hdrbuf; fld = q; while (*p && *p == tolower(*q)) { p++; q++; } if (*p == '\0') return fld; // bad luck find next line while (*q && *q != '\r' && *q != '\n') q++; if (!*q) { VERB(slog. p(Logger:: Error) << "Article::find_field: unterminated header, no body\n"); throw InvalidArticleError ("unterminated header, no body", ERROR_LOCATION); } // Skip first CRLF if (*q == '\r' && *(q + 1) == '\n') { q += 2; } else if (*q == '\n') { ++q; } else { VERB(slog. p(Logger:: Error) << "Article::find_field: line not terminated with CRLF\n"); throw InvalidArticleError ("line not terminated with CRLF/LF", ERROR_LOCATION); } if (*q == '\r' || *q == '\n') return q; } }

string Article::getfield (  const char *  ifld, int  Full = 0 )  const

Definition at line 205 of file Article.cc. References _text, ERROR_LOCATION, and find_field(). Referenced by checkArticle(), ArtSpooler::extractID(), ns_post(), ns_stat(), nsh_particle(), RServer::post(), CServer::postspooled(), and NVNewsgroup::printheaderdb(). { string rfld; const char *p, *fld; if (strcasecmp(ifld, "bytes:") == 0) { #ifdef HAVE_SSTREAM stringstream sb; #else strstream sb; #endif sb << _text.length(); return sb.rdbuf()->str(); } fld = find_field(ifld); if (*fld == '\r' || *fld == '\n') { // Bad luck, did not find the header throw NoSuchFieldError(ifld, ERROR_LOCATION); } // found header p = fld + strlen(ifld); while (*p == ' ' || *p == '\t') p++; if (!Full) fld = p; while (*p && *p != '\r' && *p != '\n') p++; rfld.assign(fld, p - fld); if (*p == '\n') p++; else if (*p == '\r') { if (*(p + 1) != '\n') throw InvalidArticleError ("illegaly terminated line, neither <lf> nor <cr><lf>", ERROR_LOCATION); p += 2; } if (!(*p)) throw InvalidArticleError("article without body", ERROR_LOCATION); // multi-line header? while (*p == ' ' || *p == '\t') { do { p++; } while (*p == ' ' || *p == '\t'); fld = p; while (*p && *p != '\r' && *p != '\n') p++; rfld.append(fld, p - fld); if (*p == '\n') p++; else if (*p == '\r') { if (*(p + 1) != '\n') throw InvalidArticleError ("illegaly terminated line, neither <lf> nor <cr><lf>", ERROR_LOCATION); p += 2; } if (!(*p)) throw InvalidArticleError ("article without body", ERROR_LOCATION); } return rfld; }

int Article::getnbr (  void   )  const

Definition at line 107 of file Article.cc. References _nbr. Referenced by Article(), OverviewFmt::convert(), and NVNewsgroup::setarticle(). { return _nbr; }

string Article::GetText (  void   )

Definition at line 112 of file Article.cc. References _text. Referenced by Article(). { return _text; }

int Article::has_field (  const char *  ifld  )

Definition at line 127 of file Article.cc. References find_field(). Referenced by checkArticle(), and RServer::post(). { char c; c = *find_field(ifld); if (!c || c == '\r' || c == '\n') return 0; return 1; }

int Article::length (  void   )  const

Definition at line 122 of file Article.cc. References _text. Referenced by checkArticle(), OverviewFmt::convert(), nsh_particle(), and NVNewsgroup::setarticle(). { return _text.length(); }

void Article::read (  std::istream &  is  )

Definition at line 81 of file Article.cc. References _ctext, _text, DEBUG, Logger::p(), readtext(), and slog. Referenced by CServer::article(), RServer::article(), checkArticle(), checkConvertArtOver(), NVNewsgroup::getarticle(), ArtSpooler::getSpooledArt(), main(), ns_post(), and NVNewsgroup::printarticle(). { DEBUG(slog.p(Logger::Debug) << "Article::read(&is)\n"); _text = ""; readtext(is, _text); _ctext = _text.c_str(); }

void Article::setfield (  const char *  ifld, const char *  field_data )

Definition at line 277 of file Article.cc. References _ctext, _text, ASSERT, Logger::Error, find_field(), Logger::p(), and slog. Referenced by checkArticle(), and RServer::post(). { const char *p, *fld; fld = find_field(ifld); if (*fld == '\r' || *fld == '\n') { // Bad luck, did not find the header _text.insert(fld - _ctext, field_data); _ctext = _text.c_str(); return; } // We have found the header p = fld + strlen(ifld); while (isspace(*p)) p++; while (*p && *p != '\r' && *p != '\n') p++; ASSERT(if (!(*p)) { slog.p(Logger::Error) << "Article without body.\n";} if (*p == '\r' && !(*(p + 1))) { slog.p(Logger::Error) << "Article ended with <CR><NULL>.\n";} ); if (*p == '\n') p++; if (*p == '\r' && *(p + 1) == '\n') p += 2; // Multiline header? while (isspace(*p) && *p != '\n' && *p != '\r') { while (isspace(*p)) p++; while (*p != '\r' && *p != '\n') p++; ASSERT(if (!(*p)) { slog.p(Logger::Error) << "Article without body.\n";} if (*p == '\r' && !(*(p + 1))) { slog. p(Logger:: Error) << "Article ended with <CR><NULL>.\n";} ); if (*p == '\n') p++; if (*p == '\r' && *(p + 1) == '\n') p += 2; } _text.replace(fld - _ctext, p - fld, field_data); _ctext = _text.c_str(); }

void Article::setnbr (  int  nbr  )

Definition at line 89 of file Article.cc. References _nbr. Referenced by CServer::article(), RServer::article(), Article(), and checkConvertArtOver(). { _nbr = nbr; }

void Article::settext (  const std::string &  text  )

Definition at line 101 of file Article.cc. References _ctext, and _text. Referenced by checkArticle(). { _text = text; _ctext = _text.c_str(); }

ostream & Article::write (  std::ostream &  os, int  flags = Head|Body )

Definition at line 326 of file Article.cc. References _ctext, _text, Body, Head, slog, and VERB. Referenced by checkArticle(), nsh_particle(), and CServer::post(). { const char *p, *q; if ((flags & (Head | Body)) == (Head | Body)) { os << _text; return os; } p = q = _ctext; for (;;) { while (*q && *q != '\r' && *q != '\n') q++; if (!*q) { VERB(slog. p(Logger:: Notice) << "Article::write: Article without body!\n"); break; } if (*q == '\r' && *(q + 1) == '\n' && *(q + 2) == '\r' && *(q + 3) == '\n') { q += 2; break; } if (*q == '\n' && *(q + 1) == '\n') { q++; break; } while (*q == '\n' || *q == '\r') q++; } if (flags & Head) { os.write(p, q - p); } else if (flags & Body) { if (*q == '\n') p++; else if (*q == '\r' && *(q + 1) == '\n') q += 2; os.write(q, _text.length() - (q - p)); } return os; }

---

Friends And Related Function Documentation

std::ostream& operator<< (  std::ostream &  os, Article &  art )  [friend]

Definition at line 371 of file Article.cc. { os << art._text; return os; }

---

Member Data Documentation

const char* Article::_ctext [protected]

Definition at line 49 of file Article.h. Referenced by Article(), c_str(), clear(), find_field(), read(), setfield(), settext(), and write().

int Article::_nbr [protected]

Definition at line 47 of file Article.h. Referenced by Article(), clear(), getnbr(), and setnbr().

std::string Article::_text [protected]

Definition at line 48 of file Article.h. Referenced by Article(), clear(), getfield(), GetText(), length(), operator<<(), read(), setfield(), settext(), and write().

---

The documentation for this class was generated from the following files:

• Article.h
• Article.cc

---