Skip to main content

finditems​

finditems(
    @llll  ## required
    @items null
    @function null
    @size null
    @depth null
    @minidx 1
    @maxidx 1
    @idxreject 0
    @depthreject 0
    @maxcount 0
    @unwrap 0
    @depthpolicy 0
    @recursive 0
    @mindepth 1
    @maxdepth 1
) -> llll/null

Retrieves items from an llll. The return value is an llll composed by the retrieved items. An equality comparison function can be provided through the @function argument, , otherwise it performs a stardard comparison.

Arguments​

  • @llll [llll] (required)
  • @items [llll/null] (default: null)
  • @function [function/null] (default: null)
  • @size [llll/null] (default: null)
  • @depth [int/llll/null] (default: null)
  • @minidx [int] (default: 1)
  • @maxidx [int] (default: 1)
  • @idxreject [llll] (default: 0)
  • @depthreject [int] (default: 0)
  • @maxcount [llll] (default: 0)
  • @unwrap [llll] (default: 0)
  • @depthpolicy [int] (default: 0)
  • @recursive [llll] (default: 0)
  • @mindepth [int] (default: 1)
  • @maxdepth [int] (default: 1)

Output​

Found elements, if any. [llll/null]

warning

finditems is a built-in function in the bell programming language and is not unique or exclusive to bellplay~. As such, finditems will return null without raising an error if required arguments are not provided.