Contents

pdlib

COPYING

kfunc

ObjType

Image

FEI

NetVal

vfile

vfile.h

VADDR

VFILE

struct VFILE_T {
int (*read_proc)(void *buf, int len, VFILE *fd);
int (*write_proc)(void *buf, int len, VFILE *fd);
int (*seek_proc)(VFILE *fd, int adr, int rel);
int (*lseek_proc)(VFILE *fd, s8 adr, s8 ret, int rel);
int (*tell_proc)(VFILE *fd);
int (*ltell_proc)(VFILE *fd, s8 ret);
int (*close_proc)(VFILE *fd);
int (*eof_proc)(VFILE *fd);
int (*flush_proc)(VFILE *fd);
int (*inready_proc)(VFILE *fd);
int (*ioctl_proc)(VFILE *fd, int req, char *argp);
int (*ioctls_proc)(VFILE *fd, void **arg);
void *(*mmap_proc)(void *addr, int length, int prot, int flags, VFILE *fd, int offs);
//int (*munmap_proc)(void *start, int length, VFILE *fd);
//int (*msync_proc)(void *start, int length, int flags, VFILE *fd);

int (*sread_proc)(void *buf, s8 pos, int len, VFILE *fd, vf_int_cb *cb, void *data);
int (*swrite_proc)(void *buf, s8 pos, int len, VFILE *fd, vf_int_cb *cb, void *data);

int (*send_proc)(VFILE *sock, VADDR *target, void *msg, int len, int flags);
	// used in the same bent way as read/write
int (*get_proc)(void *buf, int sz, VADDR *from, VFILE *sock);

u8 s_pos;	//for seeking read/write, allow emulation of normal read/write on async devs

void *buffer;	//data used by creator to allow storing other data.
void *userdata;	//user data, can be attached to files possibly to
	//ease open file management

//void *mapdata; // for use by mmap in cases it is external
VFILE *chain, *ch_prev;
	// used by things that recieve this vfile,
	// ch_prev used for putting in lists
VFILE *c_next, *c_prev;
	// used by the creator

VFNOTIFY *notify;
};

Vars

Parse

SX

XML

Print

SX

XML

Compress

Bitstream

Huffman

Function Index

pdscript

COPYING

PDScript Lang

Statements

Statements:

break [<number>]
	break. number will optionally give a number of break levels to skip over.
continue [<number>]
	continue. number will optionally give a number of break levels to skip over.

goto <name>
	goto a label given by name.

throw <name>
	throw an exception given by name.

return;
return <EXPR>
	return from a function with a given value. the form absent a value by defualt returns NULL.

bind <EXPR>=<EXPR>
set <EXPR>=<EXPR>
	bind or set values in the first expression to those in the second form.
	this is deprecated in favor of <EXPR>=<EXPR>.

<name>++
<name>--


Block Statements:

<name>:	label.

object <name> [clones <EXPR>] [extends <ARGS>] [toplevel <expr>] <BLOCK>
	creates a new object (an alternative to dictionary notation).

begin_object <EXPR> <BLOCK>
	execute block within the context of the object given by expr.


function <name>(<VARS>) <BLOCK>
	defines a new function in the object scope.

lfunction <name>(<VARS>) <BLOCK>
	defines a new function in the lexical scope.


macro_statement <name>(<VARS>) <BLOCK>
	defines a new statement macro.

macro_expression <name>(<VARS>) <BLOCK>
	defines a new expression macro.


if(<EXPR>)<BLOCK> [else <BLOCK>]

begin <BLOCK>
	naturally execute block once, however break and continue may be used to exit or loop within block.

while(<EXPR>)<BLOCK>
	a while loop.

for(<STMT>; <EXPR>; <STMT>)<BLOCK>
	a for loop.

let <name>(VARS) <BLOCK>
	let, non-working

switch(<EXPR>) {<branches>}
	switch statement.

try <BLOCK> [catch <name> <BLOCK>]*
	executes a block and catch an exception of a given name, in which case the handler block will be executed.


var <VARS>
	define vars in the object scope.

dynvar <VARS>
	define vars in the dynamic scope.

local <VARS>
	define vars in the lexical scope.

Expressions

Lit:		Literal values/builtin expressions
PE:		(<expr>) <expr>[<expr>] <expr>.<name>
IncDec:	++<name> --<name> + - ! ~ ... <name>++ <name>-- <expr>(<args>)[<BLOCK>]      
E:		<expr>**<expr>
MD:		* / % \ &
AS:		+ - | ^
SHLR:		<< >>
RCmp:		< > <= >= == != <=> <<== >>==
Lop:		&&
Lop2:		|| ^^
TCond:	<expr>?<expr>:<expr>
Attr:		:= :!= :< :> :<= :>= :<< :>> :<<= :>>=
Equals:	= += -= *= /= \= %= &= |= ^= >>= <<=

Literals:


$<name>

#<name>	symbol
#:<name>	keyword
#{<ARGS>}	matrix
#[<ARGS>]	vector
#(<ARGS>)	complex

{<ARGS>}	array
[<ARGS>]	dictionary
[:<ARGS>:]	list
-<NUMBER>	negative number

lambda [<name>](<VARS>) <BLOCK>
fun [<name>](<VARS>) <BLOCK>
	define a first-class function. name may be used to allow recursive forms, and will be visible only within the lexical scope of the block.

let <name>(VARS) <BLOCK>
	[dropped]
	let, non-working

withcc(<name>) <BLOCK>
	new continuation. BLOCK is executed with the continuation bound to name.

object <name> [clones <EXPR>] [extends <ARGS>] <BLOCK>
	creates a new object (an alternative to dictionary notation).
begin_object <EXPR> <BLOCK>
	execute block within the context of the object given by expr.

quote_xml <XML>
	treats a chunk of xml as if it were a parse tree.
xml <XML>
	creates a glob of xml to be used as a value.

statement <BLOCK>
	represents a statement in expresion position (intended primarily for macros).

quote(<EXPR>)
quote <BLOCK>
	quote a statement or expression, generating a value that can be used in working with syntax.

clone <EXPR>
	clone an object.
new <EXPR>(<ARGS>)
	create a new object and call the constructor with args.

<name>	var reference.
<number>	numeric literal.
<string>	string literal.
<charstr>	character literal.

Builtins

true: boolean true value
false: boolean false value
null: null value

system.io.print(...)
	print items

system.io.println(...)
	print items with trailing linebreak

system.interp.eval_block(block, self)
	evaluates a block of statements

system.interp.eval_expr(expr)
	evaluates an expression and returns result

system.interp.load(name[, toplevel])
	load and run a script

system.math.vector(<number+>)
	creates a numeric vector

system.math.normalize(vector)
	normalize a vector

system.basic.tostring(obj, ...)
	convert an object to a string

system.basic.copy(obj)
	copy an object

system.basic.builtin_join(obj)
	try to fetch a value from an object, otherwise returns NULL.

system.basic.gettypename(obj)
	fetch type name for obj

system.basic.apply(fun, args[, self])
	apply a function to an array containing args. self is optionally the toplevel to use during the apply.

system.basic.buildxml(...)
	build a chunk of xml


system.system.usedheap()
	gets number of used cells on heap

system.system.freeheap()
	gets number of free cells on heap

system.system.deltaheap()
	heap size delta since last call


system.math.PI: Constant PI
system.math.E: Constant Epsilon
system.math.CI: Constant Complex I, #(0, 1)
system.math.CJ: Constant Complex J, #(0, 0, 1)
system.math.CK: Constant Complex K, #(0, 0, 0, 1)

system.math.sqrt(x): square root

system.math.floor(x): round down
system.math.ceil(x): round up
system.math.round(x): round nearest
system.math.truncate(x): fractional part

system.math.pow(x, y): raise x to y
system.math.degrees(x): radians to degrees
system.math.radians(x): degrees to radians

system.math.cos(x): cosine
system.math.sin(x): sine
system.math.tan(x): tangent

system.math.cos_d(x): cosine degrees
system.math.sin_d(x): sine degrees
system.math.tan_d(x): tangent degrees

system.math.acos(x): arc cosine
system.math.asin(x): arc sine
system.math.atan(f[, g]): arc tangent

system.math.ln(x): natural log
system.math.log(x[, b]):logarithm
system.math.log10(x): log 10

Operators

a===b		a IS b

a<b		Less
a>b		Greater

a<=b		LessEqual
a>=b		GreaterEqual
a==b		Equal
a!=b		NotEqual
a<=>b		Match

a&&b		Logical And
a||b		Logical Or
a^^b		Logical Xor

!a		Logical Not

a+b		Add Array Array => Array of combined contents
a+b		Add Array Integer => Array with b added to the base
a-b		Sub Array Integer => Array with b subtracted from the base

a+b		Add Functions, creates a linked function which will evaluate the first (leftmost) matching function first.

Number
a+b	Add
a-b	Subtract
a*b	Multiply
a/b	Divide
a\b	Integer Division
a%b	Modulus
a**b	Exponent

a<<b	Shift Left
a>>b	Shift Right

a&b	Bitwise And
a|b	Bitwise Or
a^b	Bitwise Xor

~a	Bitwise Not
-a	Negatation

Vector
a+b	Add Vector
a-b	Subtract Vector
a*b	Scale Vector
a/b	Divide Vector by scalar
a%b	Cross Product
a^b	Cross Product

-a	Negate Vector
|a	Vector Length
\a	Normalize Vector

Complex
+ Add Complex
- Subtract Complex
* Multiply Complex
/ Divide Complex

Matrix
a+b	Add Matrix
a-b	Subtract Matrix
a*b	Multiply Matrix
a/b	Multiply Matrix by iverse of B (a*(/b))

/a	Invert Matrix


String
a+b		Add String String	=> New string with combined contents
a+b		Add String Integer => String with b added to the base
a-b		Sub String Integer => String with b subtracted from the base

a&b		Concatenate Strings/Concatenate a string with the textual representation of an object.

a<<b		Relative String Less Than
a>>b		Realtive String Greater Than
a<<==b	Relative String Less Than or Equal
a>>==b	Relative String Greater Than or Equal
	These compare strings by relative base, and are undefined for the case when a and b are different strings.

|a		String Length

BGGL2

Interp

Parse

Util

PDScript

Interp

Compile

Reference

Statements

Function Index

pdnet

Parse

NET

Sock

TCP

UDP

RPC

XML-RPC

Decode

Encode

Ext-1

Service

Jabber-RPC

ObjLst

Protocols

Meta0

HTTP

XMPP/Jabber

Util