Flashlight

Home

Documentation

Basic rules

Flashlight is called an interpreted programming language because it goes through an interpreter. It goes operation by operation. A flashlight command consists of the function sign, braces - and arguments inside of them, with semicolon at the end. Flashlight Interpreter will ignore every space, tab and new line character.

Flashlight comments:

#** one line comment **#
P{s{Text}};
#** 	multi
	line
	comment **#

Flashlight commands:

• P{val}
Prints values separated by comma.
Example:


P{
	s{Text},i{45},f{3.14}
};
P{s{Another},A{i{32}},s{text}};
P{s{JustOne}};

• s{val}
Returns string val will be interpreted as text (You cannot use a function here!)
Example:


P{
	s{text}
};

• i{val}
Returns number with type integer, val can be value or a function that returns a value that you want to convert to integer.
Example:


P{
	i{5},
	i{f{9.9}},
	+{i{2},i{U{s{Input=}}}}
};

• f{val}
Returns number with type float, val can be value or a function that returns a value that you want to convert to float.
Example:


P{
	f{5},
	f{9.9},
	+{f{2},f{U{s{Input=}}}}
};

• +{val1,val2,...}
Returns sum of values (integers or floats)
Example:


P{
	+{i{2},f{3.14},i{100}}
};

• -{val1,val2,...}
Returns the result of subtracting all subsequent values from the first given value.
R = val1-val2-val3-val3...
Example:


P{
	-{i{200},i{3},i{100}} #** returns 97 **#
};

• *{val1,val2,...}
Returns the result of multiplying all given values.
Example:


P{
	*{i{3},i{3}} #** returns 9 **#
};

• /{val1,val2,...}
Returns the result of dividing the first specified value by all subsequent values.
R = val1/val2/val3/val3...
Example:


P{
	/{i{9},i{3}} #** returns 3.0 **#
};

• %{val1,val2}
Returns the result of val1 mod val2.
Example:


P{
	%{i{9},i{2}} #** returns 1 **#
};

• A{val}
Returns character that has code val in ascii (val must be integer).
Example:


P{
	s{Text1},A{i{32}},s{Text2}
};

• O{val}
Returns ascii code as integer of val character.
Example:


P{
	O{s{x}}
};

• S{name,val}
Save val to variable called name
Example:


S{
	s{counter},i{0}
};

• R{name}
Returns value of variable called name
Example:


P{
	R{s{counter}}
};

• ?{val,op1,op2}
Returns value of selected operation, if val is true than returns op1 else op2
Example:


P{
	?{
		C{s{=},i{4},+{i{2},i{2}}},
		s{2+2=4},
		s{2+2<>4}
	}
};

• C{compare,val1,val2}
Returns boolean from comparation two values (compare must be string with choosen comparation [=,>,<,>=,<=,<>]).
Example:


P{
	C{s{>},i{1},i{5}} #** returns False **#
};

• &{val1,val2,...}
Returns boolean of logic AND of all given values.
Example:


P{
	&{i{1},i{5},i{0}} #** returns False **#
};

• |{val1,val2,...}
Returns boolean of logic OR of all given values.
Example:


P{
	|{i{1},i{5},i{0}} #** returns True **#
};

• .{val1,val2,...}
Returns string from concatenating all given values.
Example:


S{
	.{s{arr},R{s{counter}}},
	i{0}
};

• F{val}
Runs the code from string given as val.
Example:


S{	s{customFunction},
	s{
		S{ s{counter} , +{R{s{counter}}, i{1}} };
		P{
			R{s{counter}}
		};
	}
};
F{R{s{customFunction}}};

• W{condition,op}
While condition is True, do op.
Example:


S{
	s{counter},i{5}
};
W{
	R{s{counter}},
	F{s{
		P{
			_{ s{_} , A{i{32}} , s{Counter_is_greater_than_0} },
			A{i{10}}
		};
		S{s{counter},-{R{s{counter}},i{1}}};
	}}
};

• U{val}
Prints val and returns user input as a string.
Example:


S{ s{x}, i{U{s{x=}}} };
P{ s{5+x=}, +{i{5},R{s{x}}}};

• r{val}
Returns random integer from 0 to val-1
Example:


P{r{i{100}}};

• r{val1,val2}
Returns random integer from val1 to val2
Example:


P{r{i{1},i{10}}};

• L{val}
Returns length of string val
Example:


P{
	L{s{Text}} #** returns 4 **#
};

• G{val1,val2}
Returns character of string val1 at val2 position.
Example:


P{
	G{s{Text},i{2}} #** returns 'x' **#
};

• _{val1,val2,val3}
Returns changed string from replacing val1 to val2 in string val3.
Example:


P{
	_{s{l},s{X},s{Hello}} #** returns 'HeXXo' **#
};

• @{op,val}
Returns string with changed all characters to upper or lower. Argument op decides which function will be used. Use string 'upper' or 'lower'.
Example:


P{
	@{s{upper},s{Hello}} #** returns 'HELLO' **#
};

• @{op,val1,val2}
op='in'
Returns True if string val2 contains string val1 otherwise returns False.
Example:


P{
	@{s{in},s{ll},s{Hello}} #** returns True **#
};

• #{op,val}
op='r'
Returns text as string from file val
Example:


P{
	#{s{r},s{file.txt}}
};

• #{op,val1,val2}
op='w'
Writes text from val2 to file val1
Returns True if text was saved to file otherwise returns False. Example:


P{
	#{s{w},s{hello.txt},s{Hello}}
};