Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members

FileReader Class Reference

Caches a text file into memory and can be used to retrieve lines from it. More...

#include <modules.h>

Inheritance diagram for FileReader:

[legend]Collaboration diagram for FileReader:

[legend]List of all members.

Public Member Functions
	FileReader (InspIRCd *Instance)
	Default constructor.
	FileReader (InspIRCd *Instance, const std::string &filename)
	Secondary constructor.
	~FileReader ()
	Default destructor.
void	LoadFile (const std::string &filename)
	Used to load a file.
std::string	Contents ()
	Returns the whole content of the file as std::string.
unsigned long	ContentSize ()
	Returns the entire size of the file as std::string.
bool	Exists ()
	Returns true if the file exists This function will return false if the file could not be opened.
std::string	GetLine (int x)
	Retrieve one line from the file.
int	FileSize ()
	Returns the size of the file in lines.
Private Member Functions
void	CalcSize ()
	Calculate content size in bytes.
Private Attributes
InspIRCd *	ServerInstance
file_cache	fc
	The file contents.
unsigned long	contentsize
	Content size in bytes.

---

Detailed Description

Caches a text file into memory and can be used to retrieve lines from it.

This class contains methods for read-only manipulation of a text file in memory. Either use the constructor type with one parameter to load a file into memory at construction, or use the LoadFile method to load a file.

Definition at line 1574 of file modules.h.

---

Constructor & Destructor Documentation

FileReader::FileReader (  InspIRCd *  Instance  )

Default constructor. This method does not load any file into memory, you must use the LoadFile method after constructing the class this way. Definition at line 673 of file modules.cpp. : ServerInstance(Instance) { }

FileReader::FileReader (  InspIRCd *  Instance, const std::string &  filename )

Secondary constructor. This method initialises the class with a file loaded into it ready for GetLine and and other methods to be called. If the file could not be loaded, FileReader::FileSize returns 0. Definition at line 668 of file modules.cpp. References LoadFile(). : ServerInstance(Instance) { LoadFile(filename); }

FileReader::~FileReader (   )

Default destructor. This deletes the memory allocated to the file. Definition at line 713 of file modules.cpp. { }

---

Member Function Documentation

void FileReader::CalcSize (   )  [private]

Calculate content size in bytes. Definition at line 693 of file modules.cpp. References contentsize, and fc. Referenced by LoadFile(). { unsigned long n = 0; for (file_cache::iterator a = this->fc.begin(); a != this->fc.end(); a++) n += (a->length() + 2); this->contentsize = n; }

std::string FileReader::Contents (   )

Returns the whole content of the file as std::string. Definition at line 677 of file modules.cpp. References fc. Referenced by HttpServerSocket::ServeData(). { std::string x; for (file_cache::iterator a = this->fc.begin(); a != this->fc.end(); a++) { x.append(*a); x.append("\r\n"); } return x; }

unsigned long FileReader::ContentSize (   )

Returns the entire size of the file as std::string. Definition at line 688 of file modules.cpp. References contentsize. Referenced by HttpServerSocket::ServeData(). { return this->contentsize; }

bool FileReader::Exists (   )

Returns true if the file exists This function will return false if the file could not be opened. Definition at line 717 of file modules.cpp. References fc. Referenced by cmd_randquote::Handle(), ModuleRandQuote::ModuleRandQuote(), and ModuleHttpServer::ReadConfig(). { return (!(fc.size() == 0)); }

int FileReader::FileSize (   )

Returns the size of the file in lines. This method returns the number of lines in the read file. If it is 0, no lines have been read into memory, either because the file is empty or it does not exist, or cannot be opened due to permission problems. Definition at line 729 of file modules.cpp. References fc. Referenced by cmd_randquote::Handle(), and ShowOperMOTD(). { return fc.size(); }

std::string FileReader::GetLine (  int  x  )

Retrieve one line from the file. This method retrieves one line from the text file. If an empty non-NULL string is returned, the index was out of bounds, or the line had no data on it. Definition at line 722 of file modules.cpp. References fc. Referenced by cmd_randquote::Handle(), and ShowOperMOTD(). { if ((x<0) || ((unsigned)x>fc.size())) return ""; return fc[x]; }

void FileReader::LoadFile (  const std::string &  filename  )

Used to load a file. This method loads a file into the class ready for GetLine and and other methods to be called. If the file could not be loaded, FileReader::FileSize returns 0. Definition at line 701 of file modules.cpp. References CalcSize(), InspIRCd::Config, fc, ServerConfig::ReadFile(), and ServerInstance. Referenced by FileReader(). { file_cache c; c.clear(); if (ServerInstance->Config->ReadFile(c,filename.c_str())) { this->fc = c; this->CalcSize(); } }

---

Member Data Documentation

unsigned long FileReader::contentsize [private]

Content size in bytes. Definition at line 1583 of file modules.h. Referenced by CalcSize(), and ContentSize().

file_cache FileReader::fc [private]

The file contents. Definition at line 1579 of file modules.h. Referenced by CalcSize(), Contents(), Exists(), FileSize(), GetLine(), and LoadFile().

InspIRCd* FileReader::ServerInstance [private]

Definition at line 1576 of file modules.h. Referenced by LoadFile().

---

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

• modules.h
• modules.cpp