IP2CParser Class Reference

#include <ip2cparser.h>

Inheritance diagram for IP2CParser:

Classes
class	ConstructorDestructorParserStateSetter
	Sets states for IP2C when being constructed and destructed. More...
class	ParsingThread

Signals
void	parsingFinished (bool bSuccess)
	A signal emitted when parser finishes its job. More...

Public Member Functions
	IP2CParser (IP2C *pTargetDatabase)
IP2C *	ip2c () const
	Retrieves the IP2C database this parser operates on. More...
bool	isParsing () const
	For multi-threading purposes. If this is true it is not recommended to delete this object nor the underlying IP2C database. More...
bool	readDatabase (const QString &filePath)
void	readDatabaseThreaded (const QString &filePath)

Protected Types
typedef QHash< QString, QList< IP2C::IP2CData > >	Countries
typedef QHash< QString, QList< IP2C::IP2CData > >::const_iterator	CountriesConstIt
typedef QHash< QString, QList< IP2C::IP2CData > >::iterator	CountriesIt

Protected Slots
void	parsingThreadFinished ()

Protected Member Functions
bool	doReadDatabase (const QString &filePath)
bool	readDatabaseVersion2 (const QByteArray &dataArray)

Protected Attributes
bool	bIsParsing
ParsingThread *	currentParsingThread
IP2C *	pTargetDatabase
	Database to which the IP2C parser will save the data it retrieves from IP2C file. More...
QMutex	thisLock

Detailed Description

Compacted database file format, version 2: (all strings are null terminated) Header:

TYPE                    LENGTH          DESCRIPTION
-----------------------------------------------------
unsigned long   4                       'I' 'P' '2' 'C' bytes
unsigned short  2                       Version (equal to 2)

Block repeated until EOF:

TYPE                    LENGTH          DESCRIPTION
-----------------------------------------------------
string                  N/A             Country full name, UTF-8
string                  N/A             Country abbreviation (3 letters version)
unsigned long   4                       Number of IP Blocks (N_IP_BLOCKS)

-- BLOCK: repeated N_IP_BLOCKS times.
unsigned long   4                       Beginning of an IP range
unsigned long   4                       End of an IP range
-- END OF BLOCK

Definition at line 55 of file ip2cparser.h.

Member Typedef Documentation

typedef QHash<QString, QList<IP2C::IP2CData> > IP2CParser::Countries

protected

Key value is the abbreviation of the country name.

Definition at line 122 of file ip2cparser.h.

Member Function Documentation

IP2C* IP2CParser::ip2c ( ) const

inline

Retrieves the IP2C database this parser operates on.

Definition at line 65 of file ip2cparser.h.

bool IP2CParser::isParsing ( ) const

inline

For multi-threading purposes. If this is true it is not recommended to delete this object nor the underlying IP2C database.

Definition at line 71 of file ip2cparser.h.

void IP2CParser::parsingFinished ( bool  bSuccess )

signal

A signal emitted when parser finishes its job.

It is not safe to delete IP2CParser object after readDatabase() call and before this signal is emitted.

Member Data Documentation

IP2C* IP2CParser::pTargetDatabase

protected

Database to which the IP2C parser will save the data it retrieves from IP2C file.

Since IP2CParser is prepared to work in a separate thread it is not advised to delete the IP2C object before parsing is complete.

Definition at line 136 of file ip2cparser.h.

---

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

• src/core/ip2c/ip2cparser.h
• src/core/ip2c/ip2cparser.cpp