thodg/libgit2/src/tree.h

• Show log

  Commit

• Hash : 58206c9a
  Author :
  Date : 2013-05-16T10:38:27
  

  Add cat-file example and increase const use in API This adds an example implementation that emulates git cat-file. It is a convenient and relatively simple example of getting data out of a repository. Implementing this also revealed that there are a number of APIs that are still not using const pointers to objects that really ought to be. The main cause of this is that `git_vector_bsearch` may need to call `git_vector_sort` before doing the search, so a const pointer to the vector is not allowed. However, for tree objects, with a little care, we can ensure that the vector of tree entries is always sorted and allow lookups to take a const pointer. Also, the missing const in commit objects just looks like an oversight.

Download

• src/tree.h

• /*
   * Copyright (C) the libgit2 contributors. All rights reserved.
   *
   * This file is part of libgit2, distributed under the GNU GPL v2 with
   * a Linking Exception. For full terms see the included COPYING file.
   */
  #ifndef INCLUDE_tree_h__
  #define INCLUDE_tree_h__
  
  #include "git2/tree.h"
  #include "repository.h"
  #include "odb.h"
  #include "vector.h"
  
  struct git_tree_entry {
  	uint16_t removed;
  	uint16_t attr;
  	git_oid oid;
  	size_t filename_len;
  	char filename[1];
  };
  
  struct git_tree {
  	git_object object;
  	git_vector entries;
  };
  
  struct git_treebuilder {
  	git_vector entries;
  	size_t entrycount; /* vector may contain "removed" entries */
  };
  
  GIT_INLINE(bool) git_tree_entry__is_tree(const struct git_tree_entry *e)
  {
  	return (S_ISDIR(e->attr) && !S_ISGITLINK(e->attr));
  }
  
  extern int git_tree_entry_icmp(const git_tree_entry *e1, const git_tree_entry *e2);
  
  void git_tree__free(void *tree);
  int git_tree__parse(void *tree, git_odb_object *obj);
  
  /**
   * Lookup the first position in the tree with a given prefix.
   *
   * @param tree a previously loaded tree.
   * @param prefix the beginning of a path to find in the tree.
   * @return index of the first item at or after the given prefix.
   */
  int git_tree__prefix_position(const git_tree *tree, const char *prefix);
  
  
  /**
   * Write a tree to the given repository
   */
  int git_tree__write_index(
  	git_oid *oid, git_index *index, git_repository *repo);
  
  /**
   * Obsolete mode kept for compatibility reasons
   */
  #define GIT_FILEMODE_BLOB_GROUP_WRITABLE 0100664
  
  #endif
  

Download