2 Names

 2.1 Case Sensitivity

Each string stored within a group is referred to in the rest of this document as a name. The term is used purely for convenience and is not meant to imply anything about what the strings actually represent. In some cases the strings may easily be thought of as names (for instance, in the example in the previous section the strings were the names of files), but this may not always be so.

The maximum length of a name is given by the symbolic constant GRP__SZNAM (which is currently 255). Leading spaces, and spaces within names are significant, but trailing spaces are ignored. Completely blank names are allowed, and null names (i.e. names of zero length) are treated as blank names.

2.1 Case Sensitivity

Names are always stored in the form in which they are supplied. However, when names are retrieved from a group they will be converted to upper case if the group has been designated as a case insensitive group. When groups are first created they are considered to be case sensitive (i.e. names are retrieved from the group in the same form in which they were stored). They can be made case in-sensitive by calling routine GRP_SETCS. Any comparisons involving names held in case insensitive groups are performed without reference to case.