module coretype booltype errortype intmodule cymodule mathmodule climodule ostype Filetype Dirtype DirIteratorTable ArgOptionmodule testBuiltin modules are the bare minimum that comes with Cyber. The embeddable library contains these modules and nothing more. They include:
module core #The core module contains functions related to Cyber and common utilities. It is automatically imported into each script's namespace.
Sample usage:
-- `print` and `typeof` are available without imports.
print 'hello'
print typeof('my str').id()
func copy(val any) anyCopies a primitive value or creates a shallow copy of an object value.
@@ -2768,18 +2772,12 @@core. #
If
valis an error,panic(val)is invoked. Otherwise,valis returned.
func panic(err any) dynamicStop execution in the current fiber and starts unwinding the call stack. See Unexpected Errors.
-
-
func parseCyber(src String) MapParses Cyber source string into structured map object. Currently, only metadata about static declarations is made available but this will be extended to include an AST.
-
-
func parseCyon(src String) anyParses a CYON string into a value.
func performGC() MapRuns the garbage collector once to detect reference cycles and abandoned objects. Returns the statistics of the run in a map value.
func print(str any)Prints a value. The host determines how it is printed.
func runestr(val int) StringConverts a rune to a string.
-
-
func toCyon(val any) StringEncodes a value to CYON string.
^topic @@ -3043,7 +3041,25 @@
func typeof(val any) metatypeReturns the value's type as a
metatypeobject.
type Box #type TccState #module cy #The cy module contains functions related to the Cyber language.
Sample usage:
+use cy
+print cy.toCyon([1, 2, 3])
++
func parse(src String) MapParses Cyber source string into a structured map object. Currently, only metadata about static declarations is made available but this will be extended to include an AST.
+
+
func parseCyon(src String) anyParses a CYON string into a value.
+
+
func repl(read_line any)Starts an isolated REPL session. The callback
+read_line(prefix String) Stringis responsible for obtaining the input.
+^topic ++
func toCyon(val any) StringEncodes a value to CYON string.
+
module math #The math module contains commonly used math constants and functions.
Sample usage:
use math
@@ -3051,6 +3067,7 @@ math. #
var r = 10.0
print(math.pi * r^2)
var e floatEuler's number and the base of natural logarithms; approximately 2.718.
@@ -3159,11 +3176,26 @@math. #
Std modules. #
Std modules come with Cyber's CLI. They include:
-
^topic -- os: System level functions.
-- test: Utilities for testing.
+- cli: Related to the command line.
+- os: System level functions.
+- test: Utilities for testing.
os. #
++
module cli#The
+climodule contains functions related to the command line.Sample usage:
++ + +use cli +cli.repl() ++
func repl()Starts an isolated REPL session. Invokes
+cy.repl(replReadLine).+^topic ++
func replReadLine(prefix String) StringDefault implementation to read a line from the CLI for a REPL.
+
module os#Cyber's os module contains system level functions. It's still undecided as to how much should be included here so it's incomplete. You can still access os and libc functions yourself using Cyber's FFI or embedding API.
Sample usage:
+use os @@ -3172,6 +3204,7 @@os. #
for map -> [k, v]: print "$(k) -> $(v)"
var cpu StringThe current cpu arch's tag name.
@@ -3320,7 +3353,7 @@
Map DirWalkEntry^topic
Table ArgOption#^topic -
key summary 'name' -> StringThe name of the option to match excluding the hyphen prefix. eg. -path'type' -> metatype(String | float | boolean)Parse as given value type. 'default' -> anyOptional: Default value if option is missing. noneis used if this is not provided.test. #
+
module test#The
testmodule contains utilities for testing.Sample usage:
+use t 'test' @@ -3328,6 +3361,7 @@test. #
var a = 123 + 321 t.eq(a, 444)
func assert(pred bool)Panics if
predisfalse.