BARfly allows you to directly call most of the BAR engine's interfacial functions.  These fault-tolerant functions form the fundamental architecture for a BAR-oriented application, and it doesn't hurt to practice them here before using the BAR engine in your own application.

With these functions, you will discover that BAR actually supplies a superior "filing system" to many of the so-called object-oriented languages out there.  This is because the location, hierarchy, and relationship of every object is 100% accounted for.  If all data are linked together, how can memory get lost?

There are three interfacial objects:  BAR_Services, BAR_Registry, and BAR.  The reference covers every interfacial function made available to the same build of BAR used by BARfly.  Even though BARfly does not allow you to call every function in the engine, like BAR_Services::Initialize, you can still get a good idea of how the functions work when the time comes to use the functions in your own applications.

There are several categories of interfacial function for BAR objects:

• Type lookup:  Functions that retrieve information about a BAR implementation file.  You do not need to have a file loaded with the I.F. to call these functions.
• Loading and saving:  Functions that load a file from secondary storage (disk or memory), and save a loaded file to secondary storage (disk or memory).
• Node navigation:   Functions that manipulate the node cursor (forwards, backwards, upwards, downwards, searches, bookmark navigation).
• Node information:  Functions that retrieve information about the node cursor and the current node at the node cursor.
• Data reading:  Functions that read data from nodes.
• Data writing:  Functions that write data to nodes.
• Miscellaneous:  Functions that perform I.F. function calls (global or member), conduct file validation/revalidation, destroy the BAR instance, and get error information.

  See also:  [Interfacial Types] [Compatibility Considerations]