c_cpp/etc/calc/help/sleep

   1 NAME
   2     sleep - suspend operation for a specified time
   3
   4 SYNOPSIS
   5     sleep([n])
   6
   7 TYPES
   8     n           non-negative real, defaults to 1
   9
  10     return      integer or null value
  11
  12 DESCRIPTION
  13     This uses the C-library sleep (if n is integral) or usleep (for
  14     non-integral n) to suspend operation for n seconds.  If n is an
  15     integer and the sleep is stopped by an interruption, the number
  16     of seconds remaining is returned.
  17
  18     One kind of use is to slow down output to permit easier reading of
  19     results, as in:
  20
  21         ; for (i = 0; i < 100; i++) {
  22         ;;      print sqrt(i);
  23         ;;      sleep(1/2);
  24         ;; }
  25
  26     The following illustrates what happens if ctrl-C is hit 5 seconds
  27     after the first command:
  28
  29         ; print sleep(20)
  30
  31         [Abort level 1]
  32         15
  33
  34 EXAMPLE
  35     ; sleep(1/3);
  36     ; sleep(20);
  37
  38 LIBRARY
  39     none
  40
  41 SEE ALSO
  42     none
  43
  44 ## Copyright (C) 2000-2006  Ernest Bowen
  45 ##
  46 ## Calc is open software; you can redistribute it and/or modify it under
  47 ## the terms of the version 2.1 of the GNU Lesser General Public License
  48 ## as published by the Free Software Foundation.
  49 ##
  50 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  51 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  52 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  53 ## Public License for more details.
  54 ##
  55 ## A copy of version 2.1 of the GNU Lesser General Public License is
  56 ## distributed with calc under the filename COPYING-LGPL.  You should have
  57 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  58 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  59 ##
  60 ## @(#) $Revision: 30.1 $
  61 ## @(#) $Id: sleep,v 30.1 2007/03/16 11:10:42 chongo Exp $
  62 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/sleep,v $
  63 ##
  64 ## Under source code control:   2000/12/14 01:33:00
  65 ## File existed as early as:    2000
  66 ##
  67 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/