Jump to content

Futurebasic/Language/Reference/fbcomparehandles

From Wikibooks, open books for an open world

FBCompareHandles function

[edit | edit source]

FBCompareHandles

[edit | edit source]

Function

[edit | edit source]

✔ Appearance ✔ Standard ✔ Console

Syntax

[edit | edit source]

result& = FN FBCOMPAREHANDLES(a&,b&)

Revised

[edit | edit source]

July 26, 2000 (Release 3)

Description

[edit | edit source]

This function returns a result representing a comparison of the contents of handle a& with the contents of handle b&. If result& is zero, the contents of the handles are identical. If result& is negative, -result& indicates the byte position at which handle a& was found to be less than handle b&. If result& is positive, it indicates the byte position at which handle a& was found to be greater than handle b&. The first position in the handle is byte number 1 (not zero). Two handles which differ from the very first byte will return a positive or negative 1 as a result.

Result

Indicates

Negative

handle a& < handle b&

Zero

handle a& = handle b&

Positive

handle a& > handle b&