Chapter 6 Function Descriptions

PStrBuf

Macro

uChar *PStrBuf(s);

Purpose

Returns the address of the string data of a Pascal string, that is, the address following the length byte.

Parameters

Name	Type	Description
s	PStr	Pointer to a Pascal string.

Using External Code in LabVIEW

6-150

www.ni.com

Chapter 6 Function Descriptions

PStrCaseCmp

int32 PStrCaseCmp(s1, s2);

Purpose

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

Parameters

Name	Type	Description
s1	PStr	Pointer to a Pascal string.
s2	PStr	Pointer to a Pascal string.

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-151

Using External Code in LabVIEW

Chapter 6 Function Descriptions

PStrCat

int32 PStrCat(s1, s2);

Purpose

Concatenates a Pascal string, s2, to the end of another Pascal string, s1, and returns the result in s1. This function assumes s1 is large enough to contain the resulting string. If the resulting string is larger than 255 characters, the function limits the resulting string to 255 characters.

Parameters

Name	Type	Description
s1	PStr	Pointer to a Pascal string.
s2	PStr	Pointer to a Pascal string.

Return Value

The length of the resulting string.

Using External Code in LabVIEW

6-152

www.ni.com

Chapter 6 Function Descriptions

PStrCmp

int32 PStrCmp(s1, s2);

Purpose

Lexically compares two Pascal strings to determine whether one is less than, equal to, or greater than the other. This comparison is case sensitive.

Parameters

Name	Type	Description
s1	PStr	Pointer to a Pascal string.
s2	PStr	Pointer to a Pascal string.

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-153

Using External Code in LabVIEW