System Debug Reference Manual (32650-90888)

Chapter 10 465
System Debug Standard Functions
func symlen
func symlen
Returns the length of a data structure in bits or bytes.
Syntax
symlen ( pathspec [ units ])
Formal Declaration
symlen:u32 ( pathspec :str [ units :u32=$8])
Parameters
pathspec A path specification, as described in chapter 5, "Symbolic
Formatting/Symbolic Access."
units Specifies the units (that is, bit width) in which the result is given. 1 means
bits, 8 means bytes, 32 means words. The default is bytes.
The symbolic length is rounded up to the nearest whole unit.
Examples
$nmdebug > symopen gradtyp.demo
Opens the symbolic data type file gradtyp.demo. It is assumed that the Debug variable
addr contains the address of a StudentRecord data structure in virtual memory. The
following code fragment is from this file:
CONST MINGRADES = 1; MAXGRADES = 10;
MINSTUDENTS = 1; MAXSTUDENTS = 5;
TYPE
GradeRange = MINGRADES .. MAXGRADES;
GradesArray = ARRAY [ GradeRange ] OF integer;
Class = ( SENIOR, JUNIOR, SOPHOMORE, FRESHMAN );
NameStr = string[8];
StudentRecord = RECORD
Name : NameStr;
Id : Integer;
Year : Class;
NumGrades : GradeRange;
Grades : GradesArray;
END;