libgit2

git_revparse_ext

Version:

Find a single object and intermediate reference by a revision string.

See man gitrevisions, or http://git-scm.com/docs/git-rev-parse.html#_specifying_revisions for information on the syntax accepted.

In some cases ( @ { < -n>} or <branchname> @ {upstream}), the expression may point to an intermediate reference. When such expressions are being passed in, reference_out will be valued as well.

The returned object should be released with git_object_free and the returned reference with git_reference_free when no longer needed.

Signature

int git_revparse_ext(git_object **object_out, git_reference **reference_out, git_repository *repo, const char *spec);

Parameters

In
object_out

pointer to output object

In
reference_out

pointer to output reference or NULL

In
repo

the repository to search in

const char *
In
spec

the textual specification for an object

Returns

int

0 on success, GIT_ENOTFOUND, GIT_EAMBIGUOUS, GIT_EINVALIDSPEC or an error code

Versions