XrmEnumerateDatabase(3X11)  X Version 11(Release 5)  XrmEnumerateDatabase(3X11)


NAME
      XrmEnumerateDatabase - enumerate resource database entries

SYNTAX
      #define   XrmEnumAllLevels       0
      #define   XrmEnumOneLevel        1

      Bool XrmEnumerateDatabase(database, name_prefix, class_prefix, mode,
      proc, arg)
            XrmDatabase database;
            XrmNameList name_prefix;
            XrmClassList class_prefix;
            int mode;
            Bool (*proc)();
            XPointer arg;

ARGUMENTS
      database  Specifies the resource database.

      name_prefix
                Specifies the resource name prefix.

      class_prefix
                Specifies the resource class prefix.

      mode      Specifies the number of levels to enumerate.

      proc      Specifies the procedure that is to be called for each matching
                entry.

      arg       Specifies the user-supplied argument that will be passed to the
                procedure.

DESCRIPTION
      The XrmEnumerateDatabase function calls the specified procedure for each
      resource in the database that would match some completion of the given
      name/class resource prefix.  The order in which resources are found is
      implementation-dependent.  If mode is XrmEnumOneLevel, then a resource
      must match the given name/class prefix with just a single name and class
      appended.  If mode is XrmEnumAllLevels, the resource must match the given
      name/class prefix with one or more names and classes appended.  If the
      procedure returns True, the enumeration terminates and the function
      returns True.  If the procedure always returns False, all matching
      resources are enumerated and the function returns False.

      The procedure is called with the following arguments:

      (*proc)(database, bindings, quarks, type, value, arg)
           XrmDatabase *database;
           XrmBindingList bindings;
           XrmQuarkList quarks;
           XrmRepresentation *type;


10/89                                                                    Page 1

XrmEnumerateDatabase(3X11)  X Version 11(Release 5)  XrmEnumerateDatabase(3X11)


           XrmValue *value;
           XPointer closure;

      The bindings and quarks lists are terminated by NULLQUARK.  Note that
      pointers to the database and type are passed, but these values should not
      be modified.

SEE ALSO
      XrmGetResource(3X11), XrmInitialize(3X11), XrmPutResource(3X11)
      Xlib - C Language X Interface












































Page 2                                                                    10/89