Table 1. Some examples for procedure names
Name | Description |
InitSy | Takes an sy as its argument and initializes it. |
OpenFn | fn is the argument. The procedure will "open" the fn. No value is returned. |
FcFromBnRn | Returns the fc corresponding to the bn,rn pair given. (The names cannot tell us what the types sy, fn, fc, and so on, are.) |
Table 2. Standard type constructions
pX | Pointer to X. |
dX | Difference between two instances of type X. X + dX is of type X. |
cX | Count of instances of type X. |
mpXY | An array of Ys indexed by X. Read as "map from X to Y." |
rgX | An array of Xs. Read as "range X." The indices of the array are called: |
dnX | (rare) An array indexed by type X. The elements of the array are called: |
grpX | A group of Xs stored one after another in storage. Used when the X elements are of variable size and standard array indexing would not apply. Elements of the group must be referenced by means other then direct indexing. A storage allocation zone, for example, is a grp of blocks. |
bX | Relative offset to a type X. This is used for field displacements in a data structure with variable size fields. The offset may be given in terms of bytes or words, depending on the base pointer from which the offset is measured. |
cbX | Size of instances of X in bytes. |
cwX | Size of instances of X in words. |
Table 3. Standard qualifiers
XFirst | The first element in an ordered set (interval) of X values. |
XLast | The last element in an ordered set of X values. XLast is the upper limit of a closed interval, hence the loop continuation condition should be: X <= XLast. |
XLim | The strict upper limit of an ordered set of X values. |
XMax | Strict upper limit for all X values (excepting Max, Mac, and Nil) for all other X: X < XMax. If X values start with X=0, XMax is equal to the number of different X values. The allocated length of a dnx vector, for example, will be typically XMax. |
XMac | The current (as opposed to constant or allocated) upper limit for all X values. If X values start with 0, XMac is the current number of X values. To iterate through a dnx array, for example: |
XNil | A distinguished Nil value of type X. The value may or may not be 0 or -1. |
XT | Temporary X. An easy way to qualify the second quantity of a given type in a scope. |
Table 4. Some common primitive types
f | Flag (Boolean, logical). If qualifier is used, it should describe the true state of the flag. Exception: the constants fTrue and fFalse. |
w | Word with arbitrary contents. |
ch | Character, usually in ASCII text. |
b | Byte, not necessarily holding a coded character, more akin to w. Distinguished from the b constructor by the capital letter of the qualifier in immediately following. |
sz | Pointer to first character of a zero terminated string. |
st | Pointer to a string. First byte is the count of characters cch. |
h | pp (in heap). |
Posted by 헤즈
