Also, 'needle' presumably refers to finding a needle in a haystack (https://dictionary.cambridge.org/dictionary/english/needle-in-a-haystack), where the list is the haystack!

The use of this term is probably paying homage to the C run-time library's strstr() function (and friends):

STRSTR(3)                                            Library Functions Manual                                           STRSTR(3)

NAME
     strstr, strcasestr, strnstr – locate a substring in a string

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <string.h>
     char *strstr(const char *haystack, const char *needle);
...

DESCRIPTION
     The strstr() function locates the first occurrence of the null-terminated string needle in the null-terminated string
     haystack.


On Thu, 20 Oct 2022 at 17:50, Albert Krewinkel <albert+pandoc-9EawChwDxG8hFhg+JK9F0w@public.gmane.org> wrote:

perro tuerto <nika.zhenya-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> Hi, I am trying to understand how to implement pandoc.List:find,
> pandoc.List:find_if, pandoc.List:filter and pandoc.List:includes but
> I don't understand what does “needle“ or “pred” mean. Can I see some
> examples of how to use these methods? Thanks

You are right, some examples would help to improve the docs.

The test suite for lists contains some code that might help here:
https://github.com/hslua/hslua/blob/main/hslua-list/test/test-list.lua
E.g., for `find` see lines 79 ff.

--
Albert Krewinkel
GPG: 8eed e3e2 e8c5 6f18 81fe  e836 388d c0b2 1f63 1124

--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org.
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/878rlao2x9.fsf%40zeitkraut.de.

--
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org.
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAEe_xxgZQvkNRsOD5JTTumPgWFKQPJNfitDAGM-mPLGVg6FSUg%40mail.gmail.com.