Progress
Language Reference


BUFFER-COMPARE( ) Method

This method does a rough compare of any common fields, determined by name, datatype, and extent-matching, between the source buffer, source-buffer-handle, and the target buffer, bh, the object the method is applied to. The resulting logical value is either TRUE or FALSE as a whole. A single field that does not compare causes the entire buffer to return FALSE. If there are fields in one buffer that do not exist in the other, they are ignored.

Return Type: LOGICAL

Applies To: Buffer Object Handle

SYNTAX
bh:BUFFER-COMPARE( source-buffer-handle [ , mode-exp [ , except-list
     [ , pairs-list ] ] ] ) 

source-buffer-handle

An expression that evaluates to a buffer handle.

mode-exp

If mode-exp is given, it must evaluate to either “binary” or “case-sensitive” to provide that type of comparison.

except-list

A character expression that evaluates to a comma-separated list of field names to be excluded from the compare.

pairs-list

A character expression that evaluates to a comma-separated list of field-name pairs to be compared.

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 does a binary compare of two fields, one from each buffer:

bh:BUFFER-COMPARE(bh2,"binary",,"cust-sales-rep,sales-rep"). 


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