Following functions and variables that "live" in global namespace so they accessible in script without any namespace designator, e.g.
var r = eval( " 348.0 / 23.7 " ); stdout.printf( "%f" , r );
Evaluates (interprets) input and returns its value. If input is a string then function tries to interpret it as if it contains script source code. If input is a stream object then it compiles and executes source code from it.
Example: after execution of the following:
var obj = eval( "({ one:1, two:2 })" );
variable obj will contain object having two fields: one and two.
environment is an environment object - if provided then script execution takes place in the namespace of that object.
var env = { one:1, two:2 };
var res = eval( "one + two", env);
environments is a list of objects - environments - element with index 0 is inmost environment.
These functions available only if host application configured the engine to use them.
a.k.a. JSON++ data parser.
Evaluates (interprets) data literal at the input and returns its value. Input shall contain valid data literal expression otherwise parsing exception will be thrown.
Example 1: after execution of the following:
var obj = parseData( " { one:1, two:2 } " );
variable obj will contain object having two fields: one and two.
var v = parseData( "3.1415926" );
variable v will contain float number 3.1415926 - parsed value of the string.
Main difference from the eval function is that parseData will not parse and execute any function declarations or functions so it is safe to use this function when data is coming from unknown sources e.g. in AJAX like of interactions.
Evaluates the input stream in serverScript mode (see below) and emits result to the output stream. Function assumes that executable script at the input is contained in <% %> brackets. Function returns result of first standalone return statement in the input stream.
env is an environment object, it allows to pass parameters to the input script from the caller.
Loads (compiles and executes) source. Source here either string - file name or stream object. If asServerScript provided and equals to true then source is interpreted as a text with embedded script like PHP or ASP web page:
<html> ... <% =some_script_function(); %>... </html>
These two fragments:
load( "c:/myscripts/test.tis" );
and
var s = Stream.openFile("c:/myscripts/test.tis","r"); load( s );
are equivalent.
Script execution takes place in the namespace of the caller of the function.
Loads compiled bytecodes defined by source. Source here either string - file name or stream object.
Calls built-in compiler to compile input. Writes output bytecodes into out stream or file. Bytecodes can be loaded (executed) later by loadbc function.
Stores the value into file filename or stream in binary form. Returns true if data was stored successfully.
Restores value previously written into the file (filename) or stream by function store. Returns value or null if operation failed.
Stringizier function, returns absolute URL composed from URL of this script file and the
Example:
// this file.tis is at "this://app/widgets/dialog.tis" var componentsCss = $url(../styles/components.css); assert componentsCss == "this://app/styles/components.css";
Returns hash value of its argument.
( obj: object | function ) : map (object) is to be used in for( var (k,v) in membersOf(obj))
function Foo() { ... }
Foo.bar = 1; // adding property 'bar' to the
// Foo function (that is an object too)
for(var (k,v) in Foo )
... // here you should see k equal to #bar
// on some iteration
Returns map (simple object) that has the same set of properties as the obj. Main purpose of membersOf is to be used in for( var (k,v) in membersOf(obj)) alike enumerations to scan properties of entities that have different semantic of enumeration than in instances of Object. Example:
function Foo() { ... }
Foo.bar = 1; // adding property 'bar' to the
// Foo function (that is an object too)
for(var (k,v) in Foo )
... // here you should see k equal to #bar
// on some iteration
( maxNumber : integer
Returns a random number between 0 and maxNumber-1. number of bytes from the system.
Invokes garbage collector and returns: total VM heap memory size, size of free area in the heap and size of used area by the script. total = free + used;
If factor is provided then the engine will try to reclaim allocated heap using the following rules:
Recommended value is 1.
Note that VM requests twice as total number of bytes from the system.
Parses the url string. Returns an object having following fields:
Function returns symbol of the string. Internally symbol is 32bit value so symbol space is limited - it makes no sense to "symbolize" arbitrary strings. function constructs color value from red, green, blue and opacity components or by parsing colorStr that can be #RRGGBB or name of the CSS color.
bopacityThe color function constructs color value from red, green, blue and opacity components or by parsing colorStr that can be #RRGGBB or name of the CSS color.
Produces canonical JSON string representation.
If the replacer is a function (key, value) then it gets called for each key / value pair. The function shall return JSON compatible value. If replacer is an array , only members with key values in the array will be converted. The order in which the members are converted is the same as the order of the keys in the array. The replacer array is ignored when the value argument is also an array.
If space is a string then all \t characters in output are replaced by that string. If it is a number then all \t characters get replaced by that number of spaces.
Parses JSON string. The reviver is a function (key, value): value or function (key, value): (key,value) - allows to transform parsed into another value or key/value pair.
Contains functions designated to work with URLs:
The function parses url and returns object containing URL components:
Makes url relative to baseUrl. So for:
http://example.com/foo/bar.htm andhttp://example.com/zar/laf.htm#locationthe function returns ../zar/laf.htm#location
The function combines relative URL with base (absolute) URL.
The function encodes all non-url characters, space for example will be replaced by %20 , etc.
The function encodes all characters except the following: alphabetic, decimal digits, - _ . ! ~ * ' ( )
The function decodes URL encoded string to its original form.
The function converts "file://..." string to a path to file - path string suitable for target platform.
The function converts path (like C:\User\Desktop) to file URL (like file://C:/User/Desktop).