HELP
An object that allows the user to cut out a
number of fields from a record.

USE
Use SubRecord to output a subset of the
original record, with specified fields "cut"
from the record, on the Record output pin.
The record to be edited is input on the
Record input pin.  The list of fields to be
"included" or "excluded" in the output record
is input on the Fields input pin.

* If Include fields is selected in the open
view, the output record will consist only of
those fields in the Fields input.

* If Exclude fields is selected in the open
view, the output record will consist of all
fields in the original record excluding those
listed in the Fields input.

LOCATION
Data ==> Access Record ==> SubRecord

OPEN VIEW PARAMETERS
*Include fields -- (The default mode.)  The
output record is constructed from the input
record with only those fields in the list of
field names on the Fields data input pin.
This selection toggles with Exclude fields.

* Exclude fields -- The output record is
constructed from the input record with only
those fields that are not in the list of
field names on the Fields data input pin.

NOTES
The Fields input pin can be a text scalar
consisting of the names of the record fields
to include/exclude in the output record.

If you attempt to include/exclude a field
that is not in the input record, an error
will occur.  If you exclude all the fields of
the record, a nil output signal is sent.

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, To DataSet, and UnBuild
Record.
