Range-Checking.html 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Copyright (C) 1988-2020 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 "Free Software" and "Free Software Needs
  8. Free Documentation", with the Front-Cover Texts being "A GNU Manual,"
  9. and with the Back-Cover Texts as in (a) below.
  10. (a) The FSF's Back-Cover Text is: "You are free to copy and modify
  11. this GNU Manual. Buying copies from GNU Press supports the FSF in
  12. developing GNU and promoting software freedom." -->
  13. <!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
  14. <head>
  15. <title>Debugging with GDB: Range Checking</title>
  16. <meta name="description" content="Debugging with GDB: Range Checking">
  17. <meta name="keywords" content="Debugging with GDB: Range Checking">
  18. <meta name="resource-type" content="document">
  19. <meta name="distribution" content="global">
  20. <meta name="Generator" content="makeinfo">
  21. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  22. <link href="index.html#Top" rel="start" title="Top">
  23. <link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
  24. <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
  25. <link href="Checks.html#Checks" rel="up" title="Checks">
  26. <link href="Supported-Languages.html#Supported-Languages" rel="next" title="Supported Languages">
  27. <link href="Type-Checking.html#Type-Checking" rel="previous" title="Type Checking">
  28. <style type="text/css">
  29. <!--
  30. a.summary-letter {text-decoration: none}
  31. blockquote.smallquotation {font-size: smaller}
  32. div.display {margin-left: 3.2em}
  33. div.example {margin-left: 3.2em}
  34. div.indentedblock {margin-left: 3.2em}
  35. div.lisp {margin-left: 3.2em}
  36. div.smalldisplay {margin-left: 3.2em}
  37. div.smallexample {margin-left: 3.2em}
  38. div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
  39. div.smalllisp {margin-left: 3.2em}
  40. kbd {font-style:oblique}
  41. pre.display {font-family: inherit}
  42. pre.format {font-family: inherit}
  43. pre.menu-comment {font-family: serif}
  44. pre.menu-preformatted {font-family: serif}
  45. pre.smalldisplay {font-family: inherit; font-size: smaller}
  46. pre.smallexample {font-size: smaller}
  47. pre.smallformat {font-family: inherit; font-size: smaller}
  48. pre.smalllisp {font-size: smaller}
  49. span.nocodebreak {white-space:nowrap}
  50. span.nolinebreak {white-space:nowrap}
  51. span.roman {font-family:serif; font-weight:normal}
  52. span.sansserif {font-family:sans-serif; font-weight:normal}
  53. ul.no-bullet {list-style: none}
  54. -->
  55. </style>
  56. </head>
  57. <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
  58. <a name="Range-Checking"></a>
  59. <div class="header">
  60. <p>
  61. Previous: <a href="Type-Checking.html#Type-Checking" accesskey="p" rel="previous">Type Checking</a>, Up: <a href="Checks.html#Checks" accesskey="u" rel="up">Checks</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
  62. </div>
  63. <hr>
  64. <a name="An-Overview-of-Range-Checking"></a>
  65. <h4 class="subsection">15.3.2 An Overview of Range Checking</h4>
  66. <p>In some languages (such as Modula-2), it is an error to exceed the
  67. bounds of a type; this is enforced with run-time checks. Such range
  68. checking is meant to ensure program correctness by making sure
  69. computations do not overflow, or indices on an array element access do
  70. not exceed the bounds of the array.
  71. </p>
  72. <p>For expressions you use in <small>GDB</small> commands, you can tell
  73. <small>GDB</small> to treat range errors in one of three ways: ignore them,
  74. always treat them as errors and abandon the expression, or issue
  75. warnings but evaluate the expression anyway.
  76. </p>
  77. <p>A range error can result from numerical overflow, from exceeding an
  78. array index bound, or when you type a constant that is not a member
  79. of any type. Some languages, however, do not treat overflows as an
  80. error. In many implementations of C, mathematical overflow causes the
  81. result to &ldquo;wrap around&rdquo; to lower values&mdash;for example, if <var>m</var> is
  82. the largest integer value, and <var>s</var> is the smallest, then
  83. </p>
  84. <div class="smallexample">
  85. <pre class="smallexample"><var>m</var> + 1 &rArr; <var>s</var>
  86. </pre></div>
  87. <p>This, too, is specific to individual languages, and in some cases
  88. specific to individual compilers or machines. See <a href="Supported-Languages.html#Supported-Languages">Supported Languages</a>, for further details on specific languages.
  89. </p>
  90. <p><small>GDB</small> provides some additional commands for controlling the range checker:
  91. </p>
  92. <a name="index-set-check-range"></a>
  93. <a name="index-show-check-range"></a>
  94. <dl compact="compact">
  95. <dt><code>set check range auto</code></dt>
  96. <dd><p>Set range checking on or off based on the current working language.
  97. See <a href="Supported-Languages.html#Supported-Languages">Supported Languages</a>, for the default settings for
  98. each language.
  99. </p>
  100. </dd>
  101. <dt><code>set check range on</code></dt>
  102. <dt><code>set check range off</code></dt>
  103. <dd><p>Set range checking on or off, overriding the default setting for the
  104. current working language. A warning is issued if the setting does not
  105. match the language default. If a range error occurs and range checking is on,
  106. then a message is printed and evaluation of the expression is aborted.
  107. </p>
  108. </dd>
  109. <dt><code>set check range warn</code></dt>
  110. <dd><p>Output messages when the <small>GDB</small> range checker detects a range error,
  111. but attempt to evaluate the expression anyway. Evaluating the
  112. expression may still be impossible for other reasons, such as accessing
  113. memory that the process does not own (a typical example from many Unix
  114. systems).
  115. </p>
  116. </dd>
  117. <dt><code>show range</code></dt>
  118. <dd><p>Show the current setting of the range checker, and whether or not it is
  119. being set automatically by <small>GDB</small>.
  120. </p></dd>
  121. </dl>
  122. <hr>
  123. <div class="header">
  124. <p>
  125. Previous: <a href="Type-Checking.html#Type-Checking" accesskey="p" rel="previous">Type Checking</a>, Up: <a href="Checks.html#Checks" accesskey="u" rel="up">Checks</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
  126. </div>
  127. </body>
  128. </html>