dca::HtmlTextClassifier Class Reference

#include <text_classifier.h>

Detailed Description

HTML text classifier object for text classification.

See also

TextClassification, TextClassificationResult, HtmlText, CategoriesInfo

The following sample shows the text classification workflow:

// assume we have a valid DcaInstance (myDca) and License (myLicense)
 
// initialize the Text Classification module
dca::TextClassification myTextClassification = 
        dca::TextClassification::create( myDca, myLicense );
 
// create an HTML Text Classifier
dca::HtmlTextClassifier myHtmlTextClassifier = 
        myTextClassification.createHtmlClassifier();
 
// create an HTML text object
// assume we have the contents of a valid HTML page in std::string 
// myHtmlTextContents
dca::HtmlText myHtmlText = 
        dca::HtmlText::create( myDca, myHtmlTextContents );
 
// declare the classification results
dca::TextClassificationResults myTextClassificationResults;
 
// run the classification
dca::FunctionResult myResult = 
        myHtmlTextClassifier.classify( myHtmlText, myTextClassificationResults );
 
// if myResult returns false an error occured
if( !myResult ) {
        cout << "Received error from Text Classification (Error code: " <<
                myResult.getReturnCode() << ", Description: " <<
                myResult.getDescription() << ")." << endl;
        return;
}
 
if( !myTextClassificationResults.isCategorized() ) {
        cout << "No categories found for given HTML data." << endl;
        return;
}
 
// we received results and simply want to print them out
const DCA_SIZE_TYPE count = myTextClassificationResults.size();
 
// iterate through all matched categories
for( DCA_INDEX_TYPE i = 0; i < count; ++i ) {
        const dca::TextClassificationResult myTCResult = 
                myTextClassificationResults[ i ];
                
        cout << "Got result #" << (i+1) << " category id:" <<
                myTCResult.id() << ", Score:" <<
                myTCResult.score() << endl;
}

Definition at line 33 of file text_classifier.h.

Public Member Functions
FunctionResult	classify (const HtmlText &aText, TextClassificationResults &aTextResults) const
	The HTML Text Classification method. The method takes an initialized HtmlText object and returns the results in a TextClassificationResults class. More...

Member Function Documentation

classify()

FunctionResult dca::HtmlTextClassifier::classify	(	const HtmlText &	aText,
		TextClassificationResults &	aTextResults
	)		const

The HTML Text Classification method. The method takes an initialized HtmlText object and returns the results in a TextClassificationResults class.

An HtmlText object can be classified as one of the following categories:

• CATEGORY_ID_TEXT_PORNOGRAPHY
• CATEGORY_ID_TEXT_WAREZ
• CATEGORY_ID_TEXT_GAMBLING
• CATEGORY_ID_TEXT_ANONYMOUS_PROXIES
• CATEGORY_ID_TEXT_ILLEGAL_DRUGS
• CATEGORY_ID_TEXT_WEAPONS

Parameters

[in]	aText	The HTML text object to be classified
[out]	aTextResults	The results of the text classification

Returns

DCA_SUCCESS or one of the following error codes

• DCA Generic Error Codes

See also

TextClassification, Text, TextClassificationResult

---

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

• text_classifier.h