System Debug Reference Manual (32650-90888)

492 Chapter11
System Debug Standard Functions
func strwrite
Trailing spaces are always blank filled.
In specifications with quotes, the quotes do not count in the number of
positions specified. The string is built such that it appears inside the
quotes as it would without the quotes.
The T directive (typed) displays the type of the value, preceding the value.
The U directive (untyped) suppresses the display of the type. Types are
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: