HTML Tidy  5.4.0
The HTACG Tidy HTML Project
Configuration Options

Functions for getting and setting Tidy configuration options. More...

Typedefs

typedef Bool(TIDY_CALLTidyOptCallback) (ctmbstr option, ctmbstr value)
 Applications using TidyLib may want to augment command-line and configuration file options. More...
 

Functions

TidyOption TIDY_CALL tidyGetNextOption (TidyDoc tdoc, TidyIterator *pos)
 Get next Option. More...
 
TidyOption TIDY_CALL tidyGetOption (TidyDoc tdoc, TidyOptionId optId)
 Lookup option by ID. More...
 
TidyOption TIDY_CALL tidyGetOptionByName (TidyDoc tdoc, ctmbstr optnam)
 Lookup option by name. More...
 
TidyIterator TIDY_CALL tidyGetOptionList (TidyDoc tdoc)
 Get iterator for list of option. More...
 
Bool TIDY_CALL tidyOptCopyConfig (TidyDoc tdocTo, TidyDoc tdocFrom)
 Copy current configuration settings from one document to another. More...
 
Bool TIDY_CALL tidyOptDiffThanDefault (TidyDoc tdoc)
 Any settings different than default? More...
 
Bool TIDY_CALL tidyOptDiffThanSnapshot (TidyDoc tdoc)
 Any settings different than snapshot? More...
 
Bool TIDY_CALL tidyOptGetBool (TidyDoc tdoc, TidyOptionId optId)
 Get current Option value as a Boolean flag. More...
 
TidyConfigCategory TIDY_CALL tidyOptGetCategory (TidyOption opt)
 Get category of given Option. More...
 
ctmbstr TIDY_CALL tidyOptGetCurrPick (TidyDoc tdoc, TidyOptionId optId)
 Get current pick list value for option by ID. More...
 
TidyIterator TIDY_CALL tidyOptGetDeclTagList (TidyDoc tdoc)
 Iterate over user declared tags. More...
 
ctmbstr TIDY_CALL tidyOptGetDefault (TidyOption opt)
 Get default value of given Option as a string. More...
 
Bool TIDY_CALL tidyOptGetDefaultBool (TidyOption opt)
 Get default value of given Option as a Boolean value. More...
 
ulong TIDY_CALL tidyOptGetDefaultInt (TidyOption opt)
 Get default value of given Option as an unsigned integer. More...
 
ctmbstr TIDY_CALL tidyOptGetDoc (TidyDoc tdoc, TidyOption opt)
 Get option description. More...
 
TidyIterator TIDY_CALL tidyOptGetDocLinksList (TidyDoc tdoc, TidyOption opt)
 Iterate over a list of related options. More...
 
ctmbstr TIDY_CALL tidyOptGetEncName (TidyDoc tdoc, TidyOptionId optId)
 Get character encoding name. More...
 
TidyOptionId TIDY_CALL tidyOptGetId (TidyOption opt)
 Get ID of given Option. More...
 
TidyOptionId TIDY_CALL tidyOptGetIdForName (ctmbstr optnam)
 Get option ID by name. More...
 
ulong TIDY_CALL tidyOptGetInt (TidyDoc tdoc, TidyOptionId optId)
 Get current Option value as an integer. More...
 
ctmbstr TIDY_CALL tidyOptGetName (TidyOption opt)
 Get name of given Option. More...
 
ctmbstr TIDY_CALL tidyOptGetNextDeclTag (TidyDoc tdoc, TidyOptionId optId, TidyIterator *iter)
 Get next declared tag of specified type: TidyInlineTags, TidyBlockTags, TidyEmptyTags, TidyPreTags. More...
 
TidyOption TIDY_CALL tidyOptGetNextDocLinks (TidyDoc tdoc, TidyIterator *pos)
 Get next related option. More...
 
ctmbstr TIDY_CALL tidyOptGetNextPick (TidyOption opt, TidyIterator *pos)
 Get next string value of Option "pick list". More...
 
TidyIterator TIDY_CALL tidyOptGetPickList (TidyOption opt)
 Iterate over Option "pick list". More...
 
TidyOptionType TIDY_CALL tidyOptGetType (TidyOption opt)
 Get datatype of given Option. More...
 
ctmbstr TIDY_CALL tidyOptGetValue (TidyDoc tdoc, TidyOptionId optId)
 Get string Option current value. More...
 
Bool TIDY_CALL tidyOptIsReadOnly (TidyOption opt)
 Is Option read-only? More...
 
Bool TIDY_CALL tidyOptParseValue (TidyDoc tdoc, ctmbstr optnam, ctmbstr val)
 Set named Option value as a string. More...
 
Bool TIDY_CALL tidyOptResetAllToDefault (TidyDoc tdoc)
 Reset all options to their default values. More...
 
Bool TIDY_CALL tidyOptResetToDefault (TidyDoc tdoc, TidyOptionId opt)
 Reset option to default value by ID. More...
 
Bool TIDY_CALL tidyOptResetToSnapshot (TidyDoc tdoc)
 Reset config settings to snapshot (after document processing) More...
 
Bool TIDY_CALL tidyOptSetBool (TidyDoc tdoc, TidyOptionId optId, Bool val)
 Set Option value as a Boolean flag. More...
 
Bool TIDY_CALL tidyOptSetInt (TidyDoc tdoc, TidyOptionId optId, ulong val)
 Set Option value as an integer. More...
 
Bool TIDY_CALL tidyOptSetValue (TidyDoc tdoc, TidyOptionId optId, ctmbstr val)
 Set Option value as a string. More...
 
Bool TIDY_CALL tidyOptSnapshot (TidyDoc tdoc)
 Take a snapshot of current config settings. More...
 
Bool TIDY_CALL tidySetOptionCallback (TidyDoc tdoc, TidyOptCallback pOptCallback)
 

Detailed Description

Functions for getting and setting Tidy configuration options.

Typedef Documentation

typedef Bool(TIDY_CALL * TidyOptCallback) (ctmbstr option, ctmbstr value)

Applications using TidyLib may want to augment command-line and configuration file options.

Setting this callback allows an application developer to examine command-line and configuration file options after TidyLib has examined them and failed to recognize them.

Definition at line 421 of file tidy.h.

Function Documentation

TidyOption TIDY_CALL tidyGetNextOption ( TidyDoc  tdoc,
TidyIterator *  pos 
)

Get next Option.

TidyOption TIDY_CALL tidyGetOption ( TidyDoc  tdoc,
TidyOptionId  optId 
)

Lookup option by ID.

TidyOption TIDY_CALL tidyGetOptionByName ( TidyDoc  tdoc,
ctmbstr  optnam 
)

Lookup option by name.

TidyIterator TIDY_CALL tidyGetOptionList ( TidyDoc  tdoc)

Get iterator for list of option.

Example:

TidyIterator itOpt = tidyGetOptionList( tdoc );
while ( itOpt )
{
  TidyOption opt = tidyGetNextOption( tdoc, &itOpt );
  .. get/set option values ..
}
Bool TIDY_CALL tidyOptCopyConfig ( TidyDoc  tdocTo,
TidyDoc  tdocFrom 
)

Copy current configuration settings from one document to another.

Bool TIDY_CALL tidyOptDiffThanDefault ( TidyDoc  tdoc)

Any settings different than default?

Bool TIDY_CALL tidyOptDiffThanSnapshot ( TidyDoc  tdoc)

Any settings different than snapshot?

Bool TIDY_CALL tidyOptGetBool ( TidyDoc  tdoc,
TidyOptionId  optId 
)

Get current Option value as a Boolean flag.

TidyConfigCategory TIDY_CALL tidyOptGetCategory ( TidyOption  opt)

Get category of given Option.

ctmbstr TIDY_CALL tidyOptGetCurrPick ( TidyDoc  tdoc,
TidyOptionId  optId 
)

Get current pick list value for option by ID.

Useful for enum types.

TidyIterator TIDY_CALL tidyOptGetDeclTagList ( TidyDoc  tdoc)

Iterate over user declared tags.

ctmbstr TIDY_CALL tidyOptGetDefault ( TidyOption  opt)

Get default value of given Option as a string.

Bool TIDY_CALL tidyOptGetDefaultBool ( TidyOption  opt)

Get default value of given Option as a Boolean value.

ulong TIDY_CALL tidyOptGetDefaultInt ( TidyOption  opt)

Get default value of given Option as an unsigned integer.

ctmbstr TIDY_CALL tidyOptGetDoc ( TidyDoc  tdoc,
TidyOption  opt 
)

Get option description.

TidyIterator TIDY_CALL tidyOptGetDocLinksList ( TidyDoc  tdoc,
TidyOption  opt 
)

Iterate over a list of related options.

ctmbstr TIDY_CALL tidyOptGetEncName ( TidyDoc  tdoc,
TidyOptionId  optId 
)

Get character encoding name.

Used with TidyCharEncoding, TidyOutCharEncoding, TidyInCharEncoding

TidyOptionId TIDY_CALL tidyOptGetId ( TidyOption  opt)

Get ID of given Option.

TidyOptionId TIDY_CALL tidyOptGetIdForName ( ctmbstr  optnam)

Get option ID by name.

ulong TIDY_CALL tidyOptGetInt ( TidyDoc  tdoc,
TidyOptionId  optId 
)

Get current Option value as an integer.

ctmbstr TIDY_CALL tidyOptGetName ( TidyOption  opt)

Get name of given Option.

ctmbstr TIDY_CALL tidyOptGetNextDeclTag ( TidyDoc  tdoc,
TidyOptionId  optId,
TidyIterator *  iter 
)

Get next declared tag of specified type: TidyInlineTags, TidyBlockTags, TidyEmptyTags, TidyPreTags.

TidyOption TIDY_CALL tidyOptGetNextDocLinks ( TidyDoc  tdoc,
TidyIterator *  pos 
)

Get next related option.

ctmbstr TIDY_CALL tidyOptGetNextPick ( TidyOption  opt,
TidyIterator *  pos 
)

Get next string value of Option "pick list".

TidyIterator TIDY_CALL tidyOptGetPickList ( TidyOption  opt)

Iterate over Option "pick list".

TidyOptionType TIDY_CALL tidyOptGetType ( TidyOption  opt)

Get datatype of given Option.

ctmbstr TIDY_CALL tidyOptGetValue ( TidyDoc  tdoc,
TidyOptionId  optId 
)

Get string Option current value.

Note, the optID "must" be a type 'TidyString'!

Bool TIDY_CALL tidyOptIsReadOnly ( TidyOption  opt)

Is Option read-only?

Bool TIDY_CALL tidyOptParseValue ( TidyDoc  tdoc,
ctmbstr  optnam,
ctmbstr  val 
)

Set named Option value as a string.

Good if not sure of type.

Bool TIDY_CALL tidyOptResetAllToDefault ( TidyDoc  tdoc)

Reset all options to their default values.

Bool TIDY_CALL tidyOptResetToDefault ( TidyDoc  tdoc,
TidyOptionId  opt 
)

Reset option to default value by ID.

Bool TIDY_CALL tidyOptResetToSnapshot ( TidyDoc  tdoc)

Reset config settings to snapshot (after document processing)

Bool TIDY_CALL tidyOptSetBool ( TidyDoc  tdoc,
TidyOptionId  optId,
Bool  val 
)

Set Option value as a Boolean flag.

Bool TIDY_CALL tidyOptSetInt ( TidyDoc  tdoc,
TidyOptionId  optId,
ulong  val 
)

Set Option value as an integer.

Bool TIDY_CALL tidyOptSetValue ( TidyDoc  tdoc,
TidyOptionId  optId,
ctmbstr  val 
)

Set Option value as a string.

Bool TIDY_CALL tidyOptSnapshot ( TidyDoc  tdoc)

Take a snapshot of current config settings.

Bool TIDY_CALL tidySetOptionCallback ( TidyDoc  tdoc,
TidyOptCallback  pOptCallback 
)