Platform SDK: MAPI

UFromSz

The UFromSz function converts a null-terminated string of decimal digits into an unsigned integer.

Note  This function may not be supported in future versions of MAPI.

Quick Info

Header file: MAPIUTIL.H
Implemented by: MAPI
Called by: Client applications and service providers

UINT UFromSz( 
  LPCTSTR lpsz   
); 
 

Parameters

lpsz
[in] Pointer to the null-terminated string to be converted. The lpsz parameter must not exceed 65536 characters.

Return Values

UFromSz returns an unsigned integer. If the string does not begin with at least one decimal digit, a binary zero is returned.

Remarks

The UFromSz function stops converting when it reaches the first character in the string that is not a decimal digit. For example, given the string "55", UFromSz returns the integer value 55. Given the string "5a5b", the function returns the integer value 5. Given the string "a5b5", UFromSz returns zero.

UFromSz is sensitive to diacritical differences. Strings in the Unicode and DBCS formats are supported. The length limit on lpsz is in characters, not necessarily bytes.

See Also

String Operation Functions