Before Programming with Chilkat
This page provides some basic information that is good to know before you begin programming with Chilkat's API's.
C++ Memory Leaks?
Making sure there are NO memory leaks is extremely important to Chilkat.
Many programmers mistakenly think memory leaks exist when it is actually not the case.
Success/Failure Return Values
.NET and Visual C++ methods that return status information will return true for success, and false for failure.
ActiveX methods that return status information will return 1 for success, and 0 for failure.
If an method returns a reference to an object, a failure is indicated by returning a NULL reference.
Retrieving Error Information
When a method fails, extended error information can be retrieved as XML, HTML, or plain-text. The LastErrorHtml, LastErrorText, and LastErrorXml properties contain this information. These properties should be examined when a failure status is returned. The last error information can also be saved to an XML formatted file by calling SaveLastError. Note: the LastErrorHtml, LastErrorText, and LastErrorXml properties will contain information even in the case of success.
Chilkat's non-free components are unlocked at runtime by calling the UnlockComponent method once at the beginning of a program. The full-versions of all Chilkat components and libraries are publicly available at http:/www.chilkatsoft.com/downloads.asp.
Fully-functional Chilkat components can be tested for 30-days by passing an arbitrary string to UnlockComponent.
Chilkat component and library methods never raise exceptions. If a method fails, it returns a status (true/false or 1/0) and the last-error information is available in LastErrorText, LastErrorXml, LastErrorHtml, or via SaveLastError. A returned NULL object reference also indicates failure.