Admin Production ni-theme
Current Publication

CStringNoCaseCompare

LabWindows/CVI

CStringNoCaseCompare

int CStringNoCaseCompare (void *item1, void *item2);

Purpose

This function compares two strings without regard to case. This function may be used anywhere a function of type CompareFunction is required. Specifically, this function may be passed to one of the following functions:

BinSearch
InsertionSort
ListInsertInOrder
ListFindItem
ListRemoveDuplicates
ListBinSearch
ListQuickSort
ListHeapSort
ListInsertionSort
ListIsSorted

Parameters

Input
Name Type Description
item1 void * This parameter expects to be passed a pointer to a string. This string will be compared to the string pointed to by item2.
item2 void * This parameter expects to be passed a pointer to an string. This string will be compared to the string pointed to by item1.

Return Value

Name Type Description
comparisonResult int Returns one of the following values:

–1 // if StringA is less than StringB without regard to case

1 // if StringA is greater than StringB without regard to case

0 // if StringA is equal to StringB without regard to case

where:

StringA is the string pointed to by *(char **)item1

StringB is the string pointed to by *(char **)item2

Additional Information

Library: Programmer's Toolbox

Include file: toolbox\toolbox.h

LabWindows/CVI compatibility: LabWindows/CVI 6.0 and later