25 |
|
|
26 |
@section Capturing the Stack or Innermost Stack Frame |
@section Capturing the Stack or Innermost Stack Frame |
27 |
|
|
28 |
|
When an error occurs in a running program, or the program hits a |
29 |
|
breakpoint, its state at that point can be represented by a @dfn{stack} |
30 |
|
of all the evaluations and procedure applications that are logically in |
31 |
|
progress at that time, each of which is known as a @dfn{frame}. The |
32 |
|
programmer can learn more about the program's state at the point of |
33 |
|
interruption or error by inspecting the stack and its frames. |
34 |
|
|
35 |
@deffn {Scheme Procedure} make-stack obj . args |
@deffn {Scheme Procedure} make-stack obj . args |
36 |
@deffnx {C Function} scm_make_stack (obj, args) |
@deffnx {C Function} scm_make_stack (obj, args) |
37 |
Create a new stack. If @var{obj} is @code{#t}, the current |
Create a new stack. If @var{obj} is @code{#t}, the current |
190 |
@end deffn |
@end deffn |
191 |
|
|
192 |
|
|
193 |
|
@section Starting a New Stack |
194 |
|
|
195 |
|
@deffn {Scheme Syntax} start-stack id exp |
196 |
|
Evaluate @var{exp} on a new calling stack with identity @var{id}. If |
197 |
|
@var{exp} is interrupted during evaluation, backtraces will not display |
198 |
|
frames farther back than @var{exp}'s top-level form. This macro is a |
199 |
|
way of artificially limiting backtraces and stack procedures, largely as |
200 |
|
a convenience to the user. |
201 |
|
@end deffn |
202 |
|
|
203 |
|
|
204 |
@c Local Variables: |
@c Local Variables: |
205 |
@c TeX-master: "guile.texi" |
@c TeX-master: "guile.texi" |
206 |
@c End: |
@c End: |