]> source.dussan.org Git - jgit.git/commitdiff
DirCache.findEntry(byte[], in) made public 58/22458/1
authorMarc Strapetz <marc.strapetz@syntevo.com>
Mon, 27 May 2013 08:32:47 +0000 (10:32 +0200)
committerMarc Strapetz <marc.strapetz@syntevo.com>
Mon, 24 Feb 2014 17:29:27 +0000 (18:29 +0100)
Change-Id: Ice64e3b0e5d67a39690aa24e41c954b8ce312d49
Signed-off-by: Marc Strapetz <marc.strapetz@syntevo.com>‌
org.eclipse.jgit/src/org/eclipse/jgit/dircache/DirCache.java

index 275dfedebfbe44a55298008d9968927bdce8c3be..f7d6c1780eccb71f712f8f38491c638013b3a098 100644 (file)
@@ -731,13 +731,7 @@ public class DirCache {
 
        /**
         * Locate the position a path's entry is at in the index.
-        * <p>
-        * If there is at least one entry in the index for this path the position of
-        * the lowest stage is returned. Subsequent stages can be identified by
-        * testing consecutive entries until the path differs.
-        * <p>
-        * If no path matches the entry -(position+1) is returned, where position is
-        * the location it would have gone within the index.
+        * For details refer to #findEntry(byte[], int).
         *
         * @param path
         *            the path to search for.
@@ -750,7 +744,25 @@ public class DirCache {
                return findEntry(p, p.length);
        }
 
-       int findEntry(final byte[] p, final int pLen) {
+       /**
+        * Locate the position a path's entry is at in the index.
+        * <p>
+        * If there is at least one entry in the index for this path the position of
+        * the lowest stage is returned. Subsequent stages can be identified by
+        * testing consecutive entries until the path differs.
+        * <p>
+        * If no path matches the entry -(position+1) is returned, where position is
+        * the location it would have gone within the index.
+        *
+        * @param p
+        *            the byte array starting with the path to search for.
+        * @param pLen
+        *            the length of the path in bytes
+        * @return if >= 0 then the return value is the position of the entry in the
+        *         index; pass to {@link #getEntry(int)} to obtain the entry
+        *         information. If < 0 the entry does not exist in the index.
+        */
+       public int findEntry(final byte[] p, final int pLen) {
                int low = 0;
                int high = entryCnt;
                while (low < high) {