[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        FindNamedObject -- find the next object of a given name. (V39)

   SYNOPSIS
        object = FindNamedObject(nameSpace, name, lastObject);
        D0                       A0         A1    A2

        struct namedobject *findnamedobject(struct namedobject *, strptr,
                                            struct namedobject *);

   FUNCTION
        Finds an object and adds to the open count of the object. The
        object is guaranteed not to be freed until releasenamedobject() is
        called. The name comparison is caseless, using the current
        locale string comparison routines.

        If name is NULL, then all objects will be matched.

        If lastObject is non-NULL, it must be an object from the same
        NameSpace found on a previous call to FindNamedObject(). It
        will not be freed by this call. The search will start at the
        node after lastobject, if non-NULL.

        nameSpace is the name space from the named object given
        or the root name space if NULL is given.

   INPUTS
        nameSpace - the name space to search
        name - the name of the object to search for
        lastObject - the starting point for the search or NULL

   RESULT
        object - the first match found, or NULL for no match

   SEE ALSO
        releasenamedobject(), <utility/name.h>