tomo/docs/booleans.md

1.2 KiB

Boolean Values

Boolean values have the type Bool and can be either yes ("true") or no ("false").

Boolean Functions

This documentation provides details on boolean functions available in the API.

from_text

Description:
Converts a string representation of a boolean value into a boolean. Acceptable boolean values are case-insensitive variations of yes/no, y/n, true/false, on/off.

Signature:

func from_text(text: Text -> Bool?)

Parameters:

  • text: The string containing the boolean value.

Returns:
yes if the string matches a recognized truthy boolean value; otherwise return no.

Example:

>> Bool.from_text("yes")
= yes?
>> Bool.from_text("no")
= no?
>> Bool.from_text("???")
= !Bool

random

Description:
Generates a random boolean value based on a specified probability.

Signature:

func random(p: Float = 0.5 -> Bool)

Parameters:

  • p: The probability (between 0 and 1) of returning yes. Default is 0.5.

Returns:
yes with probability p, and no with probability 1 - p.

Example:

>> Bool.random(70%)  // yes (with 70% probability)