Contents lists
Contents list commands manipulate several items at once using structured contents lists. Such a list is a three-element list, which are again lists. The first element is a list of all affected procedures, the seconds a list of all names, and the third a list of all properties. Structured contents lists are a new feature of Terrapin Logo 4; almost all commands in this section have changed from Terrapin Logo 3.
ALL
Also: CONTENTS, CO
Outputs a complete structured contents list.
Syntax
ALL
Description
ALL outputs a structured contents list containing all user-defined, unburied procedures names, names, and property list names. The list is a three-element list; the first element is a list of all procedure names, the second a list of all names, and the third element is a list of all property list names.
Many commands accept a structured contents list as input. This makes it
possible to supply a targeted collection of procedure names, names, and
property lists. For example, the list [[] [MYNAME] []] would refer to
the name MYNAME, and the list [[MYPROC] [] [A B]] would refer to the
procedure MYPROC, and the property list A and B.
Example
(PR “Procedures: ITEM 1 ALL) Procedures: SQUARE NICKNAME (PR “Names: ITEM 2 ALL) Names: (PR “Propertylists: ITEM 3 ALL) Propyertylists: JOE JACK
BURIED
Outputs a structured contents list of all buried elements.
Syntax
BURIED
Description
BURIED outputs a structured contents list of all buried, non-empty elements.
Example
MAKE “N 1 BURYNAME “N BURIED
BURIED?
Also: BURIEDP
Outputs TRUE if the element described by its input is buried.
Syntax
BURIED? name
Description
BURIED outputs TRUE if the element described by its input is buried. If the input is a list or a structured contents list, BURIED? outputs the buried state of the first non-empty element of the list.
BURIEDNAMES
Outputs a list of all buried names.
Syntax
BURIEDNAMES
Description
BURIEDNAMES outputs a list of all buried names. BURIEDNAMES is an abbreviation for FIRST BUTFIRST BURIED
Example
MAKE “N 1 BURYNAME “N BURIEDNAMES Result: [N]
BURIEDPROCS
Outputs a list of all buried procedures.
Syntax
BURIEDPROCS
Description
BURIEDPROCS outputs a list of all buried procedures. BURIEDPROCS is an abbreviation for FIRST BURIED
BURIEDPROPS
Outputs a list of all buried property lists.
Syntax
BURIEDPROPS
Description
BURIEDPROPS outputs a list of all buried property lists. BURIEDPROPS is an abbreviation for LAST BURIED
Example
PPROP “STAN “AGE “YOUNG BURYPROP “STAN BURIEDPROPS Result: [STAN]
BURY
Makes names and procedures invisible.
Syntax
BURY procedureName
BURY [procedureName, procedureName, ...]
BURY contents-list
(BURY procedureName procedureName ...)
Description
BURY hides the object(s) specified by its input from the general Logo workspace. Buried elements are like primitives. They are not listed anymore with any of the commands that return lists of elements, like PROCEDURES. The PRINTOUT
command does not list their content. See also BURIEDNAMES, BURIEDPROCS, BURIEDPROPS, BURYALL, BURYNAME, BURYPROC, and BURYPROP.
Example
MAKE “B 456 PON “B B is 456 BURY NAMELIST “B PON “B UNBURY NAMELIST “B PON “B B is 456
BURYALL
Makes all names and procedures invisible.
Syntax
BURYALL
Description
BURYALL makes all names and procedures invisible. BURYALL is an abbreviation for BURY ALL.
BURYNAME
Makes one or more names invisible.
Syntax
BURYNAME name or list
Description
BURYNAME makes either a single name or a list of names invisible. BURYNAME is an abbreviation for BURY NAMELIST name-or-list.
BURYNAMES
Makes all names invisible.
Syntax
BURYNAMES
Description
BURYNAMES makes all names invisible. BURYNAMES is an abbreviation for BURY NAMES.
BURYPROC
Makes one or more procedures invisible.
Syntax
BURYPROC name or list
Description
BURYPROC makes either a single procedure or a list of procedures invisible. BURYPROC is synonymous to BURY.
BURYPROCS
Makes all procedures invisible.
Syntax
BURYPROCS
Description
BURYPROCS makes all procedures invisible. BURYPROCS is an abbreviation for BURY PROCEDURES.
BURYPROP
Makes one or more property lists invisible.
Syntax
BURYPROP name or list
Description
BURYPROP makes either a single property list or a list of property lists invisible. BURYPROP is synonymous to BURY PLLIST name-or-list.
BURYPROPS
Makes all property lists invisible.
Syntax
BURYPROPS
Description
BURYPROPS makes all property lists invisible. BURYPROPS is an abbreviation for BURY PLISTS.
EDALL
Edits the entire Logo workspace.
Syntax
EDALL
Description
EDALL loads all of the unburied Logo procedures, names, and properties into a new editor window. EDALL is an abbreviation for EDIT ALL.
EDIT
Also: ED
Edits parts or all of the Logo workspace.
Syntax
EDIT name
EDIT name1 name2 name3 . . .
EDIT [name1 name2 name3 . . .]
EDIT [structured contents list]
EDIT ALL
EDIT NAMES
EDIT PROCEDURES
EDIT PROPERTIES
(EDIT)
Description
EDIT prints its inputs and opens the resulting data in an editor window. For procedures, EDIT attempts to open the original file that contained the definition of that procedure; if this is not possible, or if the procedure has never been saved before, EDIT prints the procedure instead. EDIT then prints the names and/or properties, and opens an editor window containing all printed definitions. EDIT only prints unburied data; see BURY for an explanation of buried data.
If multiple procedures are given as input to EDIT, EDIT attempts to open all files that are associated with the procedures, and switches the editor window to the first procedure, unless EDIT also caused the editor window to open a new window with printed data; in that case, the editor window displays the contents of the new window.
EDIT ALL opens the editor and installs all the unburied procedures, names, and property lists that exist in the workspace. EDIT NAMES opens the editor and installs all the user-defined names in the workspace (names defined with MAKE). EDIT PROCEDURES opens the editor with the contents of all the user-defined procedures in the workspace. EDIT PLISTS opens the editor with the contents of all the user-defined properties in the workspace.
EDIT can also be used with a three-element contents list as its input (NAMES, PROCEDURES and PLISTS all output a structured contents list). EDIT edits all procedures, names and properties mentioned in that contents list.
If EDIT is called with a single property list element as in EDIT
[[][][PREFS]], a property editory opens that lets you edit the
properties of that element interactively.
(EDIT) opens an empty editor window.
EDL
Edits a list.
Syntax
EDL list
Description
EDL stands for EDit List. EDL causes the visual list editor to appear with the contents of the specified list organized by ITEM number. Contents of the list may be edited in the visual list editor. Click OK to replace the list in workspace with the edited list.
Example
MAKE “MONTHS [JANUARY FEBRUARY MARCH APRIL MAY JUNE JULY AUGUST SEPTEMBER OCTOBER NOVEMBER DECEMBER] EDL “MONTHS
EDN
Edits one or more Logo names.
Syntax
EDN name or list
Description
EDN loads the unburied Logo name or the list of unburied Logo names into a new editor tab. EDN is an abbreviation for EDIT NAMELIST name-or-list.
In Terrapin Logo, EDN with no inputs used to edit all names. Please use EDNS instead.
EDNS
Edits all Logo names.
Syntax
EDNS
Description
EDNS loads all of the unburied Logo names into a new editor window. EDNS is an abbreviation for EDIT NAMES.
EDP
Edits one or more Logo procedures.
Syntax
EDP name or list
Description
EDP loads the unburied Logo procedure or the list of unburied Logo procedures into a new editor window. EDP is an abbreviation for EDIT PROCLIST name-or-list.
Note: In Terrapin Logo 3, the command to edit a
property list was EDP. Now, use the EDPL command to edit a
property list.
EDPL
Edits one or more Logo property lists.
Syntax
EDPL name or list
Description
EDPL loads the unburied property list or the list of unburied property lists into a new editor window. EDPL is an abbreviation for EDIT PLLIST name-or-list.
If EDPL is called with a single name as input, a property editory opens that lets you edit the properties of that name interactively.
Note: In Terrapin Logo 3, the command to edit a property list was EDP, which now edits one or more procedures.
EDPS
Edits all user-defined, unburied procedures.
Syntax
EDPS
Description
EDPS loads user-defined, unburied procedures into a new editor window. EDPS is an abbreviation for EDIT PROCEDURES.
EDPLS
Edits all Logo properties.
Syntax
EDPLS
Description
EDPLS loads all of the unburied Logo properties into a new editor tab. EDPLS is an abbreviation for EDIT PLISTS.
ERALL
Edits the entire Logo workspace.
Syntax
ERALL
Description
ERALL erases the unburied Logo procedures, names, and properties. ERALL is an abbreviation for ERASE ALL.
ERASE
Also: ER
Erases Logo elements.
Syntax
ERASE ALL
ERASE procname
ERASE [procname1 procname2 procname3 ...]
ERASE NAMES
ERASE PROCEDURES
ERASE PROPERTIES
Description
ERASE removes the definition of its input from the workspace. The input to ERASE must be an quoted procedure name or list of procedure names. It can also be a structured contents list (see ALL). ERASE erases all definitions of a name, including its aliases defined with theALIAS command, regardless whether the original name or an alias name is used as input. ERASE NAMES removes all user-defined names from the workspace. ERASE PROCEDURES removes all procedures from the workspace. ERASE PLISTS removes all property lists from the workspace. ERASE ALL removes all procedures and names from the workspace.
Use ERASE to erase Logo objects as well. Once created, Logo objects like
turtles or bitmaps, live forever unless you erase them. Use the ERASE
command just as you would use it to erase procedures. The command ERASE
“TURTLE.0, for example, erases the turtle 0.
ERN
Erase one or more Logo names.
Syntax
ERN name or list
Description
ERN erases the unburied Logo name or the list of unburied Logo names. ERN is an abbreviation for ERASE NAMELIST name-or-list.
Note that ERN with no inputs used to erase all names. Please use ERNS instead.
ERNS
Erases all Logo names.
Syntax
ERNS
Description
ERNS erases all of the unburied Logo names. ERNS is an abbreviation for ERASE NAMES.
ERPL
Erases one or more Logo property lists.
Syntax
ERPL name or list
Description
ERPL erases the unburied Logo property list or the list of unburied Logo property lists. ERPL is an abbreviation for ERASE PLLIST name-or-list.
ERPLS
Erases all Logo properties.
Syntax
ERPLS
Description
ERPLS erases all of the unburied Logo properties. ERPLS is an abbreviation for ERASE PLISTS.
ERPS
Erases all procedures.
Syntax
ERPS
Description
ERPS erases all unburied Logo procedures. ERPS is an abbreviation for ERASE PROCEDURES.
NAMELIST
Outputs a structured contents list with names.
Syntax
NAMELIST name-or-list
Description
NAMELIST outputs its input as a structured contents list. Its input is converted to a list if it is not a list, and the output contains that list as its second element. The first and third elements are the empty list. NAMELIST can be used to input a structured list of names to procedures that accept a contents list.
Example
NAMELIST “HI Result: [[][HI][]] NAMELIST [HI WORLD] Result: [[][HI WORLD][]]
NAMES
Outputs a structured contents list with all names.
Syntax
NAMES
Description
NAMES outputs a structured contents list containing all user-defined, unburied names. The list is a three-element list; the first element is an empty list, the second is a list of all names, and the third element is again an empty list.
Example
NAMES Result: [[][N SIZE]]
PLISTS
Also: PROPERTIES
Outputs a structured contents list with all properties.
Syntax
PLISTS
Description
PLISTS outputs a structured contents list containing all user-defined, unburied properties. The list is a three-element list; the first and second elements are empty lists, and the third element is a list of all names that have properties.
Example
PPROP “CAR “MAKE “BMW PROPERTIES Result: [[][][CAR]]
PLLIST
Outputs a structured contents list with properties.
Syntax
PLLIST name
PLLIST list
Description
PLLIST outputs its input as a structured contents list. Its input is converted to a list if it is not a list, and the output contains that list as its third element. The first and second elements are the empty list. PLLIST can be used to input a structured list of property list names to procedures that accept a contents list.
Example
PLLIST “HI Result: [[][][HI]] PLLIST [HI WORLD] Result: [[][][HI WORLD]]
POALL
Prints the entire Logo workspace.
Syntax
POALL
Description
POALL prints the unburied Logo procedures, names, and properties. POALL is an abbreviation for PRINTOUT ALL.
PON
Prints a Logo name.
Syntax
PON name
Description
PON prints the name given by its first input if it is unburied.
Example
MAKE “N 1 PON “N N is 1
PONS
Prints all Logo names.
Syntax
PONS
Description
PONS prints all of the unburied Logo names. PONS is an abbreviation for PRINTOUT NAMES.
POPL
Prints one or more Logo property lists.
Syntax
POPL name or list
Description
POPL prints the unburied Logo property list or the list of unburied Logo property lists. POPL is an abbreviation for PRINTOUT PLLIST name-or-list.
POPLS
Prints all Logo properties.
Syntax
POPLS
Description
POPLS prints all of the unburied Logo properties. POPLS is an abbreviation for PRINTOUT PLISTS.
POPRS
Prints the title of all Logo primitives.
Syntax
POPRS
Description
POPRS prints the title of all built-in Logo primitives. POPRS is an abbreviation for PRINTOUT PRIMITIVES.
POPS
Prints all Logo procedures.
Syntax
POPS
Description
POPS prints all stored procedure definitions. POPS is an abbreviation for PRINTOUT PROCEDURES.
POT
Prints the title line of one or more user-defined procedures.
Syntax
POT name or list
Description
POT prints the titles of one or more user-defined procedures. To print out procedure definitions, use PRINTOUT.
POTS
Prints the title line of all user-defined procedures.
Syntax
POTS
Description
POTS prints the titles of all user-defined procedures. To print out procedure definitions, use POPS. POTS is an abbreviation for POT PROCEDURES.
PRIMITIVES
Outputs a structured contents list with all primitives.
Syntax
PRIMITIVES
Description
PRIMITIVES outputs a structured contents list containing all built-in procedure names. The list is a three-element list; the first element is a list of all procedure names, and the second and third elements are the empty list.
PRINTOUT
Also: PO
Prints procedures, names, or properties.
Syntax
PRINTOUT procname
(PRINTOUT procname1 procname2 ...)
PRINTOUT contents-list
PRINTOUT ALL
PRINTOUT NAMES
PRINTOUT PROCEDURES
PRINTOUT PROPERTIES
PRINTOUT PRIMITIVES
Description
PRINTOUT prints the names, definitions, and values specified by its input.
PRINTOUT ALL prints out all procedure titles, definitions, variable names and values, and property lists. PRINTOUT ALL can be abbreviated to PO ALL.
PRINTOUT NAMES prints out all user-defined variable names and values. PRINTOUT NAMES can be abbreviated to PO NAMES or PONS.
PRINTOUT PROCEDURES prints out all user-defined procedure titles and definitions. PRINTOUT PROCEDURES can be abbreviated to PO PROCEDURES or POPS.
PRINTOUT PRIMITIVES prints out all built-in procedure titles. PRINTOUT PRIMITIVES can be abbreviated to PO PRIMITIVES or POPRS.
PRINOUT also accepts a structured content list, and prints all elements in that list.
PROCEDURES
Outputs a list with all user procedures.
Syntax
PROCEDURES
Description
PROCEDURES outputs a list containing all user-defined, unburied procedure names. Note that this is not a structured contents list, but all commands that accept such a list can also work with the list returned by PROCEDURES. Use PROCLIST to get a structured contents list.
Example
PROCEDURES Result: [SQUARE TRIANGLE]
PROCLIST
Outputs a structured contents list with procedures.
Syntax
PROCLIST name
PROCLIST list
Description
PROCLIST outputs its input as a structured contents list. Its input is converted to a list if it is not a list, and the output contains that list as its first element. The second and third elements are the empty list. PROCLIST can be used to input a structured list of procedures to procedures that accept a contents list.
Example
PROCLIST “HI Result: [[HI][][]] PROCLIST [HI WORLD] Result: [[HI WORLD][][]]
UNBURY
Makes names and procedures visible.
Syntax
UNBURY procedureName
UNBURY [procedureName, procedureName, ...]
UNBURY contents-list
(UNBURY procedureName procedureName ...)
Description
UNBURY returns the object(s) specified by its input to the general Logo workspace. UNBURY operates on procedures, names, and/or property lists previously buried with the BURY, BURYNAME, BURYPROC or BURYPROP commands. See also BURIEDNAMES, BURIEDPROCS, BURIEDPROPS, UNBURYALL, UNBURYNAME, UNBURYPROC, and UNBURYPROP.
Built-in commands cannot be unburied.
Example
MAKE “B 456 PON “B B is 456 BURY NAMELIST “B PON “B UNBURY NAMELIST “B PON “B B is 456
UNBURYALL
Makes all names and procedures visible.
Syntax
UNBURYALL
Description
UNBURYALL makes all names and procedures visible. UNBURYALL is an abbreviation for UNBURY BURIED.
UNBURYNAME
Makes one or more names visible.
Syntax
UNBURYNAME name or list
Description
UNBURYNAME makes either a single name or a list of names visible. UNBURYNAME is an abbreviation for UNBURY NAMELIST name-or-list.
UNBURYNAMES
Makes all names visible.
Syntax
UNBURYNAMES
Description
UNBURYNAMES makes all names visible. UNBURYNAME is an abbreviation for UNBURY NAMELIST BURIEDNAMES.
UNBURYPROC
Makes one or more procedures visible.
Syntax
UNBURYPROC name or list
Description
UNBURYPROC makes either a single procedure or a list of procedures visible. UNBURYPROC is an abbreviation for UNBURY PROCLIST name.
UNBURYPROCS
Makes all procedures visible.
Syntax
UNBURYPROCS
Description
UNBURYPROCS makes all procedures visible. UNBURYPROCS is an abbreviation for UNBURY BURIEDPROCS.
UNBURYPROP
Makes one or more property lists visible.
Syntax
UNBURYPROP name or list
Description
UNBURYPROP makes either a single property list or a list of property lists visible. UNBURYPROP is synonymous to UNBURY PLLIST name-or-list.
UNBURYPROPS
Makes all property lists visible.
Syntax
UNBURYPROPS
Description
UNBURYPROPS makes all property lists visible. UNBURYPROPS is an abbreviation for UNBURY NAMELIST BURIEDPROPS.