Basic Operations
Functions |
TidyDoc TIDY_CALL | tidyCreate (void) |
TidyDoc TIDY_CALL | tidyCreateWithAllocator (TidyAllocator *allocator) |
void TIDY_CALL | tidyRelease (TidyDoc tdoc) |
void TIDY_CALL | tidySetAppData (TidyDoc tdoc, void *appData) |
void* TIDY_CALL | tidyGetAppData (TidyDoc tdoc) |
ctmbstr TIDY_CALL | tidyReleaseDate (void) |
int TIDY_CALL | tidyStatus (TidyDoc tdoc) |
int TIDY_CALL | tidyDetectedHtmlVersion (TidyDoc tdoc) |
Bool TIDY_CALL | tidyDetectedXhtml (TidyDoc tdoc) |
Bool TIDY_CALL | tidyDetectedGenericXml (TidyDoc tdoc) |
uint TIDY_CALL | tidyErrorCount (TidyDoc tdoc) |
uint TIDY_CALL | tidyWarningCount (TidyDoc tdoc) |
uint TIDY_CALL | tidyAccessWarningCount (TidyDoc tdoc) |
uint TIDY_CALL | tidyConfigErrorCount (TidyDoc tdoc) |
int TIDY_CALL | tidyLoadConfig (TidyDoc tdoc, ctmbstr configFile) |
int TIDY_CALL | tidyLoadConfigEnc (TidyDoc tdoc, ctmbstr configFile, ctmbstr charenc) |
Bool TIDY_CALL | tidyFileExists (TidyDoc tdoc, ctmbstr filename) |
int TIDY_CALL | tidySetCharEncoding (TidyDoc tdoc, ctmbstr encnam) |
int TIDY_CALL | tidySetInCharEncoding (TidyDoc tdoc, ctmbstr encnam) |
int TIDY_CALL | tidySetOutCharEncoding (TidyDoc tdoc, ctmbstr encnam) |
int TIDY_CALL | tidyOptSaveFile (TidyDoc tdoc, ctmbstr cfgfil) |
int TIDY_CALL | tidyOptSaveSink (TidyDoc tdoc, TidyOutputSink *sink) |
void TIDY_CALL | tidyErrorSummary (TidyDoc tdoc) |
void TIDY_CALL | tidyGeneralInfo (TidyDoc tdoc) |
Detailed Description
Tidy public interface
Several functions return an integer document status:
0 -> SUCCESS
>0 -> 1 == TIDY WARNING, 2 == TIDY ERROR
<0 -> SEVERE ERROR
The following is a short example program.
include <tidy.h>
include <buffio.h>
include <stdio.h>
include <errno.h>
int main(int argc, char **argv )
{
const char* input = "<title>Foo</title><p>Foo!";
TidyBuffer output;
TidyBuffer errbuf;
int rc = -1;
Bool ok;
TidyDoc tdoc = tidyCreate(); // Initialize "document"
tidyBufInit( &output );
tidyBufInit( &errbuf );
printf( "Tidying:\t%s\n", input );
ok = tidyOptSetBool( tdoc, TidyXhtmlOut, yes ); // Convert to XHTML
if ( ok )
rc = tidySetErrorBuffer( tdoc, &errbuf ); // Capture diagnostics
if ( rc >= 0 )
rc = tidyParseString( tdoc, input ); // Parse the input
if ( rc >= 0 )
rc = tidyCleanAndRepair( tdoc ); // Tidy it up!
if ( rc >= 0 )
rc = tidyRunDiagnostics( tdoc ); // Kvetch
if ( rc > 1 ) // If error, force output.
rc = ( tidyOptSetBool(tdoc, TidyForceOutput, yes) ? rc : -1 );
if ( rc >= 0 )
rc = tidySaveBuffer( tdoc, &output ); // Pretty Print
if ( rc >= 0 )
{
if ( rc > 0 )
printf( "\nDiagnostics:\n\n%s", errbuf.bp );
printf( "\nAnd here is the result:\n\n%s", output.bp );
}
else
printf( "A severe error (%d) occurred.\\n", rc );
tidyBufFree( &output );
tidyBufFree( &errbuf );
tidyRelease( tdoc );
return rc;
}
Function Documentation
void TIDY_CALL tidySetAppData (
|
TidyDoc tdoc,
|
|
void * appData )
|
|
|
Let application store a chunk of data w/ each Tidy instance. Useful for callbacks. |
void *TIDY_CALL tidyGetAppData (
|
TidyDoc tdoc )
|
|
|
Get application data set previously |
ctmbstr TIDY_CALL tidyReleaseDate (
|
void )
|
|
|
Get release date (version) for current library |
int TIDY_CALL tidyStatus (
|
TidyDoc tdoc )
|
|
|
Get status of current document. |
int TIDY_CALL tidyDetectedHtmlVersion (
|
TidyDoc tdoc )
|
|
|
Detected HTML version: 0, 2, 3 or 4 |
Bool TIDY_CALL tidyDetectedXhtml (
|
TidyDoc tdoc )
|
|
Bool TIDY_CALL tidyDetectedGenericXml (
|
TidyDoc tdoc )
|
|
|
Input is generic XML (not HTML or XHTML)? |
uint TIDY_CALL tidyErrorCount (
|
TidyDoc tdoc )
|
|
|
Number of Tidy errors encountered. If > 0, output is suppressed unless TidyForceOutput is set. |
uint TIDY_CALL tidyWarningCount (
|
TidyDoc tdoc )
|
|
|
Number of Tidy warnings encountered. |
uint TIDY_CALL tidyAccessWarningCount (
|
TidyDoc tdoc )
|
|
|
Number of Tidy accessibility warnings encountered. |
uint TIDY_CALL tidyConfigErrorCount (
|
TidyDoc tdoc )
|
|
|
Number of Tidy configuration errors encountered. |
int TIDY_CALL tidyLoadConfig (
|
TidyDoc tdoc,
|
|
ctmbstr configFile )
|
|
|
Load an ASCII Tidy configuration file |
int TIDY_CALL tidyLoadConfigEnc (
|
TidyDoc tdoc,
|
|
ctmbstr configFile,
|
|
ctmbstr charenc )
|
|
|
Load a Tidy configuration file with the specified character encoding |
int TIDY_CALL tidySetCharEncoding (
|
TidyDoc tdoc,
|
|
ctmbstr encnam )
|
|
|
Set the input/output character encoding for parsing markup. Values include: ascii, latin1, raw, utf8, iso2022, mac, win1252, utf16le, utf16be, utf16, big5 and shiftjis. Case in-sensitive. |
int TIDY_CALL tidySetInCharEncoding (
|
TidyDoc tdoc,
|
|
ctmbstr encnam )
|
|
|
Set the input encoding for parsing markup. As for tidySetCharEncoding but only affects the input encoding |
int TIDY_CALL tidySetOutCharEncoding (
|
TidyDoc tdoc,
|
|
ctmbstr encnam )
|
|
int TIDY_CALL tidyOptSaveFile (
|
TidyDoc tdoc,
|
|
ctmbstr cfgfil )
|
|
|
Save current settings to named file. Only non-default values are written. |
|
Save current settings to given output sink. Only non-default values are written. |
void TIDY_CALL tidyErrorSummary (
|
TidyDoc tdoc )
|
|
|
Write more complete information about errors to current error sink. |
void TIDY_CALL tidyGeneralInfo (
|
TidyDoc tdoc )
|
|
|
Write more general information about markup to current error sink. |
Generated at Thu Sep 23 15:57:28 2010 for HTML Tidy by
1.2.8.1 written by Dimitri van Heesch,
© 1997-2001