triptico.com

Un naufragio personal

The Filp Command Reference

This reference documents version 1.0.0-rc4-dev of the Filp Programming Language.

By Category

Array commands

Boolean commands

Code execution commands

Control structures

Documentation commands

File and directory commands

List processing commands

Math commands

Output commands

Special commands

Special constants

Special variables

Stack manipulation commands

String manipulation commands

Symbol management commands

System commands

By Source

filp_lib.c

filp_slib.c

Alphabetical

  • ARGV - Array of command-line arguments.
  • NULL - Stores a NULL value on the top of stack.
  • STDERR - Standard error file descriptor.
  • STDIN - Standard input file descriptor.
  • STDOUT - Standard output file descriptor.
  • abseek - Seeks a sorted array for a scalar.
  • add - Math sum.
  • adel - Deletes an element from an array.
  • adump - Dumps an array as a list.
  • aget - Gets an element from an array.
  • ains - Inserts a value into an array.
  • and - Boolean and.
  • array - Creates an array.
  • aseek - Seeks an array for a scalar.
  • aset - Assigns a value to an element of an array.
  • asort - Sorts an array.
  • bread - Reads a block of bytes from a file.
  • bwrite - Writes a block of bytes to a file.
  • chop - Chops the last character of a string.
  • close - Closes a file.
  • defined - Tests if a symbol is defined.
  • div - Math division.
  • dumper - Dumps a value (probably an array) as a tree.
  • dup - Duplicates the value in the top of stack.
  • dupnz - Duplicates the value in the top of stack if true.
  • enum - Defines a group of constants.
  • eq - String equality test.
  • errno - The C library errno variable.
  • eval - Executes a value as filp code and returns its error code.
  • exec - Executes a value as filp code.
  • false - Stores a false value on the top of stack.
  • filp_arch - Architecture id string.
  • filp_bareword - Use of barewords flag.
  • filp_compile_date - Compilation date.
  • filp_compile_options - Compilation options information.
  • filp_compile_time - Compilation time.
  • filp_error - Last error code.
  • filp_error_info - Text info about the last error.
  • filp_error_strings - Array of error strings.
  • filp_lang - Two letter code of the preferred language.
  • filp_real - Use of real numbers instead of integers flag.
  • filp_stack_elems - Number of elements currently in the stack.
  • filp_stack_size - Maximum size of the stack.
  • filp_uname - Operating system information.
  • filp_version - Version of filp.
  • for - Executes a block incrementing a value.
  • forall - Executes a block of code for all elements of the array
  • foreach - Executes a block of code for each element of a list.
  • getdoc - Gets documentation from a symbol.
  • getenv - Obtains the value of an environment string.
  • glob - Returns a list with a file expansion set.
  • gt - String 'greater than' test.
  • idup - Duplicates a specific value from the stack.
  • if - Conditional execution of code.
  • ifelse - Conditional execution of code.
  • index - Extract an element from a list by subscript.
  • instr - Search a string inside another.
  • join - Joins a list into a string.
  • length - Returns the length of a string.
  • license - Returns the filp license.
  • load - Loads a filp source code file and executes it.
  • loop - The infinite loop.
  • lsize - Returns the size of a list.
  • lt - String 'lower than' test.
  • map - Executes a block of code for all elements of the array modifying
  • mkdir - Creates a directory.
  • mod - Math modulo.
  • mul - Math multiply.
  • open - Opens a file.
  • or - Boolean or.
  • pop - Drops a value from the top of stack.
  • print - Prints a value to the standard output.
  • printwn - Prints a value to the standard output without newline.
  • putenv - Sets the value of an environment string.
  • read - Reads a line from a file.
  • regex - Matches a POSIX regular expression.
  • repeat - Executes a block of code a number of times.
  • reverse - Reverses a list.
  • rot - Rotates the stack.
  • safe - Enters isolate mode
  • seek - Seeks an element in a list.
  • set - Sets the value of a symbol.
  • setdoc - Set documentation for a symbol.
  • shell - Executes an external program.
  • size - Returns the size of a value.
  • sort - Sorts a list.
  • split - Splits a string into substrings.
  • sprintf - Formats into a string.
  • sscanf - Scans a string and extracts values.
  • strcat - Concatenates two strings.
  • strerror - Returns the system error string.
  • sub - Math substraction.
  • substr - Extracts a substring.
  • swap - Swaps the two values on top of the stack.
  • sweep - Collects garbage.
  • switch - Multiple conditional execution.
  • swstack - Swaps between the two stacks.
  • symbol - Sends symbol names to the stack.
  • time - Returns the time in seconds.
  • timer - millisecond timer
  • tpop - Stores the top of stack into the temporal variable.
  • tpush - Pushes the temporal variable to the stack.
  • true - Stores a true value on the top of stack.
  • type - Returns a string describing the type of a value.
  • unless - Conditional execution of code.
  • unset - Undefines a variable.
  • val - Returns the value of a symbol.
  • while - Conditional loop.
  • write - Writes a string to a file.

ARGV

Name

ARGV - Array of command-line arguments.

Synopsis

 ARGV 

Description

This array contains the command-line arguments when used from the filp interpreter, or an empty array if used from an embedded version of the filp library.

Categories

NULL

Name

NULL - Stores a NULL value on the top of stack.

Synopsis

 NULL NULL 
 [ NULL 
 ( NULL 

Description

Stores a NULL value on the top of stack. Though [ is used as a delimiter for lists and ( for arrays, in practice all of them are the same.

Categories

STDERR

Name

STDERR - Standard error file descriptor.

Synopsis

 STDERR 

Description

This is the standard error file descriptor.

Categories

STDIN

Name

STDIN - Standard input file descriptor.

Synopsis

 STDIN 

Description

This is the standard input file descriptor.

Categories

STDOUT

Name

STDOUT - Standard output file descriptor.

Synopsis

 STDOUT 

Description

This is the standard output file descriptor.

Categories

abseek

Name

abseek - Seeks a sorted array for a scalar.

Synopsis

 array scalar abseek subscript 

Arguments

array
the array to be searched into
scalar
the value to be found

Description

Seeks a sorted array in search of a string. Returns the subscript where the scalar is if positive, or the position where it should be if negative.

Categories

add

Name

add - Math sum.

Synopsis

 op1 op2 add result 
 op1 op2 + result 

Arguments

op1
first operand
op2
second operand

Description

Sums both values and sends the result to the stack. If filp_real is set, the operation is made in real mode, or integer otherwise.

Categories

adel

Name

adel - Deletes an element from an array.

Synopsis

 array_symbol subscript adel 
 array subscript adel modified_array 

Arguments

array
the array or array symbol
subscript
subscript of the element to be deleted

Description

Deletes an element from an array. The array shrinks. If subscript is zero, the last element is deleted and if it's out of range, nothing happens.

Categories

adump

Name

adump - Dumps an array as a list.

Synopsis

 array adump [ array_elements ] 

Arguments

array
the array to be dumped.

Description

Dumps an array as a list.

Categories

aget

Name

aget - Gets an element from an array.

Synopsis

 array subscript @ element 
 array subscript aget element 

Arguments

array
the array
subscript
the number of the element to be taken

Description

Gets the element number subscript from the array. If subscript is out of range, NULL is returned instead. The array subscripts in filp starts at 1; the 0 element contains the total number of elements in the array.

Categories

ains

Name

ains - Inserts a value into an array.

Synopsis

 array_symbol subscript value ains 
 array subscript value ains modified_array 

Arguments

array
the array or array symbol
subscript
the subscript number of the insertion position
value
the value to be inserted

Description

Inserts a value into the subscript position of an array. The elements with greater subscripts move up one position, incrementing the total size of the array by 1. Remember that the array subscripts in filp start at 1. If the subscript is 0 (array size), the element is added to the end.

Categories

and

Name

and - Boolean and.

Synopsis

 bool1 bool2 and bool_result 
 bool1 bool2 && bool_result 

Arguments

bool1
first boolean value.
bool2
second boolean value.

Description

Returns true if both values are true. The command && can be used as a synonym.

Categories

array

Name

array - Creates an array.

Synopsis

 ( value value ... ) new_array 
 ( value value array new_array 

Arguments

value
values that are part of the array.

Description

Creates an array. The ) character can be used as a synonym, and it's preferred as it's more intuitive. The new array value is left on the top of stack, ready to be asigned or used.

Categories

aseek

Name

aseek - Seeks an array for a scalar.

Synopsis

 array scalar aseek subscript 

Arguments

array
the array to be searched into
scalar
the value to be found

Description

Seeks an array in search of a string. Returns the subscript where the scalar is, or 0 if not found.

Categories

aset

Name

aset - Assigns a value to an element of an array.

Synopsis

 array_symbol subscript value aset 
 array subscript value aset modified_array 

Arguments

array
the array or array symbol
subscript
the subscript number to be asigned
value
the value to be set

Description

Assigns a value to the element subscript of an array. Remember that the array subscripts in filp start at 1. The @= command can be used as a synonym.

Categories

asort

Name

asort - Sorts an array.

Synopsis

 array_symbol asort 
 array asort sorted_array 

Arguments

array
array or array symbol to be sorted

Description

Sorts (alfabetically) an array.

Categories

bread

Name

bread - Reads a block of bytes from a file.

Synopsis

 size fdes bread size data 

Arguments

size
number of bytes to be read
fdes
file descriptor

Description

Reads a block of bytes from a file. The block of data and its size is returned. On EOF, the returned size will be zero.

Categories

bwrite

Name

bwrite - Writes a block of bytes to a file.

Synopsis

 size data fdes bwrite 

Arguments

size
size of the block of data
data
the block of data
fdes
the file descriptor

Description

Writes a block of bytes to a file.

Categories

chop

Name

chop - Chops the last character of a string.

Synopsis

 string chop strin 

Arguments

string
the string to be chopped

Description

Chops the last character of a string. Mainly to be used to cut the trailing \n character of a line read from a file.

Categories

close

Name

close - Closes a file.

Synopsis

 fdes close 

Arguments

fdes
file descriptor to be closed.

Description

Closes a file.

Categories

defined

Name

defined - Tests if a symbol is defined.

Synopsis

 symbol defined bool_result 

Arguments

symbol
the symbol name to be tested

Description

Returns a boolean value telling whether the symbol is defined or not.

Categories

div

Name

div - Math division.

Synopsis

 divd divs div result 
 divd divs / result 

Arguments

divd
dividend
divs
divisor

Description

Divides divd by divs and sends the result to the stack. If filp_real is set, the operation is made in real mode, or integer otherwise.

Categories

dumper

Name

dumper - Dumps a value (probably an array) as a tree.

Synopsis

 value dumper value_tree 

Arguments

value
the value to be dumped

Description

Dumps a value (probably an array) as a filp-parseable tree.

dup

Name

dup - Duplicates the value in the top of stack.

Synopsis

 value dup value value 

Arguments

value
the value to be duplicated

Description

Duplicates the value in the top of stack.

Categories

dupnz

Name

dupnz - Duplicates the value in the top of stack if true.

Synopsis

 value dupnz value value 

Arguments

value
the value to be duplicated

Description

Duplicates the value in the top of stack if it has a 'true' value.

Categories

enum

Name

enum - Defines a group of constants.

Synopsis

 [ list_elements ] first enum 

Arguments

list
the list of constants to set
first
the value of the first element

Description

Defines a group of constants. The first (deeper in the stack) will have a value of first and so on, increasingly.

Categories

eq

Name

eq - String equality test.

Synopsis

 string1 string2 eq bool_value 

Arguments

string1
the first string
string2
the second string

Description

Compares the two strings and returns true if both are equal.

Categories

errno

Name

errno - The C library errno variable.

Synopsis

 errno 

Description

This variable contains the C library errno variable.

Categories

eval

Name

eval - Executes a value as filp code and returns its error code.

Synopsis

 value eval error_code 

Arguments

value
value to be executed

Description

Executes a value as filp code. It can be a string or a block of code. The error code will be put on the top of stack, and the execution is never interrupted.

Categories

exec

Name

exec - Executes a value as filp code.

Synopsis

 value exec 

Arguments

value
value to be executed

Description

Executes a value as filp code. It can be a string or a block of code.

Categories

false

Name

false - Stores a false value on the top of stack.

Synopsis

 false false_value 

Description

Stores a conditional value equal to 'false' on the top of stack.

Categories

filp_arch

Name

filp_arch - Architecture id string.

Synopsis

 filp_arch 

Description

This string contains 'linux' if filp is running under any flavour of linux, 'win32' if under any flavour of MS Windows, 'beos' if under BeOS or 'unix' otherwise.

Categories

filp_bareword

Name

filp_bareword - Use of barewords flag.

Synopsis

 filp_bareword 

Description

If this flag is set, barewords (not-quoted words that are not recognized as commands) are treated as literal strings. Barewords are dangerous and hard to debug. Don't use it.

Categories

filp_compile_date

Name

filp_compile_date - Compilation date.

Synopsis

 filp_compile_date 

Description

This string contains the date of compilation of the filp library.

Categories

filp_compile_options

Name

filp_compile_options - Compilation options information.

Synopsis

 filp_compile_options 

Description

This string contains human-readable information about possible compilation options or limitations.

Categories

filp_compile_time

Name

filp_compile_time - Compilation time.

Synopsis

 filp_compile_time 

Description

This string contains the time of compilation of the filp library.

Categories

filp_error

Name

filp_error - Last error code.

Synopsis

 filp_error 

Description

This variable contains the last error code. Can be used as an offset to the filp_error_strings filp array.

Categories

filp_error_info

Name

filp_error_info - Text info about the last error.

Synopsis

 filp_error_info 

Description

This string contain additional info about the last error.

Categories

filp_error_strings

Name

filp_error_strings - Array of error strings.

Synopsis

 filp_error_strings 

Description

This array contains the message associated to an error message contained in filp_error.

Categories

filp_lang

Name

filp_lang - Two letter code of the preferred language.

Synopsis

 filp_lang 

Description

This variable contains the two letter code of the preferred language defined by the user. It mainly takes its value from the LANG environment variable, but other sources (mainly for win32) are tried as well.

Categories

filp_real

Name

filp_real - Use of real numbers instead of integers flag.

Synopsis

 filp_real 

Description

This flag tells filp if it must perform mathematical operations using integers (by default) or real numbers.

Categories

filp_stack_elems

Name

filp_stack_elems - Number of elements currently in the stack.

Synopsis

 filp_stack_elems 

Description

The number of elements currently stored in the stack.

Categories

filp_stack_size

Name

filp_stack_size - Maximum size of the stack.

Synopsis

 filp_stack_size 

Description

The maximum number of values the stack is allowed to store. By default is 16384. Just to avoid mad code from devouring all the available memory.

Categories

filp_uname

Name

filp_uname - Operating system information.

Synopsis

 filp_uname 

Description

This string contains human-readable information about the operating system filp is running on.

Categories

filp_version

Name

filp_version - Version of filp.

Synopsis

 filp_version 

Description

This string holds the current version of filp.

Categories

for

Name

for - Executes a block incrementing a value.

Synopsis

 from inc to code_block for 

Arguments

from
initial value
inc
increment to the value
to
final value

Description

Executes the block of code, sending previously a value to the stack. This value ranges from the initial from value, being incremented by inc until to (inclusive). The block of code must take this value from the stack.

Categories

forall

Name

forall - Executes a block of code for all elements of the array

Synopsis

 array { code } forall 

Arguments

array
the array
code
the code to be executed

Description

Executes a block of code for each element of array after pushing each one to the stack. The code block must take the values from the top of stack on each iteration.

Categories

foreach

Name

foreach - Executes a block of code for each element of a list.

Synopsis

 [ list_elements ... ] code_block foreach 

Arguments

list_elements
the list elements
code_block
block of code

Description

Executes a block of code for each element of a list, that is, until there is a NULL in the top of stack. The code block must take the values from the top of stack on each iteration. The NULL value is automatically dropped.

Categories

getdoc

Name

getdoc - Gets documentation from a symbol.

Synopsis

 symbol getdoc documentation_string 

Arguments

symbol
the symbol

Description

Gets documentation from a symbol. If it hasn't any, it's name is returned instead.

Categories

getenv

Name

getenv - Obtains the value of an environment string.

Synopsis

 envvar getenv value 

Arguments

envvar
the environment string name.

Description

Obtains the value of an environment string (as PATH or HOME). Returns the value or NULL if the variable does not exist.

Categories

glob

Name

glob - Returns a list with a file expansion set.

Synopsis

 filespec glob [ file_list ] 

Arguments

filespec
the filespec

Description

Returns a list with all the files that matches the filespec expression. This filespec is system dependent, but any combination of characters plus * or ? should work in all systems. The directory separator is /, though \ can also be used on MS Windows; anyway, the output list will always have / separators, that can also be used in all supported systems as an argument for open() or similar.

Categories

gt

Name

gt - String 'greater than' test.

Synopsis

 string1 string2 gt bool_value 

Arguments

string1
the first string
string2
the second string

Description

Compares the two strings and returns true if the first one is greater (in ASCII) than the second one.

Categories

idup

Name

idup - Duplicates a specific value from the stack.

Synopsis

 val#i val#i-1 ... val#1 i idup val#i 

Arguments

i
the position number of the value to be duplicated.

Description

Creates a copy of the element number i from the stack, and leaves it in the first position. Stack elements start from 1.

Categories

if

Name

if - Conditional execution of code.

Synopsis

 bool code_block if 

Arguments

bool
boolean value
code_block
code block to execute

Description

Executes the block of code if bool is true.

Categories

ifelse

Name

ifelse - Conditional execution of code.

Synopsis

 bool code_block_true code_block_false ifelse 

Arguments

bool
boolean value
code_block_true
code block to execute when bool is true
code_block_false
code block to execute when bool is false

Description

Executes the first block of code if bool is true or the second if false.

Categories

index

Name

index - Extract an element from a list by subscript.

Synopsis

 [ elements_of_list ] offset index value 

Arguments

elements_of_list
the elements of the list
offset
offset of the element to be extracted

Description

Extract the element number offset from the list, and puts it on the top of stack. If the offset is out of range (i.e. there are less elements in the list), NULL is returned instead.

Categories

instr

Name

instr - Search a string inside another.

Synopsis

 string substring instr offset 

Arguments

string
the string to be searched into
substring
the substring to be searched

Description

Search a substring inside a string. If it's found, the offset is returned, or 0 instead. Remember that string offsets start from 1.

Categories

join

Name

join - Joins a list into a string.

Synopsis

 [ list_elements ] joiner join string 

Arguments

joiner
the joiner string
list_elements
the elements of the list

Description

Joins a list into a string, using the string joiner as a glue.

Categories

length

Name

length - Returns the length of a string.

Synopsis

 string length len 

Arguments

string
the string

Description

Returns the length of the string.

Categories

license

Name

license - Returns the filp license.

Synopsis

 license license_text 

Description

Returns a text string containing the license of the filp library (The GNU Public License, GPL).

Categories

load

Name

load - Loads a filp source code file and executes it.

Synopsis

 file_name load 

Arguments

file_name
the name of the file to be executed.

Description

Loads a filp source code file and executes it.

Categories

loop

Name

loop - The infinite loop.

Synopsis

 code_block loop 

Arguments

code_block
the block of code to execute eternally

Description

Executes code_block until the end of times.

Categories

lsize

Name

lsize - Returns the size of a list.

Synopsis

 [ list_elements ] lsize number 

Arguments

list
the list

Description

Returns the number of elements of a list.

Categories

lt

Name

lt - String 'lower than' test.

Synopsis

 string1 string2 lt bool_value 

Arguments

string1
the first string
string2
the second string

Description

Compares the two strings and returns true if the first one is lower (in ASCII) than the second one.

Categories

map

Name

map - Executes a block of code for all elements of the array modifying

Synopsis

 array_symbol { code } map 
 array { code } map modified_array 

Arguments

array
the array or array symbol
code
the code to be executed

Description

Executes a block of code for each element of array after pushing each one to the stack. At the end of the block, the value in the top of stack will be assigned to the element. If array is an immediate value (i.e. not a symbol), the modified array is left on the stack.

Categories

mkdir

Name

mkdir - Creates a directory.

Synopsis

 dirname mkdir 

Arguments

dirname
directory name

Description

Creates a directory.

Categories

mod

Name

mod - Math modulo.

Synopsis

 divd divs mod remainder 
 divd divs % remainder 

Arguments

divd
dividend
divs
divisor

Description

Divides divd by divs and sends the remainder to the stack. This operation is always made in integer mode regardless of the value of filp_real.

Categories

mul

Name

mul - Math multiply.

Synopsis

 op1 op2 mul result 
 op1 op2 * result 

Arguments

op1
first operand
op2
second operand

Description

Multiplies both values and sends the result to the stack. If filp_real is set, the operation is made in real mode, or integer otherwise.

Categories

open

Name

open - Opens a file.

Synopsis

"filename" open fdes ">filename" open fdes ">>filename" open fdes "+filename" open fdes "+>filename" open fdes "|program" open fdes "program|" open fdes

Arguments

filename
the name of the file to be opened.

Description

Opens a file. If no prefix is used, the file is open for reading; The valid prefixes are: '>', open for writing; '>>', open for appending; '+', reading and writing, positioned in the beginning; '+>', reading and writing, truncating; '|', treat the file name as a program which standard input will be the file. The valid suffixes are: '|', treat the file name as a program which standard output will be the file. Pipes doesn't work in MS Windows by now. Returns a file descriptor, or NULL if file could not be opened.

Categories

or

Name

or - Boolean or.

Synopsis

 bool1 bool2 or bool_result 
 bool1 bool2 || bool_result 

Arguments

bool1
first boolean value.
bool2
second boolean value.

Description

Returns true if any value are true. The command || can be used as a synonym.

Categories

pop

Name

pop - Drops a value from the top of stack.

Synopsis

 value pop 

Arguments

value
the value to be dropped

Description

Drops a value from the top of stack. The value is destroyed.

Categories

print

Name

print - Prints a value to the standard output.

Synopsis

 value print 
 value ? 

Arguments

value
value to be printed

Description

Prints a value to the standard output followed by a newline (\n). The command ? can be used as a synonym.

Categories

printwn

Name

printwn - Prints a value to the standard output without newline.

Synopsis

 value printwn 
 value ?? 

Arguments

value
value to be printed

Description

Prints a value to the standard output. The command ?? can be used as a synonym.

Categories

putenv

Name

putenv - Sets the value of an environment string.

Synopsis

 envvar value putenv 

Arguments

envvar
the environment string name
value
the scalar value to be stored

Description

Sets the value of an environment string.

Categories

read

Name

read - Reads a line from a file.

Synopsis

 fdes read line 

Arguments

fdes
file descriptor

Description

Reads a line from a file. Returns the line or NULL on EOF.

Categories

regex

Name

regex - Matches a POSIX regular expression.

Synopsis

 str re =~ bool_value 
 str re regex bool_value 

Arguments

re
string containing the regular expression
str
the string to test

Description

Tests if str matches the re POSIX regular expression. Returns true if the string matches. See the regex(7) man page for more information about POSIX regular expressions.

Categories

repeat

Name

repeat - Executes a block of code a number of times.

Synopsis

 times code_block repeat 

Arguments

times
number of repetitions
code_block
block of code to execute

Description

Executes a block of code a number of times.

Categories

reverse

Name

reverse - Reverses a list.

Synopsis

 [ elem-1 elem-2 ... elem-n ] reverse [ elem-n ... elem-2 elem-1 ] 

Arguments

elem-1
elements of the list

Description

Reverses a list.

Categories

rot

Name

rot - Rotates the stack.

Synopsis

 val#i val#i-1 ... val#1 i rot val#i-1 ... val#1 val#i 

Arguments

i
the element number from where the stack will be rotated.

Description

Rotates the stack. The element number i moves to the top of the stack, shifting all the upper ones one position down.

Categories

safe

Name

safe - Enters isolate mode

Synopsis

 safe 

Description

Enters isolate mode, so all potentially dangerous commands as file access, environment variable definitions and external command executions are disabled. There is no turning back. When executed inside an 'eval' code, isolate mode operates only inside it.

seek

Name

seek - Seeks an element in a list.

Synopsis

 [ elements_of_list ] value seek offset 

Arguments

elements_of_list
elements of the list
value
value to be searched for

Description

Seeks an element in the list. If the element is found, its offset is returned on the top of stack; in not, 0 is returned instead. Take note that list elements are numbered from 1.

Categories

set

Name

set - Sets the value of a symbol.

Synopsis

 variable content set 
 variable content def 
 variable content = 
 command { content } set 

Arguments

symbol
symbol name
content
content to be stored in the symbol

Description

Sets the value of a symbol. If the content is code surrounded by { } , the symbol is marked as executable and becomes a command, otherwise it will be a plain variable. The commands def and = can be used as synonyms of set.

Categories

setdoc

Name

setdoc - Set documentation for a symbol.

Synopsis

 documentation_string symbol setdoc 

Arguments

documentation_string
String to be associated to the symbol
symbol
the symbol

Description

Stores documentation for a symbol.

Categories

shell

Name

shell - Executes an external program.

Synopsis

 program shell output_from_program 

Description

Executes an external program and sends all of its output to the stack.

Categories

size

Name

size - Returns the size of a value.

Synopsis

 value size size_in_bytes 

Arguments

value
the value which size is queried

Description

Returns the size in bytes of the value. Note that this number is not necessary the same as the length.

Categories

sort

Name

sort - Sorts a list.

Synopsis

 [ list_elements ] sort [ sorted_elements ] 

Arguments

list
the list

Description

Sorts a list.

Categories

split

Name

split - Splits a string into substrings.

Synopsis

 string separator split [ string_slices ] 

Arguments

string
the string to be splitted
separator
the separator

Description

Splits a string into a list by the separator. If separator is an empty string, string is splitted by char.

Categories

sprintf

Name

sprintf - Formats into a string.

Synopsis

 value [ value ... ] format_string sprintf result_string 

Arguments

value
values to be inserted
format_string
printf style formatting string

Description

Makes a printf() -like formatting into a string. As in that function, the percent char is used as a placeholder for a formatting command.

Categories

sscanf

Name

sscanf - Scans a string and extracts values.

Synopsis

 string format_string sscanf value1 value2 ... 

Arguments

string
the string to be scanned
format_string
the format string

Description

Scans a string and extracts values using a scanf() -like format string.

Categories

strcat

Name

strcat - Concatenates two strings.

Synopsis

 str1 str2 strcat str1str2 
 str1 str2 . str1str2 

Arguments

str1
the first string
str2
the second string

Description

Concatenates two strings. The . command can be used as a synonym.

Categories

strerror

Name

strerror - Returns the system error string.

Synopsis

 errno strerror 

Arguments

errno
the error number

Description

Returns the system error string. errno must be the value of the filp_errno variable.

Categories

sub

Name

sub - Math substraction.

Synopsis

 min subt sub result 
 min subt - result 

Arguments

min
minuend
subt
subtrahend

Description

Substracts subt from min and sends the result to the stack. If filp_real is set, the operation is made in real mode, or integer otherwise.

Categories

substr

Name

substr - Extracts a substring.

Synopsis

 string offset size substr substring 

Arguments

string
the string to be extracted from
offset
offset of the first character in string
size
number of characters to be extracted

Description

Extracts a substring from the string, starting at offset. Take note that string subscripts start from 1.

Categories

swap

Name

swap - Swaps the two values on top of the stack.

Synopsis

 value2 value1 swap value1 value2 
 value2 value1 xchg value1 value2 
 value2 value1 # value1 value2 

Arguments

val2
second value
val1
first value

Description

Swaps the two values on top of the stack. The commands xchg or # are synonyms.

Categories

sweep

Name

sweep - Collects garbage.

Synopsis

 sweep 

Description

Calls the internal garbage collector.

Categories

switch

Name

switch - Multiple conditional execution.

Synopsis

 [ condition_code execute_code ... ] switch 

Arguments

condition_code
Code to be executed for the condition test
execution_code
Code to be executed if condition is true

Description

Executes from top to down the condition block codes and, if one of them returns a true value, executes the associated execution code block and continues on the next instruction. The first condition / execution code pairs being run are the nearest to the switch instruction, and all of them are really a list, so the [ terminator must not be forgotten. To implement a clause similar to the 'default' one from the C language switch() command, it must be the last one and its condition code be always true.

Categories

swstack

Name

swstack - Swaps between the two stacks.

Synopsis

 swstack 

Description

Filp has two stacks, one on use and the other 'dormant'. This command swaps between the two stacks. It's used basicly when a running process can destroy valid information stored in the current stack, so this command puts it in a safe place. The variable filp_stack_elems is set accordingly.

Categories

symbol

Name

symbol - Sends symbol names to the stack.

Synopsis

 prefix symbol [ symbols ... ] 

Arguments

prefix
prefix of the symbol names to send to the stack

Description

Sends to the stack as a list all symbol names beginning with prefix. If prefix is "" (the empty string), all symbol names will be pushed.

Categories

time

Name

time - Returns the time in seconds.

Synopsis

 time time_t 

Description

Returns the time in seconds. This is the value returned by the C function time().

Categories

timer

Name

timer - millisecond timer

Synopsis

 timer msec_timer 

Description

Returns a millisecond timer.

Categories

tpop

Name

tpop - Stores the top of stack into the temporal variable.

Synopsis

 value tpop 

Arguments

value
value to be stored

Description

Stores the top of stack into the temporal variable ($_).

Categories

tpush

Name

tpush - Pushes the temporal variable to the stack.

Synopsis

 tpush value 

Description

Pushes the temporal variable ($_) to the stack.

Categories

true

Name

true - Stores a true value on the top of stack.

Synopsis

 true true_value 

Description

Stores a conditional value equal to 'true' on the top of stack.

Categories

type

Name

type - Returns a string describing the type of a value.

Synopsis

 value type type_string 

Arguments

value
the symbol or value.

Description

Returns a string describing the type of a value. If value is a name of a symbol, the type of its content is returned; otherwise, the value type itself is returned. The returned value can be one of SCALAR, CODE, BIN_CODE, EXT_INT, EXT_REAL, EXT_STRING, NULL, FILE or ARRAY.

Categories

unless

Name

unless - Conditional execution of code.

Synopsis

 bool code_block unless 

Arguments

bool
boolean value
code_block
code block to execute

Description

Executes the block of code if bool is false.

Categories

unset

Name

unset - Undefines a variable.

Synopsis

 <variable> unset 
 <variable> undef 

Arguments

variable
variable name to be undefined

Description

Undefines a variable. The command undef is a synonym.

Categories

val

Name

val - Returns the value of a symbol.

Synopsis

 string val content 

Arguments

string
the symbol name which value has to be gotten

Description

Treats the string as a symbol name and returns its value. If it does not exist as a symbol, NULL is returned instead.

Categories

while

Name

while - Conditional loop.

Synopsis

 condition_code repeat_code while 

Arguments

condition_code
Code to execute to evaluate condition
repeat_code
Code to execute if condition code is not NULL

Description

While the execution of condition_code returns a non-NULL value, repeat_code is also executed, having that value available in the top of stack for being processed. The NULL result of condition_code is clean from the stack.

Categories

write

Name

write - Writes a string to a file.

Synopsis

 string fdes write 

Arguments

string
string to be written to the file
fdes
file descriptor

Description

Writes a string to a file.

Categories


Angel Ortega - angel@triptico.com - Built with mp_doccer 1.2.2-dev

Related