manpagez: man pages & more
man time(3)
Home | html | info | man
TIME(3am)                  GNU Awk Extension Modules                 TIME(3am)




NAME

       time - time functions for gawk


SYNOPSIS

       @load "time"

       time = gettimeofday()
       ret = sleep(amount)


CAUTION

       This  extension  is  deprecated  in favor of the timex extension in the
       gawkextlib project.  In the next major release of gawk, loading it will
       issue  a warning.  It will be removed from the gawk distribution in the
       major release after the next one.


DESCRIPTION

       The time extension adds two functions named gettimeofday() and sleep(),
       as follows.

       gettimeofday()
              This function returns the number of seconds since the Epoch as a
              floating-point value. It should have  subsecond  precision.   It
              returns -1 upon error and sets ERRNO to indicate the problem.

       sleep(seconds)
              This function attempts to sleep for the given amount of seconds,
              which may include a fractional portion.  If seconds is negative,
              or  the  attempt  to  sleep  fails,  then it returns -1 and sets
              ERRNO.  Otherwise, the function should return 0  after  sleeping
              for the indicated amount of time.


EXAMPLE

       @load "time"
       ...
       printf "It is now %g seconds since the Epoch\n", gettimeofday()
       printf "Pausing for a while... " ; sleep(2.5) ; print "done"


SEE ALSO

       GAWK:  Effective   AWK   Programming,   filefuncs(3),   fnmatch(3),
       fork(3),   inplace(3),  ordchr(3),  readdir(3),  readfile(3),
       revoutput(3), rwarray(3).

       gettimeofday(2), nanosleep(2), select(2).


AUTHOR

       Arnold Robbins, arnold@skeeve.com.


COPYING PERMISSIONS

       Copyright (C) 2012, 2013, 2018, Free Software Foundation, Inc.

       Permission  is  granted  to make and distribute verbatim copies of this
       manual page provided the copyright notice and  this  permission  notice
       are preserved on all copies.

       Permission  is granted to copy and distribute modified versions of this
       manual page under the conditions for verbatim  copying,  provided  that
       the  entire  resulting derived work is distributed under the terms of a
       permission notice identical to this one.

       Permission is granted to copy and distribute translations of this  man-
       ual page into another language, under the above conditions for modified
       versions, except that this permission notice may be stated in a  trans-
       lation approved by the Foundation.



Free Software Foundation          Nov 21 2019                        TIME(3am)

gawk 5.1.0 - Generated Fri Apr 17 20:12:12 CDT 2020
© manpagez.com 2000-2022
Individual documents may contain additional copyright information.