HELP
An object that allows the user to unbuild a
record and recover its components.

USE
Use UnBuild Record to extract the data
components from a record (A, B, and so
forth), and to obtain a Name List and Type
List for those components.

* The Name List output pin outputs a Text
array of all the names of the input record
field names.

* The Type List output pin outputs a Text
array of all the data types of the input
record.

* The A, B, etc.  output pins output the
individual data components unbuilt from the
record.

LOCATION
Data ==> UnBuild Data ==> Record

NOTES
You may add an arbitrary number of output
pins to this object.  Each output pin name
must correspond to a name of a record field.
Field names are not case sensitive (lowercase
and uppercase letters are equivalent).

Note the distinction between the UnBuild
Record, SubRecord, and Get Field objects.

* The UnBuild Record object has outputs for
the Name List and Type List of the input
record fields.  The other (optional) outputs
A, B, etc.  of the UnBuild Record object
return the same results as would multiple Get
Field objects.

* The Get Field object works like a Formula
object, in that it uses dot syntax (A.B) to
unbuild a record.  Note that Get Field allows
you to unbuild a record of records in one
step by using an expression such as A.B.C.
This process would require two UnBuild Record
objects.

* The SubRecord object differs from UnBuild
Record and Get Field in that its output is
always a record.  The SubRecord device allows
you to either include or exclude a list of
fields from a record to form a subrecord.

SEE ALSO
Build Record, From DataSet, Get Field, Record
Constant, Set Field, SubRecord, and To
DataSet.
