Chapter 6 Function Descriptions

StrCpy

CStr StrCpy(dst, src);

Purpose

Copies the C string src to the C string dst. This function assumes dst is large enough to contain src.

Parameters

Name	Type	Description
dst	CStr	Pointer to a C string.
src	CStr	Pointer to a C string.

Return Value

A copy of the destination C string pointer.

Using External Code in LabVIEW

6-166

www.ni.com

Chapter 6 Function Descriptions

StrLen

int32 StrLen(s);

Purpose

Returns the length of a C string.

Parameters

Name	Type	Description
s	CStr	Pointer to a C string.

Return Value

The number of characters in the C string, not including the NULL terminating character.

© National Instruments Corporation

6-167

Using External Code in LabVIEW

Chapter 6 Function Descriptions

StrNCaseCmp

int32 StrNCaseCmp(s1, s2, n);

Purpose

Lexically compares two strings to determine whether one is less than, equal to, or greater than the other, limiting the comparison to n characters. This comparison ignores differences in case.

Parameters

Name	Type	Description
s1	CStr	Pointer to a C string.
s2	CStr	Pointer to a C string.
n	uInt32	Maximum number of characters you want to
		compare.

Return Value

<0, 0, or >0 if s1 is less than, equal to, or greater than s2, respectively. Returns <0 if s1 is an initial substring of s2.

Using External Code in LabVIEW

6-168

www.ni.com

Chapter 6 Function Descriptions

StrNCmp

int32 StrNCmp(s1, s2, n);

Purpose

Lexically compares two strings to determine whether one is less than, equal to, or greater than the other, limiting the comparison to n characters.

Parameters

Name	Type	Description
s1	CStr	Pointer to a C string.
s2	CStr	Pointer to a C string.
n	uInt32	Maximum number of characters you want to
		compare.

Return Value

<0, 0, or >0 if s1 is less than, equal to, or greater than s2, respectively. Returns <0 if s1 is an initial substring of s2.

© National Instruments Corporation

6-169

Using External Code in LabVIEW