Skip to main content

alter​

alter(
    @x ? ## required
) -> llll/null
note

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

Returns the difference, in tones, between the pitch value of @x and its diatonic pitch name.

Arguments​

  • @x [int/float/llll] Numeric llll.(required)

Output​

Difference in tones [llll/null]

warning

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

Usage​

alter(Db4) ## returns -1/2