ftime man page on YellowDog

Man page or keyword search:  
man Server   18644 pages
apropos Keyword Search (all sections)
Output format
YellowDog logo
[printable version]

FTIME(P)		   POSIX Programmer's Manual		      FTIME(P)

NAME
       ftime - get date and time (LEGACY)

SYNOPSIS
       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

DESCRIPTION
       The  ftime()  function  shall  set  the time and millitm members of the
       timeb structure pointed to by tp to contain the seconds	and  millisec‐
       onds  portions,	respectively, of the current time in seconds since the
       Epoch. The contents of the timezone and dstflag members of tp  after  a
       call to ftime() are unspecified.

       The  system  clock  need not have millisecond granularity. Depending on
       any granularity (particularly a granularity of one) renders  code  non-
       portable.

RETURN VALUE
       Upon successful completion, the ftime() function shall return 0; other‐
       wise, -1 shall be returned.

ERRORS
       No errors are defined.

       The following sections are informative.

EXAMPLES
   Getting the Current Time and Date
       The following example shows how to get the current system  time	values
       using  the  ftime()  function.  The timeb structure pointed to by tp is
       filled with the current system time values for time and millitm.

	      #include <sys/timeb.h>

	      struct timeb tp;
	      int	   status;
	      ...
	      status = ftime(&tp);

APPLICATION USAGE
       For applications portability, the time() function  should  be  used  to
       determine  the  current	time instead of ftime(). Realtime applications
       should use clock_gettime() to determine the  current  time  instead  of
       ftime().

RATIONALE
       None.

FUTURE DIRECTIONS
       This function may be withdrawn in a future version.

SEE ALSO
       clock_getres()  ,  ctime() , gettimeofday() , time() , the Base Defini‐
       tions volume of IEEE Std 1003.1-2001, <sys/timeb.h>

COPYRIGHT
       Portions of this text are reprinted and reproduced in  electronic  form
       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
       -- Portable Operating System Interface (POSIX),	The  Open  Group  Base
       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
       event of any discrepancy between this version and the original IEEE and
       The Open Group Standard, the original IEEE and The Open Group  Standard
       is  the	referee document. The original Standard can be obtained online
       at http://www.opengroup.org/unix/online.html .

IEEE/The Open Group		     2003			      FTIME(P)
[top]

List of man pages available for YellowDog

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net