System.SysUtils.StrByteType

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function StrByteType(Str: PAnsiChar; Index: Cardinal): TMbcsByteType;
function StrByteType(Str: PWideChar; Index: Cardinal): TMbcsByteType;

C++

extern DELPHI_PACKAGE TMbcsByteType __fastcall StrByteType _DEPRECATED_ATTRIBUTE1("Moved to the AnsiStrings unit") (char * Str, unsigned Index)/* overload */;

Properties

Type Visibility Source Unit Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

Warning: The ANSI version of StrByteType is deprecated. Please use the AnsiStrings unit.

Indicates whether a byte in a string is a single-byte character, the first byte of a double-byte character, or the second byte of a double-byte character.

Call StrByteType to determine the type of the byte specified by the Index parameter, where 0 specifies the first byte in the string Str, 1 specifies the second byte, and so on.

If the system is not using a multi-byte character system (MBCS), StrByteType always returns mbSingleByte. Otherwise, StrByteType returns mbSingleByte if the indicated byte represents a complete character in Str, mbLeadByte if it represents the first byte of a double-byte character, and mbTrailByte if it represents the second byte of a double-byte character.

Note: No check is done to ensure that Index is less than the length of Str. It is the caller's responsibility to ensure that Index is not out of bounds.

See Also