BUFFER-COPY Method
This method copies any common fields, determined by name, data type, and extent-matching, from the source buffer, source-buffer-handle, to the receiving buffer, bh, the object the method is applied to. If there are fields in one buffer that do not exist in the other, they are ignored. This method is used to accommodate temp-tables of joins.
Return Type: LOGICAL
Applies To: Buffer Object Handle
SYNTAX
bh:BUFFER-COPY( source-buffer-handle [ , except-list [ , pairs-list ] ] )
source-buffer-handle
An expression that evaluates to the source buffer handle.
except-list
A character expression that evaluates to a comma-separated list of field names to be excluded from the copy.
pairs-list
A character expression that evaluates to a comma-separated list of field-name pairs to be copied.
NOTE: The order within each field-name pair does not matter; each pair must contain one field name from the source and one field name from the target.
The following example fragment copies the customer table to the buffer, bh, except that customer.sales-rep is copied to a field called cust-sales-rep in the buffer:
bh:BUFFER-COPY(buffer customer:handle,?,"cust-sales-rep,sales-rep").