time

TIME(3am)                  GNU Awk Extension Modules                 TIME(3am)

NAME
       time - time functions for gawk

SYNOPSIS
       @load "time"

       time = gettimeofday()
       ret = sleep(amount)

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  ER-
              RNO.  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(3am),   fnmatch(3am),
       fork(3am),   inplace(3am),  ordchr(3am),  readdir(3am),  readfile(3am),
       revoutput(3am), rwarray(3am).

       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          Feb 02 2018                        TIME(3am)