TutTimeCvtLookup

Name

TutTimeCvtLookup — look up a time converter by name

Synopsis

T_TIME_CVT TutTimeCvtLookup(name) 
T_STR name; 

Arguments

name — name of time converter (not case sensitive)

Return Values

Pointer to the specified time converter, NULL otherwise.

Diagnostics

None

Description

TutTimeCvtLookup returns a pointer to a time converter.

Caution

SmartSockets time converter names are not case sensitive (FULL, full, and Full can all be used to look up the same time converter).

See Also

TutTimeCvtCreate, TutTimeCvtDestroy

Examples

This example looks up the time converter hms, gets the current wall clock time, and then converts the time to a string using the hms converter:

T_TIME_CVT time_cvtr; 
T_REAL8 wall_time; 
 
wall_time = TutGetWallTime(); 
TutOut("Raw wall clock time is %f.\n", wall_time); 
time_cvtr = TutTimeCvtLookup("hms"); 
if (time_cvtr != NULL) { 
  T_STR *time_str; 
  if (TutTimeCvtNumToStr(time_cvtr, wall_time, time_str)) { 
    TutOut("Formatted wall clock time is %s\n", *time_str); 
  }  
}