^Z^Zfield-value the-value^Z^Zfield-end
where field-nameis the name of the field, separator-stringis text which separates the name from the value for the user's benefit (such as `='), and value-flagsand the-valuehave the same meanings as in a value-history-beginannotation.
When printing an array, GDB annotates it as follows:
^Z^Zarray-section-begin array-indexvalue-flags
where array-index is the index of the first element being annotated and value-flags has the same meaning as in a value-history-begin annotation. This is followed by any number of elements, where the element can be either a single element or a repeated element as shown in the examples below:
`,' whitespace ; omitted for the first element the-value
^Z^Zelt
`,' whitespace ; omitted for the first element the-value
^Z^Zelt-repnumber-of-repititions repetition-string ^Z^Zelt-rep-end
In both cases, the-valueis the output for the value of the element and whitespace can contain spaces, tabs, and newlines. In the repeated case, number-of-repititonsis the number of consecutive array elements which contain that value, and repetition-stringis a string which is designed to convey to the user that repetition is being depicted.
Once all the array elements have been output, the array annotation is ended with:
^Z^Zarray-section-end
20.4 Frames
Whenever GDB prints a frame, it annotates it. For example, this applies to frames printed when GDB stops, output from commands such as backtrace or up, etc.
The frame annotation begins with:
^Z^Zframe-begin level address level-string
where level is the number of the frame (0 is the innermost frame, and other frames have positive numbers), address is the address of the code executing in that frame, and level-stringis a string designed to convey the level to the user. address is in the form `0x' followed by one or more lowercase hex digits (note that this does not depend on the language). The frame ends with:
^Z^Zframe-end
Between these annotations is the main body of the frame, which can consist of: