Admin Production ni-theme
Current Publication

CompareBytes

LabWindows/CVI

CompareBytes

int CompareBytes (char buffer1[], int buffer1Index, char buffer2[], int buffer2Index, size_t numberOfBytes, int caseSensitive);

Purpose

Compares the numberOfBytes bytes that start at position buffer#1Index of buffer#1 to the numberOfBytes bytes that start at position buffer#2Index of buffer#2. CompareBytes returns an integer value that indicates the lexicographic relationship between the two sets of bytes.

Parameters

Input
Name Type Description
buffer1 char [] One of the two variables whose contents are to be compared.
buffer1Index int Zero–based index specifying the location within buffer#1 at which to begin comparing bytes.
buffer2 char [] One of the two variables whose contents are to be compared.
buffer2Index int Zero–based index specifying the location within buffer#2 at which to begin comparing bytes.
numberOfBytes size_t Number of bytes to compare.
caseSensitive int Specify a nonzero value or select Yes in the function panel to match characters on a case-sensitive basis.

Specify 0 or select No in the function panel to match characters on a case-insensitive basis.

Return Value

Name Type Description
result int Indicates the lexicographic relationship between the selected sets of bytes from buffer#1 and buffer#2.

Code Description
–1 Bytes from buffer#1 are less than bytes from buffer#2.
0 Bytes from buffer#1 are identical to bytes from buffer#2.
1 Bytes from buffer#1 are greater than bytes from buffer#2.

Additional Information

Library: Formatting and I/O Library

Include file: formatio.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later