| .. | ||
| arrays.md | ||
| booleans.md | ||
| bytes.md | ||
| c-interoperability.md | ||
| command-line-parsing.md | ||
| compilation.md | ||
| enums.md | ||
| functions.md | ||
| integers.md | ||
| iterators.md | ||
| langs.md | ||
| libraries.md | ||
| metamethods.md | ||
| moments.md | ||
| mutexed.md | ||
| namespacing.md | ||
| nums.md | ||
| operators.md | ||
| optionals.md | ||
| paths.md | ||
| patterns.md | ||
| pointers.md | ||
| README.md | ||
| reductions.md | ||
| rng.md | ||
| serialization.md | ||
| sets.md | ||
| shell.md | ||
| structs.md | ||
| tables.md | ||
| text.md | ||
| threads.md | ||
Documentation
This is an overview of the documentation on Tomo.
Topics
A few topics that are documented:
- Compilation Pipeline
- Functions
- Libraries/Modules
- Namespacing
- Operator Overloading
- Special Methods
- C Interoperability
Types
Information about Tomo's built-in types can be found here:
- Arrays
- Booleans
- Bytes
- Moment
- Enums
- Floating point numbers
- Integers
- Languages
- Mutexed Data
- Paths
- Random Number Generators
- Sets
- Structs
- Tables
- Text
- Threads
Built-in Functions
ask
Gets a line of user input text with a prompt.
Signature:
func ask(prompt:Text, bold:Bool = yes, force_tty:Bool = yes -> Void)
prompt: The text to print as a prompt before getting the input.bold: Whether or not to print make the prompt appear bold on a console using the ANSI escape sequence\x1b[1m.force_tty: When a program is receiving input from a pipe or writing its output to a pipe, this flag (which is enabled by default) forces the program to write the prompt to/dev/ttyand read the input from/dev/tty, which circumvents the pipe. This means thatfoo | ./tomo your-program | bazwill still show a visible prompt and read user input, despite the pipes. Setting this flag tonowill mean that the prompt is written tostdoutand input is read fromstdin, even if those are pipes.
Returns:
A line of user input text without a trailing newline, or empty text if
something went wrong (e.g. the user hit Ctrl-D).
Example:
>> ask("What's your name? ")
= "Arthur Dent"
exit
Exits the program with a given status and optionally prints a message.
Signature:
func ask(message:Text? = !Text, status:Int32 = 1[32] -> Void)
message: If nonempty, this message will be printed (with a newline) before exiting.status: The status code that the program with exit with (default: 1, which is a failure status).
Returns:
This function never returns.
Example:
exit(status=1, "Goodbye forever!")
say
Prints a message to the console.
Signature:
func say(text:Text, newline:Bool = yes -> Void)
text: The text to print.newline: Whether or not to print a newline after the text.
Returns:
Nothing.
Example:
say("Hello ", newline=no)
say("world!")
sleep
Pause execution for a given number of seconds.
Signature:
func sleep(seconds: Num -> Void)
seconds: How many seconds to sleep for.
Returns:
Nothing.
Example:
sleep(1.5)
fail
Prints a message to the console, aborts the program, and prints a stack trace.
Signature:
func fail(message:Text -> Abort)
message: The error message to print.
Returns:
Nothing, aborts the program.
Example:
fail("Oh no!")
now
Gets the current time. This is an alias for Moment.now().
Signature:
func now(->Moment)
None.
Returns:
The current moment as a Moment.
Example:
>> now()
= Sun Sep 29 20:12:33 2024