git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2 02/21] prefix_ref_iterator: break when we leave the prefix

From
Stefan Beller <sbeller@google.com>
Date
Sep 20, 2017, 20:25 UTC
Message-ID
<CAGZ79kbwCAidGR3cgukdjckZVYwj+qbOikqN-e934uP1yk9Cuw@mail.gmail.com>
In-Reply-To
<2bb2e8ccb57eef8acbea5004167751a007a1bd2f.1505799700.git.mhagger@alum.mit.edu>
On Mon, Sep 18, 2017 at 11:22 PM, Michael Haggerty <mhagger@alum.mit.edu> wrote:
Show 34 quoted lines
> From: Jeff King <peff@peff.net>
>
> If the underlying iterator is ordered, then `prefix_ref_iterator` can
> stop as soon as it sees a refname that comes after the prefix. This
> will rarely make a big difference now, because `ref_cache_iterator`
> only iterates over the directory containing the prefix (and usually
> the prefix will span a whole directory anyway). But if *hint, hint* a
> future reference backend doesn't itself know where to stop the
> iteration, then this optimization will be a big win.
>
> Note that there is no guarantee that the underlying iterator doesn't
> include output preceding the prefix, so we have to skip over any
> unwanted references before we get to the ones that we want.
>
> Signed-off-by: Jeff King <peff@peff.net>
> Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu>
> ---
>  refs/iterator.c | 32 +++++++++++++++++++++++++++++++-
>  1 file changed, 31 insertions(+), 1 deletion(-)
>
> diff --git a/refs/iterator.c b/refs/iterator.c
> index c475360f0a..bd35da4e62 100644
> --- a/refs/iterator.c
> +++ b/refs/iterator.c
> @@ -287,6 +287,20 @@ struct prefix_ref_iterator {
>         int trim;
>  };
>
> +/* Return -1, 0, 1 if refname is before, inside, or after the prefix. */
> +static int compare_prefix(const char *refname, const char *prefix)
> +{
> +       while (*prefix) {
> +               if (*refname != *prefix)
> +                       return ((unsigned char)*refname < (unsigned char)*prefix) ? -1 : +1;
This looks interesting.

We get a signed char* , cast it to unsigned char* and then compare byte by byte.

The cast lead me to think that this should work for non-ASCII (e.g. ANSI?), but given that there are multi-byte characters (e.g. UTF-8) depending on your encoding used, we may not assume that in the given encoding the characters order by their byte order?

But this compare function is not to order by the natural encoding order, but it's used to detect the '0' at the end of prefix, which orders before *any* unsigned char.

We cannot enhance starts_with for this case as we'd have to invert the return value to differentiate between the prefix ordering before or after the given string.

Essentially compare_prefix wants to provide the same return value as `strncmp(refname, prefix, min(strlen(refname), strlen(prefix)));` except that it is optimized as we do not have to walk over a string multiple times (to determine length and then pass it to compare).

Feel free to ignore the rambling, I just had to sort my thoughts. The patch looks good.

Thanks, Stefan

Show 41 quoted lines
> +
> +               refname++;
> +               prefix++;
> +       }
> +
> +       return 0;
> +}
> +
>  static int prefix_ref_iterator_advance(struct ref_iterator *ref_iterator)
>  {
>         struct prefix_ref_iterator *iter =
> @@ -294,9 +308,25 @@ static int prefix_ref_iterator_advance(struct ref_iterator *ref_iterator)
>         int ok;
>
>         while ((ok = ref_iterator_advance(iter->iter0)) == ITER_OK) {
> -               if (!starts_with(iter->iter0->refname, iter->prefix))
> +               int cmp = compare_prefix(iter->iter0->refname, iter->prefix);
> +
> +               if (cmp < 0)
>                         continue;
>
> +               if (cmp > 0) {
> +                       /*
> +                        * If the source iterator is ordered, then we
> +                        * can stop the iteration as soon as we see a
> +                        * refname that comes after the prefix:
> +                        */
> +                       if (iter->iter0->ordered) {
> +                               ok = ref_iterator_abort(iter->iter0);
> +                               break;
> +                       } else {
> +                               continue;
> +                       }
> +               }
> +
>                 if (iter->trim) {
>                         /*
>                          * It is nonsense to trim off characters that
> --
> 2.14.1
>
Previous: Michael HaggertyNext: Jeff King
Message 3 of 40 in “Read `packed-refs` using mmap()”
  1. 00/21 Read `packed-refs` using mmap()Michael Haggerty, Sep 19, 2017
  2. 02/21 prefix_ref_iterator: break when we leave the prefixMichael Haggerty, Sep 19, 2017
  3. Stefan BellerSep 20, 2017
  4. Jeff KingSep 21, 2017
  5. Stefan BellerSep 21, 2017
  6. Michael HaggertySep 21, 2017
  7. 04/21 die_unterminated_line(), die_invalid_line(): new functionsMichael Haggerty, Sep 19, 2017
  8. 05/21 read_packed_refs(): use mmap to read the `packed-refs` fileMichael Haggerty, Sep 19, 2017
  9. 08/21 read_packed_refs(): read references with minimal copyingMichael Haggerty, Sep 19, 2017
  10. Jeff KingSep 20, 2017
  11. Michael HaggertySep 21, 2017
  12. 09/21 packed_ref_cache: remember the file-wide peeling stateMichael Haggerty, Sep 19, 2017
  13. 10/21 mmapped_ref_iterator: add iterator over a packed-refs fileMichael Haggerty, Sep 19, 2017
  14. 11/21 mmapped_ref_iterator_advance(): no peeled value for broken refsMichael Haggerty, Sep 19, 2017
  15. Jeff KingSep 20, 2017
  16. 12/21 packed-backend.c: reorder some definitionsMichael Haggerty, Sep 19, 2017
  17. 13/21 packed_ref_cache: keep the `packed-refs` file mmapped if possibleMichael Haggerty, Sep 19, 2017
  18. Michael HaggertySep 19, 2017
  19. Junio C HamanoSep 24, 2017
  20. Jeff KingSep 20, 2017
  21. Jeff KingSep 20, 2017
  22. Michael HaggertySep 21, 2017
  23. 14/21 read_packed_refs(): ensure that references are ordered when readMichael Haggerty, Sep 19, 2017
  24. Jeff KingSep 20, 2017
  25. Michael HaggertySep 21, 2017
  26. Johannes SchindelinSep 25, 2017
  27. 15/21 packed_ref_iterator_begin(): iterate using `mmapped_ref_iterator`Michael Haggerty, Sep 19, 2017
  28. 18/21 packed_ref_store: get rid of the `ref_cache` entirelyMichael Haggerty, Sep 19, 2017
  29. 19/21 ref_cache: remove support for storing peeled valuesMichael Haggerty, Sep 19, 2017
  30. 16/21 packed_read_raw_ref(): read the reference from the mmapped bufferMichael Haggerty, Sep 19, 2017
  31. 20/21 mmapped_ref_iterator: inline into `packed_ref_iterator`Michael Haggerty, Sep 19, 2017
  32. 21/21 packed-backend.c: rename a bunch of things and update commentsMichael Haggerty, Sep 19, 2017
  33. 17/21 ref_store: implement `refs_peel_ref()` genericallyMichael Haggerty, Sep 19, 2017
  34. 06/21 read_packed_refs(): only check for a header at the top of the fileMichael Haggerty, Sep 19, 2017
  35. 07/21 read_packed_refs(): make parsing of the header line more robustMichael Haggerty, Sep 19, 2017
  36. 01/21 ref_iterator: keep track of whether the iterator output is orderedMichael Haggerty, Sep 19, 2017
  37. 03/21 packed_ref_cache: add a backlink to the associated `packed_ref_store`Michael Haggerty, Sep 19, 2017
  38. Johannes SchindelinSep 19, 2017
  39. Jeff KingSep 20, 2017
  40. Johannes SchindelinSep 25, 2017

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.