TutTimeCvtDestroy

Name

TutTimeCvtDestroy — destroy a time converter

Synopsis

T_BOOL TutTimeCvtDestroy(time_cvtr) 
T_TIME_CVT time_cvtr; 

Arguments

time_cvtr — time converter to destroy

Return Values

TRUE if the converter was successfully destroyed, FALSE if the converter is currently in use, such as the option Time_Format points to the converter.

Diagnostics

None

Description

TutTimeCvtDestroy destroys a time converter. If the time converter has a destroy function, the function is called.

Caution

None

See Also

TutTimeCvtCreate, TutTimeCvtLookup

Examples

This example tries to destroy the time converter hms:

void destroy_hms() 
{ 
  T_TIME_CVT hms = TutTimeCvtLookup("hms"); 
  if (hms != NULL) { 
    if (!TutTimeCvtDestroy(hms)) { 
      TutOut("time converter hms is in use.\n"); 
    }  
  }  
} /* destroy_hms */