Unicode String Functions

Functions
LIBEXPORT MIUNICODE *	strntouc (MIUNICODE *dest, const char *source, int len)
LIBEXPORT MIUNICODE *	strtouc (MIUNICODE *dest, const char *source)
LIBEXPORT MIUNICODE *	strtouccat (MIUNICODE *dest, const char *source)
LIBEXPORT MIUNICODE *	strtoucdup (const char *)
LIBEXPORT DEPRECATED char *	ucntostr (char *dest, const MIUNICODE *source, int len)
LIBEXPORT MIUNICODE *	ucstrcat (MIUNICODE *dest, const MIUNICODE *source)
LIBEXPORT MIUNICODE *	ucstrchr (const MIUNICODE *p, MIUNICODE value)
LIBEXPORT int	ucstrcmp (const MIUNICODE *p1, const MIUNICODE *p2)
LIBEXPORT MIUNICODE *	ucstrcpy (MIUNICODE *dest, const MIUNICODE *source)
LIBEXPORT MIUNICODE *	ucstrdup (const MIUNICODE *s)
LIBEXPORT int	ucstricmp (const MIUNICODE *p1, const MIUNICODE *p2)
LIBEXPORT size_t	ucstrlen (const MIUNICODE *p)
LIBEXPORT MIUNICODE *	ucstrlwr (MIUNICODE *p)
LIBEXPORT MIUNICODE *	ucstrncat (MIUNICODE *p1, const MIUNICODE *p2, int len)
LIBEXPORT int	ucstrncmp (const MIUNICODE *p1, const MIUNICODE *p2, int len)
LIBEXPORT MIUNICODE *	ucstrncpy (MIUNICODE *dest, const MIUNICODE *source, int len)
LIBEXPORT int	ucstrnicmp (const MIUNICODE *p1, const MIUNICODE *p2, int len)
LIBEXPORT MIUNICODE *	ucstrpbrk (MIUNICODE *s, MIUNICODE *accept)
LIBEXPORT MIUNICODE *	ucstrrchr (MIUNICODE *s, MIUNICODE value)
LIBEXPORT size_t	ucstrspn (const MIUNICODE *s, const MIUNICODE *accept)
LIBEXPORT MIUNICODE *	ucstrstr (MIUNICODE *s, const MIUNICODE *p)
LIBEXPORT MIUNICODE *	ucstrtok (MIUNICODE *s, MIUNICODE *delim)
LIBEXPORT MIUNICODE *	ucstrtok2 (MIUNICODE *s, MIUNICODE *delim, MIUNICODE *&state)
LIBEXPORT MIUNICODE *	ucstrupr (MIUNICODE *p)
LIBEXPORT DEPRECATED char *	uctostr (char *dest, const MIUNICODE *source)
LIBEXPORT DEPRECATED char *	uctostrdup (const MIUNICODE *)

---

Function Documentation

LIBEXPORT MIUNICODE* strntouc	(	MIUNICODE *	dest,
		const char *	source,
		int	len
	)

Convert an ASCII string to Unicode (with length limit).

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE)

LIBEXPORT MIUNICODE* strtouc	(	MIUNICODE *	dest,
		const char *	source
	)

Convert an ASCII string to Unicode.

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE)

LIBEXPORT MIUNICODE* strtouccat	(	MIUNICODE *	dest,
		const char *	source
	)

Convert an ASCII string to Unicode and append to existing string.

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE)

LIBEXPORT MIUNICODE* strtoucdup

(

const char *

)

MIUNICODE version of strdup().

Note, this function doesn't do any character set mapping. It simply casts all the source characters to (MIUNICODE). The resulting string should be MmFree()'d.

LIBEXPORT DEPRECATED char* ucntostr	(	char *	dest,
		const MIUNICODE *	source,
		int	len
	)

Convert MIUNICODE string to ASCII (with length-limit).

Deprecated:

, Use appropriate MISTRING or FILEPATH method instead. Note, this just strips the high byte, so any characters > 255 will produce garbage in the output

LIBEXPORT MIUNICODE* ucstrcat	(	MIUNICODE *	dest,
		const MIUNICODE *	source
	)

MIUNICODE version of strcat().

LIBEXPORT MIUNICODE* ucstrchr	(	const MIUNICODE *	p,
		MIUNICODE	value
	)

MIUNICODE version of strchr().

Find the first occurance of a given character in a Unicode string. Returns a pointer to that character or NULL if not found.

LIBEXPORT int ucstrcmp	(	const MIUNICODE *	p1,
		const MIUNICODE *	p2
	)

Compare two MIUNICODE strings.

Returns -1 if (p1 < p2), 1 if (p1 > p2) 0 if (p1 == p2)

LIBEXPORT MIUNICODE* ucstrcpy	(	MIUNICODE *	dest,
		const MIUNICODE *	source
	)

Unicode version of strcpy().

LIBEXPORT MIUNICODE* ucstrdup

(

const MIUNICODE *

s

)

Unicode version of strdup().

LIBEXPORT int ucstricmp	(	const MIUNICODE *	p1,
		const MIUNICODE *	p2
	)

Compare two MIUNICODE strings (case insensitive).

Returns -1 if (p1 < p2), 1 if (p1 > p2) 0 if (p1 == p2)

LIBEXPORT size_t ucstrlen

(

const MIUNICODE *

p

)

Unicode version of strlen().

LIBEXPORT MIUNICODE* ucstrlwr

(

MIUNICODE *

p

)

Convert MIUNICODE string to lowercase (in-place).

Modifies the input string

LIBEXPORT MIUNICODE* ucstrncat	(	MIUNICODE *	p1,
		const MIUNICODE *	p2,
		int	len
	)

MIUNICODE version of strncat().

LIBEXPORT int ucstrncmp	(	const MIUNICODE *	p1,
		const MIUNICODE *	p2,
		int	len
	)

Compare two MIUNICODE strings (length limited).

Returns -1 if (p1 < p2), 1 if (p1 > p2) 0 if (p1 == p2)

LIBEXPORT MIUNICODE* ucstrncpy	(	MIUNICODE *	dest,
		const MIUNICODE *	source,
		int	len
	)

MIUNICODE version of strncpy().

LIBEXPORT int ucstrnicmp	(	const MIUNICODE *	p1,
		const MIUNICODE *	p2,
		int	len
	)

Compare two MIUNICODE strings (length limited and case insensitive).

Returns -1 if (p1 < p2), 1 if (p1 > p2) 0 if (p1 == p2)

LIBEXPORT MIUNICODE* ucstrpbrk	(	MIUNICODE *	s,
		MIUNICODE *	accept
	)

MIUNICODE version of strpbrk().

Locate the first occurrence in the string s of any of the characters in the string accept. Returns a pointer to it or NULL if not found.

LIBEXPORT MIUNICODE* ucstrrchr	(	MIUNICODE *	s,
		MIUNICODE	value
	)

MIUNICODE version of strrchr().

Locates the last occurrence of the character value in the string s. Returns a pointer to it or NULL if not found.

LIBEXPORT size_t ucstrspn	(	const MIUNICODE *	s,
		const MIUNICODE *	accept
	)

MIUNICODE version of strspn().

Returns the length of the initial segment of s which consists entirely of characters in accept.

LIBEXPORT MIUNICODE* ucstrstr	(	MIUNICODE *	s,
		const MIUNICODE *	p
	)

MIUNICODE version of strstr().

Finds the first occurrence of the substring p in the string s. Returns a pointer to it or NULL if not found.

LIBEXPORT MIUNICODE* ucstrtok	(	MIUNICODE *	s,
		MIUNICODE *	delim
	)

Extract token from string.

A "token" is a nonempty string of characters not occurring in the string delim, followed by \0 or by a character occurring in delim.

The ucstrtok() function can be used to parse the string s into tokens. The first call the ucstrtok() should have s as its first argument. Subsequent calls should have the first argument set to NULL. Each call returns a pointer to next token, or ULL when no more tokens are found.

If a token ends with a delimiter, this delimiting character is saved for the next call to ucstrtok(). The delimiter string may be different for each call.

Warning: This function is not reentrant and it modifies the string passed as the first parameter.

LIBEXPORT MIUNICODE* ucstrtok2	(	MIUNICODE *	s,
		MIUNICODE *	delim,
		MIUNICODE *&	state
	)

Extract token from string.

A "token" is a nonempty string of characters not occurring in the string delim, followed by \0 or by a character occurring in delim.

The ucstrtok2() function can be used to parse the string s into tokens. The first call the ucstrtok2() should have s as its first argument. Subsequent calls should have the first argument set to NULL. Each call returns a pointer to next token, or ULL when no more tokens are found.

If a token ends with a delimiter, this delimiting character is saved for the next call to ucstrtok2(). The delimiter string may be different for each call.

The last parameter is a reference to an MIUNICODE* that ucstrtok2 uses to keep track of the next starting position. This allows it to avoid the use of a static variable and makes it thread-safe.

Warning: This function modifies the string passed as the first parameter.

LIBEXPORT MIUNICODE* ucstrupr

(

MIUNICODE *

p

)

Convert MIUNICODE to uppercase (in-place).

LIBEXPORT DEPRECATED char* uctostr	(	char *	dest,
		const MIUNICODE *	source
	)

Convert MIUNICODE string to ASCII.

Deprecated:

, Use appropriate MISTRING or FILEPATH method instead. Note, this just strips the high byte, so any characters > 255 will produce garbage in the output

LIBEXPORT DEPRECATED char* uctostrdup

(

const MIUNICODE *

)

Return an ASCII copy of a MIUNICODE string.

Deprecated:

, Use appropriate MISTRING or FILEPATH method instead. Note, this just strips the high byte, so any characters > 255 will produce garbage in the output