libgit2

git_reference_name_to_id

Version:

Lookup a reference by name and resolve immediately to OID.

This function provides a quick way to resolve a reference name straight through to the object id that it refers to. This avoids having to allocate or free any git_reference objects for simple situations.

The name will be checked for validity. See git_reference_symbolic_create() for rules about valid names.

Signature

GitHub
int git_reference_name_to_id(git_oid *out, git_repository *repo, const char *name);

Parameters

git_oid *
In
out

Pointer to oid to be filled in

git_repository *
In
repo

The repository in which to look up the reference

const char *
In
name

The long name for the reference (e.g. HEAD, refs/heads/master, refs/tags/v0.1.0, ...)

Returns

int

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

Versions