ALARM.html 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1999-2017 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this document
  5. under the terms of the GNU Free Documentation License, Version 1.3 or
  6. any later version published by the Free Software Foundation; with the
  7. Invariant Sections being "Funding Free Software", the Front-Cover
  8. Texts being (a) (see below), and with the Back-Cover Texts being (b)
  9. (see below). A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  11. (a) The FSF's Front-Cover Text is:
  12. A GNU Manual
  13. (b) The FSF's Back-Cover Text is:
  14. You have freedom to copy and modify this GNU Manual, like GNU
  15. software. Copies published by the Free Software Foundation raise
  16. funds for GNU development. -->
  17. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  18. <head>
  19. <title>The GNU Fortran Compiler: ALARM</title>
  20. <meta name="description" content="The GNU Fortran Compiler: ALARM">
  21. <meta name="keywords" content="The GNU Fortran Compiler: ALARM">
  22. <meta name="resource-type" content="document">
  23. <meta name="distribution" content="global">
  24. <meta name="Generator" content="makeinfo">
  25. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  26. <link href="index.html#Top" rel="start" title="Top">
  27. <link href="Option-Index.html#Option-Index" rel="index" title="Option Index">
  28. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  29. <link href="Intrinsic-Procedures.html#Intrinsic-Procedures" rel="up" title="Intrinsic Procedures">
  30. <link href="ALL.html#ALL" rel="next" title="ALL">
  31. <link href="AINT.html#AINT" rel="prev" title="AINT">
  32. <style type="text/css">
  33. <!--
  34. a.summary-letter {text-decoration: none}
  35. blockquote.smallquotation {font-size: smaller}
  36. div.display {margin-left: 3.2em}
  37. div.example {margin-left: 3.2em}
  38. div.indentedblock {margin-left: 3.2em}
  39. div.lisp {margin-left: 3.2em}
  40. div.smalldisplay {margin-left: 3.2em}
  41. div.smallexample {margin-left: 3.2em}
  42. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  43. div.smalllisp {margin-left: 3.2em}
  44. kbd {font-style:oblique}
  45. pre.display {font-family: inherit}
  46. pre.format {font-family: inherit}
  47. pre.menu-comment {font-family: serif}
  48. pre.menu-preformatted {font-family: serif}
  49. pre.smalldisplay {font-family: inherit; font-size: smaller}
  50. pre.smallexample {font-size: smaller}
  51. pre.smallformat {font-family: inherit; font-size: smaller}
  52. pre.smalllisp {font-size: smaller}
  53. span.nocodebreak {white-space:nowrap}
  54. span.nolinebreak {white-space:nowrap}
  55. span.roman {font-family:serif; font-weight:normal}
  56. span.sansserif {font-family:sans-serif; font-weight:normal}
  57. ul.no-bullet {list-style: none}
  58. -->
  59. </style>
  60. </head>
  61. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  62. <a name="ALARM"></a>
  63. <div class="header">
  64. <p>
  65. Next: <a href="ALL.html#ALL" accesskey="n" rel="next">ALL</a>, Previous: <a href="AINT.html#AINT" accesskey="p" rel="prev">AINT</a>, Up: <a href="Intrinsic-Procedures.html#Intrinsic-Procedures" accesskey="u" rel="up">Intrinsic Procedures</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html#Option-Index" title="Index" rel="index">Index</a>]</p>
  66. </div>
  67. <hr>
  68. <a name="ALARM-_002d_002d_002d-Execute-a-routine-after-a-given-delay"></a>
  69. <h3 class="section">9.13 <code>ALARM</code> &mdash; Execute a routine after a given delay</h3>
  70. <a name="index-ALARM"></a>
  71. <a name="index-delayed-execution"></a>
  72. <dl compact="compact">
  73. <dt><em>Description</em>:</dt>
  74. <dd><p><code>ALARM(SECONDS, HANDLER [, STATUS])</code> causes external subroutine <var>HANDLER</var>
  75. to be executed after a delay of <var>SECONDS</var> by using <code>alarm(2)</code> to
  76. set up a signal and <code>signal(2)</code> to catch it. If <var>STATUS</var> is
  77. supplied, it will be returned with the number of seconds remaining until
  78. any previously scheduled alarm was due to be delivered, or zero if there
  79. was no previously scheduled alarm.
  80. </p>
  81. </dd>
  82. <dt><em>Standard</em>:</dt>
  83. <dd><p>GNU extension
  84. </p>
  85. </dd>
  86. <dt><em>Class</em>:</dt>
  87. <dd><p>Subroutine
  88. </p>
  89. </dd>
  90. <dt><em>Syntax</em>:</dt>
  91. <dd><p><code>CALL ALARM(SECONDS, HANDLER [, STATUS])</code>
  92. </p>
  93. </dd>
  94. <dt><em>Arguments</em>:</dt>
  95. <dd><table>
  96. <tr><td width="15%"><var>SECONDS</var></td><td width="70%">The type of the argument shall be a scalar
  97. <code>INTEGER</code>. It is <code>INTENT(IN)</code>.</td></tr>
  98. <tr><td width="15%"><var>HANDLER</var></td><td width="70%">Signal handler (<code>INTEGER FUNCTION</code> or
  99. <code>SUBROUTINE</code>) or dummy/global <code>INTEGER</code> scalar. The scalar
  100. values may be either <code>SIG_IGN=1</code> to ignore the alarm generated
  101. or <code>SIG_DFL=0</code> to set the default action. It is <code>INTENT(IN)</code>.</td></tr>
  102. <tr><td width="15%"><var>STATUS</var></td><td width="70%">(Optional) <var>STATUS</var> shall be a scalar
  103. variable of the default <code>INTEGER</code> kind. It is <code>INTENT(OUT)</code>.</td></tr>
  104. </table>
  105. </dd>
  106. <dt><em>Example</em>:</dt>
  107. <dd><div class="smallexample">
  108. <pre class="smallexample">program test_alarm
  109. external handler_print
  110. integer i
  111. call alarm (3, handler_print, i)
  112. print *, i
  113. call sleep(10)
  114. end program test_alarm
  115. </pre></div>
  116. <p>This will cause the external routine <var>handler_print</var> to be called
  117. after 3 seconds.
  118. </p></dd>
  119. </dl>
  120. </body>
  121. </html>