X-Git-Url: http://git.silcnet.org/gitweb/?a=blobdiff_plain;f=lib%2Fsilcutil%2Fsilctime.h;h=e01e1ae701f92660debb212b10dae7a6195f7b86;hb=e7b6c157b80152bf9fb9266e6bdd93f9fb0db776;hp=17912fe3b365aed4c257458ebb09c129400e4497;hpb=0b7b11022f365d8aa41c07f3b62197ed5c873d4e;p=silc.git diff --git a/lib/silcutil/silctime.h b/lib/silcutil/silctime.h index 17912fe3..e01e1ae7 100644 --- a/lib/silcutil/silctime.h +++ b/lib/silcutil/silctime.h @@ -44,7 +44,7 @@ * SOURCE * ***/ -typedef struct { +typedef struct SilcTimeObject { unsigned int year : 15; /* Year, 0 - 32768 */ unsigned int month : 4; /* Month, 1 - 12 */ unsigned int day : 5; /* Day, 1 - 31 */ @@ -134,6 +134,25 @@ const char *silc_time_string(SilcInt64 time_val_sec); ***/ SilcBool silc_time_value(SilcInt64 time_val_msec, SilcTime ret_time); +/****f* silcutil/SilcTimeAPI/silc_timezone + * + * SYNOPSIS + * + * SilcBool silc_timezone(char *timezone, SilcUInt32 timezone_size); + * + * DESCRIPTION + * + * Returns current timezone in Universal time format into the `timezone' + * buffer of size of `timezone_size'. The possible values this function + * returns are: Z (For UTC timezone), +hh (UTC + hours) -hh (UTC - hours), + * +hh:mm (UTC + hours:minutes) or -hh:mm (UTC - hours:minutes). The + * returned values are always offsets to UTC. + * + * Returns FALSE on error, TRUE otherwise. + * + ***/ +SilcBool silc_timezone(char *timezone, SilcUInt32 timezone_size); + /****f* silcutil/SilcTimeAPI/silc_time_universal * * SYNOPSIS @@ -228,17 +247,16 @@ SilcBool silc_time_generalized_string(SilcTime time_val, char *ret_string, * * SYNOPSIS * - * SilcBool silc_compare_timeval(struct time_val *smaller, - * struct time_val *bigger) + * int silc_compare_timeval(struct time_val *t1, struct time_val *t2); * * DESCRIPTION * - * Compare two timeval structures and return TRUE if the first - * time value is smaller than the second time value. + * Compares `t1' and `t2' time structures and returns less than zero, + * zero or more than zero when `t1' is smaller, equal or bigger than + * `t2', respectively. * ***/ -SilcBool silc_compare_timeval(struct timeval *smaller, - struct timeval *bigger); +int silc_compare_timeval(struct timeval *t1, struct timeval *t2); /****f* silcutil/SilcTimeAPI/silc_gettimeofday * @@ -258,7 +276,7 @@ int silc_gettimeofday(struct timeval *p); * * SYNOPSIS * - * void silc_usleep(long microseconds); + * void silc_usleep(unsigned long microseconds); * * DESCRIPTION * @@ -272,7 +290,7 @@ int silc_gettimeofday(struct timeval *p); * ***/ static inline -void silc_usleep(long microseconds) +void silc_usleep(unsigned long microseconds) { #ifdef SILC_UNIX #ifdef HAVE_NANOSLEEP @@ -293,7 +311,7 @@ void silc_usleep(long microseconds) Sleep(microseconds / 1000); #endif /* SILC_WIN32 */ #ifdef SILC_SYMBIAN - User::After(microseconds / 1000); + silc_symbian_usleep(microseconds); #endif /* SILC_SYMBIAN */ }