Admin Production ni-theme
Current Publication

ListIsSorted

LabWindows/CVI

ListIsSorted

int ListIsSorted (ListType list, CompareFunction compareFunction);

Purpose

This function examines a list and returns whether it is sorted in ascending order.

Parameters

Input
Name Type Description
list ListType The list to be checked if it is sorted
compareFunction CompareFunction A comparison function which will be used to compare the items in the list.

The compare function should have the following prototype:

int CVICALLBACK CompareFunction(void *item1, void *item2);


The compare function should return a negative number if item1 is less than item2, it should return 0 if item1 is equal to item2, and it should return a positive number is item1 is greater than item2.

If zero (0) is passed for the compare function, the C Library function memcmp will be called to compare items.

This instrument driver provides several commonly useful comparison functions:

ShortCompare
IntCompare
FloatCompare
DoubleCompare
CStringCompare
CStringNoCaseCompare

Return Value

Name Type Description
isSorted int Returns non–zero if the list is sorted in ascending order.

Returns zero (0) if the list is not sorted.

Additional Information

Library: Programmer's Toolbox

Include file: toolbox\toolbox.h

LabWindows/CVI compatibility: LabWindows/CVI 4.0 and later