Home
RecogniContact International Address Parser Help Prev Page Prev Page
Overview
Using RecogniContact
Redistributing RecogniContact
Class IContactParser
Class IParsedContact
Class IParserSettings
Sample code for C++
Sample code for Delphi
Sample code for Visual Basic


ATTENTION!
The RecogniContact/COM help has moved to to
http://address-parser.com/com_address_parser_help/
This page will go offline shortly. Please change your bookmarks.

Class IContactParser

The class IContactParser is the interface to RecogniContact's parsing engine.

Class Methods

procedure Initialize(userName, licenseKey: WideString);

Initializes the parser object with the specified license information.
IContactParser.Initialize() must have been called before you can use IContactParser.Parse()
Call IContactParser.Initialize() only once in your application.

function Parse(const sourceText: WideString): IParsedContact;

Parses the string in sourceText, and returns the parsing result as an IParsedContact object.
IContactParser.Initialize() must be called once before calling IContactParser.Parse()
The maximum length of sourceText is 8 kilobytes (8192 characters).


function CreateSettingsObject: IParserSettings;
 procedure Settings(const Settings: IParserSettings);

Allow you to retrieve the current settings, or adjust the parser settings. To change parser settings, proceed as follows:
  1. Create the settings object:
    settingsObject = IContactParser.CreateSettingsObject()
  2. Change the settings object properties as required.
  3. Activate the settings using
    IContactParser.Settings(settingsObject);

For code samples see:
function GetLicenseInfo(LicenseInfo: LicenseInfoType): WideString;

Retrieves Information about your RecogniContact license.
  • GetLicenseInfo(litUserName) returns the name of the registered license holder

  • GetLicenseInfo(litDaysLeft) returns a string containing the number of days remaining in your license
    "-1" if the license has no expiry date (permanent license)
  • "0" indicates that the license has already expired
  • "1" indicates that the license will expire today at midnight
  • "2", "3", ... indicates the number of days remaining in your license (including today)

  • GetLicenseInfo(litExpired) returns the license expiry status
    "1", if the license is expired
    "0", if the license is still valid

  • GetLicenseInfo(litParserCountries) returns a comma separated string containing the 2 letter ISO codes of all countries, for which the parser will parse address and contact information
    returns an empty string, if your license has no country restriction
    See http://www.iso.org/iso/english_country_names_and_code_elements for the complete list of ISO country codes.