Welcome2 139
0x139 Welcome2
| << Contents << Other Topics << Symbol Tables |
| Text Symbol Table Files |
| A text symbol table is created with any text editor like "NotePad.exe". Each symbolic name is associated with a trace data value. |
| Formatting rules |
| * Use a ";" character (semi-colon) at the line start to comment-out the line. |
| * Values are read as 64-bit unsigned hexadecimal values. |
| * The lines can use value-first or symbol-first order. |
| * The first line in the file determines the format. Value-first lines cannot be mixed with symbol-first lines. |
| * All lines use the same order. Value-first order cannot be mixed with symbol-first order. |
| * For value-first order, we recommend using a "0x" prefix before all values. This allows the GoLogic7 software to distinguish values from symbolic names. |
| * No extra text is allowed in the file. Therefore, symbol table files produced by a compiler or assembler may have to be edited. Use a text editor like NotePad.exe to remove superfluous text. |
| * The file size is unlimited. |
| * An optional Color Attribute can be added to each line. |
| Header Lines |
| *The following header lines can be placed at the start of the file to affect how the text symbols are processed... |
| AssumeAscending |
| If "AssumeAscending=yes" then the symbols are assumed to be sorted by ascending values. The smallest value is the first symbol line and the largest value is the last line. Therefore, the symbol table does not need to be sorted after the file is loaded. |
| Bitmasks |
| If "Bitmasks=yes", then each symbolic value is a BitMask. |
| MaskWidth |
| "MaskWidth=(number)" defines the total bits in each BitMask. |
| Overwrite |
| If "Overwrite=yes", then duplicate values overwrite the prior symbol strings. If "Overwrite=no" or is missing, the duplicate values are ignored. |
| StringTableSize |
| "StringTableSize=(number)" defines the total number of characters required to contain all the symbol names. An extra character is needed to separate each symbol name. Omit this header line if you are unsure of the total number of characters required for all symbol names. The software may crash is an incorrect value is provided. |
| SymbolCount |
| "SymbolCount=(number)" defines the total symbols in the file, which is the total text lines not including the header lines. For example, "SymbolCount=100" means that 100 lines follow the header lines. Omit this header line if you are unsure of the total symbol lines in the file. The software may crash if an incorrect value is provided. |
| Examples |
| Symbol-first order... |
|
HelloWorld AB7 Welcome2 139 |
| Value-first order... |
|
0xAB7 HelloWorld 0x139 Welcome2 |
| Copyright and trademark information |
|
|