Skip to main content

contains

contains(
@llll ? ## required
@depth ? ## required
@mindepth 1
@maxdepth 1
) -> llll/null
note

contains is a built-in function in the bell programming language and is not unique or exclusive to bellplay~.

Returns a summary of the data types contained in an llll. The return value is encoded as a bit field, with the following values:

  • 1: null
  • 2: integer
  • 4: rational
  • 8: double (float)
  • 16: symbol
  • 32: sublist
  • 256: pitch.

By default, only the contents of the root level are considered. This can be changed with the @mindepth and @maxdepth arguments.


Arguments

  • @llll [llll] (required)
  • @depth [int/llll/null] (required)
  • @mindepth [int] (default: 1)
  • @maxdepth [int] (default: 1)

Output

Summary of the data types contained in an llll. [llll/null]

warning

contains will return null without raising an error if required arguments are not provided.