docs/ja-jp/build/html/_sources/debug.txt

   1 .. index::
   2         single: トレースライブラリとインタラクティブデバッガ; はじめに
   3
   4 ============================================
   5 トレースライブラリとインタラクティブデバッガ
   6 ============================================
   7
   8 トレースライブラリとインタラクティブデバッガの用法を学びます。
   9
  10 .. index::
  11         pair: トレースライブラリとインタラクティブデバッガ; トレースライブラリの読み込み
  12
  13 トレースライブラリの読み込み
  14 ============================
  15
  16 トレースライブラリの使用前に tracelib.ring ライブラリを読み込みます。
  17
  18 .. code-block:: ring
  19
  20         load "tracelib.ring"
  21
  22 .. index::
  23         pair: トレースライブラリとインタラクティブデバッガ; イベントをすべてトレースするには
  24
  25 イベントをすべてトレースするには
  26 ================================
  27
  28 この用例は トレースライブラリの用法としてイベントをすべてトレースするためのデモです。
  29
  30 .. code-block:: ring
  31
  32         # イベントをすべてトレース
  33         trace(:AllEvents)
  34
  35         see "Hello, world!" + nl
  36         see "Welcome" + nl
  37         see "How are you?" +nl
  38
  39         mytest()
  40
  41         new myclass { mymethod() }
  42
  43         func mytest
  44                 see "Message from mytest" + nl
  45
  46         class myclass
  47                 func mymethod
  48                         see "Message from mymethod" + nl
  49
  50
  51 .. index::
  52         pair: トレースライブラリとインタラクティブデバッガ; 関数と制御フローのトレース
  53
  54 関数と制御フローのトレース
  55 ==========================
  56
  57 この用例は関数と制御フローのトレースのデモとしての
  58 トレースライブラリの用法です。
  59
  60 .. code-block:: ring
  61
  62         Trace(:Functions)
  63
  64         test1()
  65
  66         func test1
  67                 see :test1 + nl
  68                 test2()
  69
  70         func test2
  71                 see :test2 + nl
  72                 see test3() + nl
  73
  74         func test3
  75                 see :test3 + nl
  76                 return "test 3 output"
  77
  78 .. index::
  79         pair: トレースライブラリとインタラクティブデバッガ; エラーの渡しかた
  80
  81 エラーの渡しかた
  82 ================
  83
  84 この用例は トレースライブラリの用法であり、
  85 エラーを渡すためのデモです！
  86
  87 .. code-block:: ring
  88
  89         Trace(:PassError)
  90
  91         test1()
  92
  93         func test1
  94                 x = 10
  95                 see :test1 + nl
  96                 test2() # ランタイムエラー！
  97                 see "We can continue!"
  98
  99 .. index::
 100         pair: トレースライブラリとインタラクティブデバッガ; インタラクティブデバッガ
 101
 102 インタラクティブデバッガ
 103 ========================
 104
 105 この用例は トレースライブラリの用法であり、
 106 インタラクティブデバッガを使用したデモです。
 107
 108 .. code-block:: ring
 109
 110         Trace(:Debugger)
 111
 112         test1()
 113         see "good bye!" + nl
 114
 115         func test1
 116                 x = 10
 117                 see :test1 + nl
 118                 t = 12
 119                 test2() # ランタイムエラー！
 120                 see "After Error!" +nl
 121                 see "t = " see t see nl
 122                 see "x = " see x see nl
 123
 124 .. index::
 125         pair: トレースライブラリとインタラクティブデバッガ; プログラムを一行ずつ実行
 126
 127 プログラムを一行ずつ実行
 128 ========================
 129
 130 この用例は トレースライブラリの用法であり、
 131 プログラムを一行ずつ実行するデモです！
 132
 133 .. code-block:: ring
 134
 135         Trace(:LineByLine)
 136
 137         test1()
 138
 139         func test1
 140                 x = 10
 141                 see :test1 + nl
 142                 t = 12
 143                 test2()
 144                 see "After Error!" +nl
 145                 see "t = " + t + nl
 146
 147 .. index::
 148         pair: トレースライブラリとインタラクティブデバッガ; ブレークポイント
 149
 150 ブレークポイント
 151 ================
 152
 153 この用例は トレースライブラリのブレークポイントの停止における
 154 用法のデモンストレーションです！
 155
 156 .. code-block:: ring
 157
 158         test1()
 159
 160         func test1
 161                 x = 10
 162                 see :test1 + nl
 163                 t = 12
 164                 BreakPoint()
 165                 see "After breakpoint!" +nl
 166                 see "t = " + t + nl
 167                 see "End of program!" + nl
 168
 169 .. index::
 170         pair: トレースライブラリとインタラクティブデバッガ; ブレークポイントの禁止
 171
 172 ブレークポイントの禁止
 173 ======================
 174
 175 この用例はトレースライブラリの用法であり、
 176 ブレークポイントを禁止する方法です！
 177
 178 .. code-block:: ring
 179
 180         NoBreakPoints()
 181
 182         test1()
 183
 184         func test1
 185                 x = 10
 186                 see :test1 + nl
 187                 t = 12
 188                 BreakPoint()
 189                 see "After breakpoint!" +nl
 190                 see "t = " + t + nl
 191                 see "End of program!" + nl
 192
 193 .. index::
 194         pair: トレースライブラリとインタラクティブデバッガ; インタラクティブデバッガの用法
 195
 196 インタラクティブデバッガの用法
 197 ==============================
 198
 199 この用例はブレークポイントをインタラクティブデバッガで開きます！
 200
 201 .. code-block:: ring
 202
 203         load "tracelib.ring"
 204
 205         test1()
 206
 207         func test1
 208                 x = 10
 209                 see :test1 + nl
 210                 t = 12
 211                 BreakPoint()
 212                 see "After breakpoint!" +nl
 213                 see "t = " + t + nl
 214                 see "End of program!" + nl
 215
 216
 217 スクリーンショット:
 218
 219 ブレークポイントに関してはインタラクティブデバッガがあります！
 220
 221 .. image:: debugshot1.png
 222         :alt: インタラクティブデバッガ
 223
 224 変数の値を表示できます。
 225
 226 .. image:: debugshot2.png
 227         :alt: インタラクティブデバッガ
 228
 229 変数値の変更後に実行を継続できます。
 230
 231 .. image:: debugshot3.png
 232         :alt: インタラクティブデバッガ
 233
 234 実行結果ウィンドウでもインタラクティブデバッガを実行できます。
 235
 236 .. image:: debugshot4.png
 237         :alt: インタラクティブデバッガ
 238