Function panda_sys::object_resolve_path[][src]

pub unsafe extern "C" fn object_resolve_path(
    path: *const c_char,
    ambiguous: *mut bool
) -> *mut Object
Expand description

object_resolve_path: @path: the path to resolve @ambiguous: returns true if the path resolution failed because of an ambiguous match

There are two types of supported paths–absolute paths and partial paths.

Absolute paths are derived from the root object and can follow child<> or link<> properties. Since they can follow link<> properties, they can be arbitrarily long. Absolute paths look like absolute filenames and are prefixed with a leading slash.

Partial paths look like relative filenames. They do not begin with a prefix. The matching rules for partial paths are subtle but designed to make specifying objects easy. At each level of the composition tree, the partial path is matched as an absolute path. The first match is not returned. At least two matches are searched for. A successful result is only returned if only one match is found. If more than one match is found, a flag is returned to indicate that the match was ambiguous.

Returns: The matched object or NULL on path lookup failure.