System Debug Reference Manual (32650-90901)

460 Chapter10
System Debug Standard Functions
func strwrite
displayed in upper case, with a single trailing blank. The width of the type
display string varies, based on the type, and it is independent of any
specified width (M, F, or Wn) for the value display.
For values of type LPTR (long pointer,
sid.offset , or seg.offset ) and
EADDR (extended address,
sid.offset or ldev.offset ), two separate
format directives can be specified. Each is separated by a dot, ".", to
indicate individual formatting choices for the "
sid " portion and the
"
offset " portion. This is true for all code pointers (ACPTR - absolute code
pointers: CST,
CSTX; LCPTR - Logical Code Pointers: PROG, GRP, PUB, LGRP, LPUB,
SYS, User, TRANS). For example:
pc:"+.-, w4.8, r.l, b.z"
The following default values are used for omitted format directives. Note
that the default format directives depend on the type of value to be
formatted:
value type default format
---------- --------------
STR, BOOL - R B M U
U16,S16,U32,S32,S64 + R B M U
SPTR + R Z F U
LPTR +.- R.L B.Z M.F U
ACPTR LCPTR +.- R.L B.Z M.F T
CST PROG +.- R.L B.Z M.F T
CSTX GRP +.- R.L B.Z M.F T
PUB +.- R.L B.Z M.F T
LGRP +.- R.L B.Z M.F T
LPUB +.- R.L B.Z M.F T
SYS +.- R.L B.Z M.F T
USER +.- R.L B.Z M.F T
TRANS +.- R.L B.Z M.F T
EADDR +.- R.L B.Z M.F U
SADDR +.- R.L B.Z M.F T
Note that absolute code pointers, logical code pointers and secondary
addresses display their types (T) by default. All other types default to (U)
untyped.
The C
n (Column n ) directive moves the current output buffer position to
the specified column position prior to the next write into the output buffer.
Column numbers start at column 1. For example:
number:"c6"
NOTE The C n directive is ignored by the ASC function but is honored by the W, WL
and WP commands.
Examples
$nmdat > var save = strwrite('1 2 3 "-->" 4:"z w4 r z" 5')