Object and attribute qualifiers are contained in square brackets
("[qualifier]") and are prefixed to lines containing an
object or an attribute name.
You can set qualifiers to read() and write() calls by starting a line
containing an object or attribute name with an open square bracket, followed by a list
of single-letter or single-numeral qualifiers, and terminated by a close square bracket.
The following qualifiers are supported:
- n
- Nonpersistence. When set on an object, makes it nonpersistent. When set on an
attribute, makes it nonpersistent if the parent object is also nonpersistent;
otherwise is ignored. For more information, see Nonpersistence qualifier.
- i
- Item. Specifies an item for a set attribute. For more information, see Item qualifier.
Note:
- Qualifiers always default to "clear".
- On a read() call you will see a preceding qualifier list
"[option letters]" only for options that have been
set.
- Attribute options always precede both the special character and the
object or attribute name.
Setting qualifiers
If nothing precedes a qualifier, that qualifier is set. It the qualifier is preceded
by a minus sign ("-"), that qualifier is cleared. If a qualifier is not specified,
that qualifier is not changed. For example:
- [n]url::www.qnx.com — set the nonpersistence qualifier on this attribute
- [-n]url::www.qnx.com — clear the nonpersistence qualifier on this attribute
- url::www.qnx.com — do not change the current nonpersistence qualifier on this attribute
- [i]items::hammer, — add hammer to the set
- [-i]items::screw driver, — remove screw driver from the set