libgit2

git_pathspec_match_tree

Version:

Match a pathspec against files in a tree.

This matches the pathspec against the files in the given tree.

If out is not NULL, this returns a git_patchspec_match_list. That contains the list of all matched filenames (unless you pass the GIT_PATHSPEC_FAILURES_ONLY flag) and may also contain the list of pathspecs with no match (if you used the GIT_PATHSPEC_FIND_FAILURES flag). You must call git_pathspec_match_list_free() on this object.

Signature

GitHub
int git_pathspec_match_tree(git_pathspec_match_list **out, git_tree *tree, uint32_t flags, git_pathspec *ps);

Parameters

git_pathspec_match_list **
In
out

Output list of matches; pass NULL to just get return value

git_tree *
In
tree

The root-level tree to match against

uint32_t
In
flags

Combination of git_pathspec_flag_t options to control match

git_pathspec *
In
ps

Pathspec to be matched

Returns

int

0 on success, -1 on error, GIT_ENOTFOUND if no matches and the GIT_PATHSPEC_NO_MATCH_ERROR flag is used

Versions