Progress
Language Reference


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"). 


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095