Contents

• Contents
• Introduction
• Basics of FARFALLA
  • FARFALLA Trees
  • The Life Cycle of a FARFALLA Tree
  • The Implementation of FARFALLA
• Basic FARFALLA Programming
  • The FARFALLA Classes
  • Creating a New FARFALLA Tree in Memory
    • Overview
    • Creating the New Tree (Top-Level Node)
    • Adding Children Nodes
    • Output and Deletion
    • Inputting a Tree from Disk
  • Navigating a FARFALLA Tree
  • Deleting Nodes
• Creating a New Node Type
  • The F_NodeType
  • Inheritance from F_NodeClass
  • The Constructor
  • The Data
  • print() and info()
  • IOData()
  • The Creation Function
  • Declaration Object
  • Unknown Node Types
• Pointers to Information Elsewhere in the Tree
• Using FARFALLA to Create a Custom DST
• Using FARFALLA in the DASH Environment
• FARFALLA Reference
  • Nonmember Functions
    • void F_createTree(nodePtr)
    • void F_addChild(parentNodePtr,newNodePtr)
    • void F_getChild(parentNodePtr,nodeWantedPtr,int index)
    • void F_inputTree(topNodePtr,iostream&infile)
    • F_NodestarF_inputSubtree(F_NodestarparentPtr,iostream&infile)
  • Member Functions of Class F_Node
    • F_NodeTypereturnType()
    • int numChildren(F_NodeTypetypeWanted)
    • F_NodestargetChild(F_NodeTypetypeWanted, int index)
    • void addChild(F_NodestarnewNode);
    • void outputSubtree(iostream&outputFile)
    • void deleteChildrenOfType(F_NodeTypetypeWanted)
    • void deleteSubtree()
    • int numTypesChildren()
    • F_NodeTypechildType(int index)
• Introduction to C++ Programming
  • The Increment Operator
  • Printing
  • Unions
  • Enumeration Types
  • Pointers and Arrays
  • Dynamic Allocation of Memory
  • Functions and Function Arguments
  • Interfacing to FORTRAN
  • Classes
    • Class Definition
    • Inheritance
  • Casts
• About this document ...

WHAT'S NEW WITH FARFALLA

 o Changes to IOData in node definitions
   We have changed the argument list of IOData to be more general.  It was:

   virtual inline void IOData(fstream& file,F_inout choice,int& nodeLength);

   We have changed it to be

   virtual inline void IOData(iostream& file,F_inout choice,F_length& nodeLength);

   If you have defined any node types of your own, you will have to
   make these changes in your node definition file.

 o Versioning added to all node definitions for the MACRO experiment
   Versioning is described in the section on IOData.

 o Pointers-in-unknownNodes bug fixed
   This bug was mentioned in the last edition of the manual

 o Two new functions added for navigating the tree
   If you do not know what to expect on the tree you need additional
   help to find out what types of children exist.  The two new F_Node
   member functions numTypesChildren() and childType() exist for this
   purpose.  They are mentioned in the chapter on navigating a
   FARFALLA tree, and explained in the subroutine reference chapter.

 o Various minor bug fixes to bring things in accord with documentation
------------------------------------------------------------------------
Release philosophy:
   The previous release was considered experimental, and we are not
surprised this new release contains some small non-backward-compatible
changes.  FARFALLA has matured considerable since the first release,
and is now routinely used in real analysis.  Therefore we expect that
there will be no more non-backward-compatible changes.  However, we
are not yet firmly committed to that policy.  If we believe we can
improve the package significantly with a change, we will make that
change in the next release regardless of compatibility -- we just
consider such an improvement unlikely now.  After the next release we
will probably be ready to commit to a policy of no non-compatible
changes.