|
Table of Contents
XrmUniqueQuark, XrmStringToQuark,
XrmPermStringToQuark, XrmQuarkToString, XrmStringToQuarkList, XrmStringToBindingQuarkList
- manipulate resource quarks
- XrmQuark XrmUniqueQuark(void);
#define
XrmStringToName(string) XrmStringToQuark(string)
#define XrmStringToClass(string) XrmStringToQuark(string)
#define XrmStringToRepresentation(string) XrmStringToQuark(string)
- int
XrmQuark XrmStringToQuark(char *string);
- XrmQuark XrmPermStringToQuark(char
*string);
#define XrmStringToName(string) XrmStringToQuark(string)
#define XrmStringToClass(string) XrmStringToQuark(string)
#define XrmStringToRepresentation(string) XrmStringToQuark(string)
- XrmQuark
XrmStringToQuark(char *string);
- XrmQuark XrmPermStringToQuark(char *string);
#define XrmNameToString(name)
XrmQuarkToString(name)
#define XrmClassToString(class) XrmQuarkToString(class)
#define XrmRepresentationToString(type) XrmQuarkToString(type)
- char *XrmQuarkToString(XrmQuark
quark);
#define XrmStringToNameList(str, name) XrmStringToQuarkList((str),
(name))
#define XrmStringToClassList(str,class) XrmStringToQuarkList((str), (class))
- void XrmStringToQuarkList(char *string, XrmQuarkList
- quarks_return);
- XrmStringToBindingQuarkList(char
*string, XrmBindingList
- bindings_return, XrmQuarkList quarks_return);
- bindings_return
- Returns the binding list.
- quark
- Specifies the quark
for which the equivalent string is desired.
- quarks_return
- Returns the list
of quarks.
- string
- Specifies the string for which a quark or quark list is
to be allocated.
The XrmUniqueQuark function allocates a quark
that is guaranteed not to represent any string that is known to the resource
manager.
These functions can be used to convert from string to quark representation.
If the string is not in the Host Portable Character Encoding, the conversion
is implementation-dependent. The string argument to XrmStringToQuark need
not be permanently allocated storage. XrmPermStringToQuark is just like
XrmStringToQuark, except that Xlib is permitted to assume the string
argument is permanently allocated, and, hence, that it can be used as the
value to be returned by XrmQuarkToString.
For any given quark, if XrmStringToQuark
returns a non-NULL value, all future calls will return the same value
(identical address).
These functions can be used to convert from quark representation
to string. The string pointed to by the return value must not be modified
or freed. The returned string is byte-for-byte equal to the original string
passed to one of the string-to-quark routines. If no string exists for that
quark, XrmQuarkToString returns NULL. For any given quark, if XrmQuarkToString
returns a non-NULL value, all future calls will return the same value
(identical address).
These functions can be used to convert from string
to quark representation. If the string is not in the Host Portable Character
Encoding, the conversion is implementation-dependent. The string argument
to XrmStringToQuark need not be permanently allocated storage. XrmPermStringToQuark
is just like XrmStringToQuark, except that Xlib is permitted to assume
the string argument is permanently allocated, and, hence, that it can be
used as the value to be returned by XrmQuarkToString.
For any given quark,
if XrmStringToQuark returns a non-NULL value, all future calls will return
the same value (identical address).
The XrmStringToQuarkList function
converts the null-terminated string (generally a fully qualified name) to
a list of quarks. The caller must allocate sufficient space for the quarks
list before calling XrmStringToQuarkList. Note that the string must be
in the valid ResourceName format (see section 15.1). If the string is not
in the Host Portable Character Encoding, the conversion is implementation-dependent.
A binding list is a list of type XrmBindingList and indicates if components
of name or class lists are bound tightly or loosely (that is, if wildcarding
of intermediate components is specified).
0
0>=40 .vs 0u
0<=39 .vs 0p
typedef enum {XrmBindTightly, XrmBindLoosely} XrmBinding, *XrmBindingList;
XrmBindTightly indicates that a period separates the components, and
XrmBindLoosely indicates that an asterisk separates the components.
The
XrmStringToBindingQuarkList function converts the specified string to
a binding list and a quark list. The caller must allocate sufficient space
for the quarks list and the binding list before calling XrmStringToBindingQuarkList.
If the string is not in the Host Portable Character Encoding the conversion
is implementation-dependent. Component names in the list are separated by
a period or an asterisk character. If the string does not start with period
or asterisk, a period is assumed. For example, ``*a.b*c'' becomes:
0
0>=40 .vs 0u
0<=39 .vs 0p
quarks a b c
bindings loose tight loose
XrmGetResource(3X11)
, XrmInitialize(3X11)
, XrmMergeDatabases(3X11)
,
XrmPutResource(3X11)
Xlib - C Language X Interface
Table of Contents
|
