Next: , Previous: , Up: Programming Tools   [Contents][Index]


5.24.6 Examining data and code

The following words inspect the stack non-destructively:

...       unknown         varargs       “(programmable)”
.s              tools       “dot-s”

Display the number of items on the data stack, followed by a list of the items (but not more than specified by maxdepth-.s; TOS is the right-most item.

f.s              gforth       “f-dot-s”

Display the number of items on the floating-point stack, followed by a list of the items (but not more than specified by maxdepth-.s; TOS is the right-most item.

maxdepth-.s       – addr         gforth       “maxdepth-dot-s”

A variable containing 9 by default. .s and f.s display at most that many stack items.

There is a word .r but it does not display the return stack! It is used for formatted numeric output (see Simple numeric output).

depth       – +n         core       “depth”

+n is the number of values that were on the data stack before +n itself was placed on the stack.

fdepth       – +n         float       “f-depth”

+n is the current number of (floating-point) values on the floating-point stack.

clearstack       ... –         gforth       “clear-stack”

remove and discard all/any items from the data stack.

clearstacks       ... –         gforth       “clear-stacks”

empty data and FP stack

The following words inspect memory.

?       a-addr –         tools       “question”

Display the contents of address a-addr in the current number base.

dump       addr u –         unknown       “dump”

Next: , Previous: , Up: Programming Tools   [Contents][Index]