| 
 
 | 
 | 
Psion time related utility class.
PsiTime provides easy access to the time format, used when communicating with a Psion. Internally, the time is always normalized to GMT. The time value can be set and retrieved in both Unix and Psion formats. This allows easy conversion between both formats. NOTE: For proper conversion, the current timezone of the Psion has to be set. For EPOC devices, the timezone can be evaluated using rpcs::getMachineInfo . For SIBO devices, unfortunately there is no known method of retrieving this information. Therefore, if the timezone is not set, a fallback using the environment variable PSI_TZ is provided. Users should set this variable to the offset of their time zone in seconds. If PSI_TZ is net set, a second fallback uses the local machine's setup, which assumes that both Psion and local machine have the same time zone and daylight settings.
| PsiTime (struct timeval *_utv, struct timezone *_utz = 0L) | PsiTime | 
Contructs a new instance.
Parameters:
| _utv | A Unix time value for initialization. | 
| _utz | A Unix timezone for initialization. | 
| PsiTime (time_t time) | PsiTime | 
Contructs a new instance.
Parameters:
| time | A Unix time value for initialization. | 
| PsiTime (psi_timeval *_ptv, psi_timezone *_ptz = 0L) | PsiTime | 
Contructs a new instance.
Parameters:
| _ptv | A Psion time value for initialization. | 
| _ptz | A Psion timezone for initialization. | 
| PsiTime (const u_int32_t _ptvHi, const u_int32_t _ptvLo) | PsiTime | 
Contructs a new instance.
Parameters:
| _ptvHi | The high 32 bits of a Psion time value for initialization. | 
| _ptvLo | The low 32 bits of a Psion time value for initialization. | 
| PsiTime (void) | PsiTime | 
Constructs a new instance, initializing to now.
| PsiTime (const PsiTime &t) | PsiTime | 
A copy-constructor
| ~PsiTime () | ~PsiTime | 
Destroys the instance.
| void  setPsiTime (psi_timeval *_ptv) | setPsiTime | 
Modifies the value of this instance.
Parameters:
| _ptv | The new Psion time representation. | 
| void  setSiboTime (u_int32_t stime) | setSiboTime | 
Modifies the value of this instance.
Parameters:
| stime | The new SIBO time representation. | 
| void  setPsiTime (const u_int32_t _ptvHi, const u_int32_t _ptvLo) | setPsiTime | 
Modifies the value of this instance.
Parameters:
| _ptvHi | The high 32 bits of a Psion time. | 
| _ptvLo | The low 32 bits of a Psion time. | 
| void  setPsiZone (psi_timezone *_ptz) | setPsiZone | 
Sets the Psion time zone of this instance.
Parameters:
| _ptz | The new Psion time zone. | 
| void  setUnixTime (struct timeval *_utv) | setUnixTime | 
Sets the value of this instance.
Parameters:
| _utv | The new Unix time representation. | 
| void  setUnixTime (time_t time) | setUnixTime | 
Sets the value of this instance.
Parameters:
| _utv | The new Unix time representation. | 
| void  setUnixNow (void) | setUnixNow | 
Sets the value of this instance to the current time of the Unix machine.
| struct timeval & getTimeval (void) | getTimeval | 
Retrieves the instance's current value in Unix time format.
Returns: The instance's current time as Unix struct timeval.
| time_t  getTime (void) | getTime | 
Retrieves the instance's current value in Unix time format.
Returns: The instance's current time as Unix time_t.
| u_int32_t  getSiboTime () | getSiboTime | 
Retrieves the instance's current value in SIBO time format.
Returns: The instance's current time as SIBO time.
| psi_timeval & getPsiTimeval (void) | getPsiTimeval | 
Retrieves the instance's current value in Psion time format.
Returns: The instance's current time a Psion struct psi_timeval_t.
| const u_int32_t  getPsiTimeLo (void) | getPsiTimeLo | 
Retrieves the instance's current value in Psion time format, high 32 bits.
Returns: The instance's current time as lower 32 bits of a Psion struct psi_timeval_t.
| const u_int32_t  getPsiTimeHi (void) | getPsiTimeHi | 
Retrieves the instance's current value in Psion time format, low 32 bits.
Returns: The instance's current time as upper 32 bits of a Psion struct psi_timeval_t.
| friend std::ostream & operator<< (std::ostream &s, const PsiTime &t) | operator<< | 
Prints the instance's value in human readable format. This function uses the current locale setting for formatting the time.
Parameters:
| s | The stream to be written. | 
| t | The instance whose value should be displayed. | 
Returns: The stream.
| PsiTime & operator= (const PsiTime &t) | operator= | 
Assignment operator
| bool  operator== (const PsiTime &t) | operator== | 
Comparison operators
| bool  operator< (const PsiTime &t) | operator< | 
| bool  operator> (const PsiTime &t) | operator> | 
| enum zone { PSI_TZ_NONE = 0, PSI_TZ_EUROPEAN = 1, PSI_TZ_NORTHERN = 2, PSI_TZ_SOUTHERN = 4, PSI_TZ_HOME = 0x40000000 } | zone |