XrmEnumerateDatabase.3X11.z(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;



     Licensed material--property of copyright holder(s)         Page 1



                         X Version 11 (ReleaX
se
rm5
E)
numerateDatabase(3X11)



               XrmQuarkList quarks;
               XrmRepresentation *type;
               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










































     Licensed material--property of copyright holder(s)         Page 2

Museum