LIOGO Procedure Reference

[This is preliminary documentation and subject to change]

ContainerLib

Name	Synopsis	Arguments	Description	Return	Remarks
push	push stackName newValue	stackName: variable name for the stack newValue: value to push	Push a value in the stack represented by the variable stackName.
pop	pop stackName	stackName: variable name for the stack	Pop a value from the stack represented by the variable stackName.	value poped
queue	queue queueName newValue	queueName: variable name for the queue newValue: value to queue	Add a value in the queue represented by the variable queueName.
dequeue	dequeue queueName	queueName: variable name for the queue	Dequeue a value from the queue represented by the variable queueName.	value dequeued
pprop	pprop listNameValue nameValue newValue	listNameValue: name of property list nameValue: name of property newValue: value for the new property	Add a value to a property list.
plist	plist listNameValue	listNameValue: name of property list	Get the property list value.	a LogoList with each name and each value, return an empty list if property list don't exist
gprop	gprop listNameValue nameValue	listNameValue: name of property list nameValue: name of value to find	Get a value in a property list.	the value or an empty list if list or value don't exist
remprop	remprop listNameValue nameValue	listNameValue: name of property list nameValue: name of value to remove	Remove a value in a property list.
array	array size (array size start)	p1...pn: values of parameters	Create an array with a size and a start index.	a new array
mdarray	mdarray size (mdarray size start)	p1...pn: values of parameters	Create an multi-dimension array with a size and a start index.	a new array
mditem	mditem listIndex array	listIndex: list of index array: array	Get an item in a multi-dimension array.	item at index
mdsetitem	mdsetitem listIndex array value	listIndex: list of index array: array value: new item value	Set an item value in a multi-dimension array.
setitem	setitem itemIndexValue array itemValue	itemIndexValue: item index array: array itemValue: new item value	Set a value of an item's array.
arraytolist	arraytolist array	array: array to use	Build a list with from array.	a list with each item in array.
listtoarray	listtoarray list	list: list to use	Build an array from a list.	an array with each item in list.
remdup	remdup value	value: value to process	Remove duplicate value in a word or a list.	a word or a list depending of input value.

GraphicLib

Name	Synopsis	Arguments	Description	Return	Remarks
forward	forward stepValue	stepValue: step value	Move the turtle forward from step unit toward the current heading.
fd	fd stepValue	stepValue: step value	Move the turtle forward from step unit toward the current heading.		fd is just an alias for "forward"
left	left degreeValue	degreeValue: angle to go	Change turtle heading to the left.
lt	lt degreeValue	degreeValue: angle to go	Change turtle heading to the left.		lt is just an alias for "left"
right	right degreeValue	degreeValue: angle to go	Change turtle heading to the right.
rt	rt degreeValue	degreeValue: angle to go	Change turtle heading to the right.		rt is just an alias for "right"
back	back stepValue	stepValue: step value	Move the turtle back from step unit toward the current heading.
bk	bk stepValue	stepValue: step value	Move the turtle back from step unit reverse the current heading.		bk is just an alias for "back"
pendown	pendown		Set the pen down.
pd	pd		Set the pen down.		pd is just an alias for "pendown"
penup	penup		Set the pen up.
pu	pu		Set the pen up.		pu is just an alias for "penup"
pendown?	pendown?		Test the pen writing mode	"true if the pen is down, "false else
pendownp	pendownp		Test the pen writing mode	"true if the pen is down, "false else	pendownp is an alias for pendown?
setxy	setxy xValue yValue	xValue: new x value yValue: new y value	Set the turtle to x and y.
setx	setx xValue	xValue: new x value	Change the turtle x-coordinate.
sety	sety yValue	yValue: new y value	Change the turtle y-coordinate.
setpos	setpos xyInList	xyInList: new x and y value in a list	Set the turtle position in x and y.
setheading	setheading directionValue	directionValue: new heading value	Change the turtle heading to direction.
seth	seth directionValue	directionValue: new heading value	Change the turtle heading to direction.		seth is just an alias for setheading
home	home		Move the turtle to the center of the screen and set heading to 0.
arc	arc angleValue radiusValue	angleValue: angle of the arc radiusValue: radius of the arc	Draw an arc of a circle with the specified angle and radius.
pos	pos		Get the turtle position.	a list with x and y coordinate
xcor	xcor		Get the turtle X coordinate.	x coordinate
ycor	ycor		Get the turtle Y coordinate.	y coordinate
heading	heading		Get the turtle heading.	turtle heading
hideturtle	hideturtle		Hide turtle.
ht	ht		Hide turtle.		ht is just an alias for "hideturtle"
showturtle	showturtle		Show turtle.
st	st		Show turtle.		st is just an alias for "showturtle"
clean	clean		Clean all turtle draw.
clearscreen	clearscreen		Clean all draw and go to home.
cs	cs		Clean all draw and go to home.		cs is just an alias for "clearscreen"
shown?	shown?		Test if Turtle is visible.	the word "true is the turtle is visible
shownp	shownp		Test if Turtle is visible.	the word "true is the turtle is visible
setbackground	setbackground newColorValue	newColorValue: new color	Change Background color.
setbg	setbg newColorValue	newColorValue: new color	Change Background color.		setbg is just an alias for "setbackground"
setscreencolor	setscreencolor newColorValue	newColorValue: new color	Change Background color.		setscreencolor is just an alias for "setbackground"
setsc	setsc newColorValue	newColorValue: new color	Change Background color.		setsc is just an alias for "setbackground"
setpencolor	setpencolor newColorValue	newColorValue: new color	Change pen color.
setpc	setpc		Change pen color.		setpc is just an alias for "setpencolor"
setpensize	setpensize newSizeValue	newSizeValue: new size	Change pen size.
pencolor	pencolor		Get Pen color.	the pen color, a number for a standard color, a RGV value list else
pc	pc		Get Pen color.	the pen color	pc is just an alias for "pencolor"
background	background		Get background color.	the background color
screencolor	screencolor		Get background color.	a list with the background color red, green, blue value
bg	bg		Get background color.	the background color	bg is just an alias for "background"
towards	towards xyInList	xyInList: x and y target	Return the heading at which the turtle should be facing so that it would point to the position given as input.	the heading at which the turtle should be facing
pensize	pensize		Get Pen size.	the pen size
setpalette	setpalette colorIndex newColorValue	colorIndex: index in palette newColorValue: new composite value	Change a palette color.
palette	palette colorIndex	colorIndex: index of the color to find	Get RGB values for a color in the palette.	a list with R, G and B value
setpixel	setpixel newColorValue	newColorValue: new color	Set the current pixel color.
cleartext	cleartext		Clear the console.
ct	ct		Clear the console.		ct is just an alias for cleartext
refresh	refresh		Refresh screen.
label	label labelValue	labelValue: label to print	Draw a label on string.
setlabelfont	setlabelfont labelFont	labelFont: new font properties	Change font used for the label command.
labelfont	labelfont		Get the current font used for label command.	a list with all font properties
loadimage	loadimage filenameValue	filenameValue: filename value for image	Draw an image.
turtleimage	turtleimage		Set turtle shape mode as image.
turtletriangle	turtletriangle		Set turtle shape mode as triangle (default).
turtleshape	turtleshape		Test the turtle shape mode mode	"triangle if turtle is a triangle, "image if turtle is an image
setturtleimage	setturtleimage filenameValue	filenameValue: filename value for image	Change turtle image used when turtle shape is image.
turtleimagename	turtleimagename		Get the turtle image name	current filename for turtle image used for turtle shape

MathLib

Name	Synopsis	Arguments	Description	Return	Remarks
sum	sum p1 p2 (sum p1 p2 ... pn)	p1...pn: value to process	Return the sum of parameters.	sum of parameters
sum	sum value1 value2	value1: first value value2: second value	Return the sum of parameters.	sum of parameters	use only by generator
product	product p1 p2 (product p1 p2 ... pn)	p1...pn: value to process	Return the product of parameters.	product of parameters
product	product value1 value2	value1: first value value2: second value	Return the product of parameters.	product of parameters	use only by generator
difference	difference value1 value2	value1: first value value2: value to substract	Make the difference of two values.	difference to value
quotient	quotient value1 value2	value1: value to divide value2: diviser	Make the quotient of two values.	quotient of values
abs	abs value1	value1: value to process	Return the absolute value of a specified number.	absolute value of the number, 0 if value is not a number or not convertible to a number
sign	sign value1	value1: value to process	Return a value indicating the sign of the number.	the sign of the number, 0 if value is not a number or not convertible to a number
remainder	remainder value1 value2	value1: num1 value2: num2	Process remainder on dividing value1 by value2.	remainder on num1 by num2
modulo	modulo value1 value2	value1: num1 value2: num2	Process modulo on dividing value1 by value2.	modulo on num1 by num2	modulo is the same operation than remainder
int	int value1	value1: value to process	Return integer value of the number.	the integer value
round	round value1	value1: value to process	Return nearest integer to the value.	the nearest integer value
sqrt	sqrt value1	value1: value to process	Return square root of the value.	the square root of the value
power	power value1 value2	value1: num1 value2: num2	Process value1 to the value2 power.	num1 to the num2 power
exp	exp value1	value1: value to process	Return exponantial of the value.	the e of the value
log10	log10 value1	value1: value to process	Return common logarithm of the value.	the logarithm of the value
ln	ln value1	value1: value to process	Return natural logarithm of the value.	the natural logarithm of the value
sin	sin value1	value1: value in degree	Return sine of the value.	the sine of the value
radsin	radsin value1	value1: value in radian	Return sine of the value.	the sine of the value
cos	cos value1	value1: value in degree	Return cosine of the value.	the cosine of the value
radcos	radcos value1	value1: value in radian	Return cosine of the value.	the cosine of the value
arctan	arctan p1 (arctan p1 ... pn)	p1...pn: values to process	Return Arctangent in degree of the value. With two inputs, outputs the arctangent of y/x, if x is nonzero, or 90 or -90 depending on the sign of y, if x is zero.	Arctangent in degree
radarctan	radarctan p1 (radarctan p1 ... pn)	p1...pn: values to process	Return Arctangent in rand of the value. With two inputs, outputs the arctangent of y/x, if x is nonzero, or PI/2 or -PI/2 depending on the sign of y, if x is zero.	Arctangent in radian
iseq	iseq valueFrom valueTo	valueFrom: start value valueTo: end value	Return a list of the integers from FROM to TO, inclusive.	a list of value
rseq	rseq valueFrom valueTo valueCount	valueFrom: start value valueTo: end value valueCount: count number	Return a list of N real number from FROM to TO, inclusive.	a list of value
random	random p1 (random p1 ... pn)	p1...pn: maximum value and optionnally, minimum value	Return a a random nonnegative integer less than its input. With two inputs, output a random integer greater than or equal to the first input and less than equal the second input	return a random value
rerandom	rerandom p1 (rerandom p1 ... pn)	p1...pn: optionally, seed value	Reinitialize random seed.
pi	pi		Get PI.	PI value

ListLib

Name	Synopsis	Arguments	Description	Return	Remarks
first	first listOrWord	listOrWord: list or word to process	Return the first item in list or word.	first item or char
last	last listOrWord	listOrWord: list or word to process	Return the last item in list or word.	last item or char
item	item index listOrWord	index: Index of item (start at 1) listOrWord: list or word to process	Get item N in the value.	Value at index
butfirst	butfirst listOrWord	listOrWord: list or word to process	Get everything except the first item.	Everything except the first item
bf	bf listOrWord	listOrWord: list or word to process	Get everything except the first item.	Everything except the first item
butlast	butlast listOrWord	listOrWord: list or word to process	Get everything except the last item.	Everything except the last item
bl	bl listOrWord	listOrWord: list or word to process	Get everything except the last item.	Everything except the last item
fput	fput newitem list	newitem: new item to put list: list to change	Put a new item at the first position.	the list with the new value
lput	lput newitem list	newitem: new item to put list: list to change	Put a new item at the last position.	the list with the new value
length	length listOrWord	listOrWord: list to process	Get the length of the value.	Length of the value
count	count listOrWord	listOrWord: list to process	Get the length of the value.	Length of the value
list?	list? valueToTest	valueToTest: value to test	Test if the value is a List.	the word "true is the value is a list
listp	listp valueToTest	valueToTest: value to test	Test if the value is a List.	the word "true is the value is a list
empty?	empty? valueToTest	valueToTest: value to test	Test if the value is an empty list or word.	the word "true is the value is an empty list or word
emptyp	emptyp valueToTest	valueToTest: value to test	Test if the value is an empty list or word.	the word "true is the value is an empty list or word
list	list p1 p2 (list p1 p2 ... pn)	p1...pn: value to process	Return a list with all values.	a list with all parameters
sentence	sentence p1 p2 (sentence p1 p2 ... pn)	p1...pn: value to process	Return a sentence with all values.	a sentence with all parameters
se	se p1 p2 (se p1 p2 ... pn)	p1...pn: value to process	Return a sentence with all values.	a sentence with all parameters	se is just an alias for "sentence".
word	word p1 p2 (word p1 p2 ... pn)	p1...pn: value to process	Return a word with all values.	a sentence with all parameters
word?	word? valueToTest	valueToTest: value to test	Test if the value is a Word.	the word "true is the value is a word (or a number)
wordp	wordp valueToTest	valueToTest: value to test	Test if the value is a Word.	the word "true is the value is a word (or a number)
combine	combine thing1 thing2	thing1: first value thing2: second value	Combine thing1 and thing2. If thing2 is a word, output WORD thing1 thing2. If thing2 is a list, output FPUT thing1 thing2.	a value who combine thing1 and thing2
reverse	reverse valueToReverse	valueToReverse: value to reverse	Reverse the value.	the same value in reverse order
gensym	gensym		Generate an unique word value.	an unique word of the form g1, g2, ...
firsts	firsts valueToProcess	valueToProcess: value to process	Return First item of each member of the list.	a list with each first element
butfirsts	butfirsts valueToProcess	valueToProcess: value to process	Return butfirst item of each member of the list.	a list with each butfirst element
pick	pick valueToProcess	valueToProcess: value to process	Pick a random item in the list.	an item in the list
remove	remove valueThing valueList	valueThing: thing to remove valueList: list to process	Return a copy of list with every item equal to thing removed.	a list with each thing element removed
uppercase	uppercase valueToProcess	valueToProcess: value to process	Output the value in uppercase.	the same value in uppercase
lowercase	lowercase valueToProcess	valueToProcess: value to process	Output the value in lowercase.	the same value in lowercase

BoolLib

Name	Synopsis	Arguments	Description	Return	Remarks
true	true		Logo true value	true
false	false		Logo false value	false
equal?	equal? value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 equal value2, false else
equalp	equalp value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 equal value2, false else
notequal?	notequal? value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 is not equal to value2, false else
notequalp	notequalp value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 is not equal to value2, false else
less?	less? value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 less than value2, false else
lessp	lessp value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 less than value2, false else
lessequal?	lessequal? value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 lesser or equal than value2, false else
lessequalp	lessequalp value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 lessequal than value2, false else
greater?	greater? value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 greater than value2, false else
greaterp	greaterp value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 greater than value2, false else
greaterequal?	greaterequal? value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 greaterer or equal than value2, false else
greaterequalp	greaterequalp value1 value2	value1: first value value2: second value	Compare two Logo value	true if value1 greaterequal than value2, false else
before?	before? value1 value2	value1: first value value2: second value	Compare two Logo word in ASCII collating sequence.	true if value1 come before value2, false else
beforep	beforep value1 value2	value1: first value value2: second value	Compare two Logo word in ASCII collating sequence.	true if value1 come before value2, false else	beforep is just an alias for before?
member?	member? value1 value2	value1: first value value2: second value	Test is value2 is a member or value1. If value2 is a word, value1 must be a one-character word. If value2 is a list, test if value1 is a member of value2 list.	true if value1 is member of value2, false else
memberp	memberp value1 value2	value1: first value value2: second value	Test is value2 is a member or value1. If value2 is a word, value1 must be a one-character word. If value2 is a list, test if value1 is a member of value2 list.	true if value1 is member of value2, false else	memberp is just an alias for member?
substring?	substring? value1 value2	value1: first value value2: second value	Test is value2 is a substring of value1. value1 et value2 must be words.	true if value1 is substring of value2, false else
substringp	substringp value1 value2	value1: first value value2: second value	Test is value2 is a substring of value1. value1 et value2 must be words.	true if value1 is substring of value2, false else	substringp is just an alias for substring?
number?	number? valueToTest	valueToTest: value to test	Test a value is a number.	Logo word true if value is a number, Logo word false else.
numberp	numberp valueToTest	valueToTest: value to test	Test a value is a number.	Logo word true if value is a number, Logo word false else.	numberp is just an alias for number?
and	and value1 value2	value1: first value value2: second value	Do a boolean AND between two value.	true if value1 is true and value2 is true, false else
or	or value1 value2	value1: first value value2: second value	Do a boolean OR between two value.	true if value1 is true or value2 is true, false else
not	not valueToProcess	valueToProcess: value to process	Do a boolean NOT on the value.	true if value is true, false else
array?	array? valueToTest	valueToTest: value to test	Test if the value is an array.	the word "true is the value is an array
arrayp	arrayp valueToTest	valueToTest: value to test	Test if the value is an array.	the word "true is the value is an array

IOLib

Name	Synopsis	Arguments	Description	Return	Remarks
print	print p1 (print p1 ... pn)	p1...pn: values to print	Print on console a list of LogoValue
pr	pr p1 (pr p1 ... pn)	p1...pn: values to print	Print on console a list of LogoValue		pr is just an alias for print
show	show p1 (show p1 ... pn)	p1...pn: values to print	Show on console a list of LogoValue
type	type p1 (type p1 ... pn)	p1...pn: values to print	Print on console a list of LogoValue. Same as print but without white space and newline.
readlist	readlist		Read a line as a list from the console.	a list or a empty word in case of error
readword	readword		Read a line as a word from the console.	a word or a empty list in case of error
parse	parse valueToParse	valueToParse: word to parse	Parse a word as it were entered as readlist.	a list or a empty word in case of error
runparse	runparse valueToParse	valueToParse: word to parse	Parse a word as it were entered as an instruction list.	a list or a empty word in case of error
readchar	readchar		Read a char as a word from the console.	a word or -1 in case of error

SystemLib

Name	Synopsis	Arguments	Description	Return	Remarks
logoversion	logoversion		Output the Logo version in the form [Liogo 1.0 Windows].	a list containing version and platform
timemilli	timemilli		Get time ellapsed since Windows started in milliseconds.	a number
time	time		Get current system time as a list.	a list
bye	bye		Exit from program.
wait	wait timeToWait	timeToWait: time to wait	Wait for Nth 60 seconds

CompilLib

Name	Synopsis	Arguments	Description	Return	Remarks
runresult	runresult listOfInstr	listOfInstr: list of instruction	Compile and run a list of instruction.	a list with a member if instructions return a value, an empty list else
run	run listOfInstr	listOfInstr: list of instruction	Compile and run a list of instruction.	a list with a member if instructions return a value, an empty list else
map	map p1 p2 (map p1 p2 ... pn)	p1...pn: list of instruction and Data to process	Map a command or list of instruction to a list of data.	a list or a word (depending on data input type) contains data processed
map.se	map.se p1 p2 (map.se p1 p2 ... pn)	p1...pn: list of instruction and Data to process	Map a command or list of instruction to a list of data.	a list contains data processed
apply	apply templateValue listOfParam	templateValue: value of template (must use one of known form: named procedure, explicit slot, ...) listOfParam: value of parameter for the template	Apply a template on a list of value used as template parameter. Number of parameter expected by the template must match number of parameter in the list.	return value of the template processed (or null if no value was returned)
invoke	invoke p1 p2 (invoke p1 p2 ... pn)	p1...pn: list of instruction and Data to process	Invoke a template. Number of parameter expected by the template must match number of parameter of the value.	return value of the template processed (or null if no value was returned)
foreach	foreach p1 p2 (foreach p1 p2 ... pn)	p1...pn: list of value and template	Enumerate a list of value and call a template on each.
filter	filter templateValue data	templateValue: value of template (must use one of known form: named procedure, explicit slot, ...) data: data to process: a list or a word	Filter a list of value using a template. Each item in the list (or each character in word) is applied to the template. The template must return "true to keep the value and "false else.	a list or a word (depending on data input type) contains data processed
find	find templateValue data	templateValue: value of template (must use one of known form: named procedure, explicit slot, ...) data: data to process: a list or a word	Find a value using a template. Each item in the list (or each character in word) is test with the template. The template must return "true to keep the value and "false else.	the value of the item found
reduce	reduce templateValue data	templateValue: value of template (must use one of known form: named procedure, explicit slot, ...) data: data to process: word or list	Reduce data (word or list) applying template with two parameter each time until data is empty.	the resulting value
thing	thing nameValue	nameValue: list of instruction	Compile and run a list of instruction.	a list with a member if instructions return a value, an empty list else
load	load p1 (load p1 ... pn)	p1...pn: list of libraries name (assemblys)	Load in the context a list of libraries.
unload	unload p1 (unload p1 ... pn)	p1...pn: list of libraries name (assemblys)	Unload a list of libraries.
primitives	primitives		Get a list with all primitives procedures.	a list with name of each primitives procedures
primitivep	primitivep name	name: a word	Test if parameter is the name of a primitive procedure.	true or false
primitive?	primitive? name	name: a word	Test if parameter is the name of a primitive procedure.	true or false	primitive? is just an alias for primitivep
procedures	procedures		Get a list with all user-defined procedures.	a list with name of each user-defined procedures
procedurep	procedurep name	name: a word	Test if parameter is the name of a procedure.	true or false
procedure?	procedure? name	name: a word	Test if parameter is the name of a procedure.	true or false	procedure? is just an alias for procedurep
keywords	keywords		Get a list with keywords (not including symbols).	a list with name of each keywords
keywordp	keywordp name	name: a word	Test if parameter is the name of a keyword.	true or false
keyword?	keyword? name	name: a word	Test if parameter is the name of a keyword.	true or false	keyword? is just an alias for keywordp
?rest	?rest (?rest p0 ... pn)	p1...pn: index of the parameter	In a template, ?REST represent the portion of the input to the right of the current value.	pending value to process
pons	pons		Print currently defined variables at local and global scope.
trace	trace contentsList	contentsList: a word, a list or a list with one to three lists	Activate trace for procedures, variables or properties.
untrace	untrace contentsList	contentsList: a word, a list or a list with one to three lists	Desactivate trace for procedures, variables or properties.
tracedp	tracedp contentsList	contentsList: a word, a list or a list with one to three lists	Test traced procedures, variables or properties.	true or false
traced?	traced? contentsList	contentsList: a word, a list or a list with one to three lists	Test traced procedures, variables or properties.	true or false	traced? is just an alias for tracedp