strcspn, wcscspn (Windows CE 5.0)

Article
09/14/2012

Developing an Application > Microsoft C Run-time Library for Windows CE > Run-time Library Reference

Find a substring in a string.

size_t strcspn( const char *string, const char *strCharSet);size_t wcscspn( const wchar_t *string, const wchar_t *strCharSet);

Parameters

string
Null-terminated searched string.
strCharSet
Null-terminated character set.

Return Values

Each of these functions returns an integer value specifying the length of the initial segment of string that consists entirely of characters not in strCharSet. If string begins with a character that is in strCharSet, the function returns 0. No return value is reserved to indicate an error.

Remarks

These functions are supported by all versions of the C run-time libraries.

The strcspn function returns the index of the first occurrence of a character in string that belongs to the set of characters in strCharSet. Terminating null characters are included in the search.

wcscspn is the wide-character version of strcspn. The arguments of wcscspn are wide-character strings. These two functions behave identically otherwise.

The following table shows generic-text routine mappings for this function.

TCHAR.H Routine	_UNICODE Defined
_tcscspn	wcscspn

For more information about TCHAR.H routines, see Generic Text Mappings.

Example

Description

The following example finds substrings in a string.

Code

#include <string.h>
#include <stdio.h>

void main( void )
{
   char string[] = "xyzabc";
   int  pos;

   pos = strcspn( string, "abc" );
   printf( "First a, b or c in %s is at character %d\n", 
           string, pos );
}
// Output
First a, b or c in xyzabc is at character 3

Requirements

OS Versions: Windows CE 2.0 and later.

Header: stdio.h, string.h.

Link Library: coredll.dll.