Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

AfxIsValidString

Visual Studio 2010

Use this function to determine whether a pointer to a string is valid.

Copy 
BOOL AfxIsValidString(
   LPCSTR lpsz,
   int nLength = -1 
);
lpsz

The pointer to test.

nLength

Specifies the length of the string to be tested, in bytes. A value of –1 indicates that the string will be null-terminated.

In debug builds, nonzero if the specified pointer points to a string of the specified size; otherwise 0.

In non-debug builds, nonzero if lpsz is not NULL; otherwise 0.

C++
Copy 

// Create a character string which should be valid.
char str[12] = "hello world";

// Create a null pointer, which should be an invalid string.
char* null = (char*)0x0;

ASSERT(AfxIsValidString(str, 12));
ASSERT(!AfxIsValidString(null, 5));

Header: afx.h

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ