The FARFALLA Programming Reference Guide
FARFALLA v1.5

Chris Walter and Bob Nolty

Abstract:

This manual provides reference material for programmers wishing to write programs using FARFALLA.

• 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 ...