CHString::Mid(int) method (chstring.h)

[The CHString class is part of the WMI Provider Framework which is now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.]

The Mid method extracts a substring of length nCount characters from a CHString string, starting at position nFirst (zero-based). The method returns a copy of the extracted substring.

Syntax

CHString  throw(CHeap_Exception) Mid(
  int nFirst
);

Parameters

nFirst

The zero-based index of the first character in this CHString string that is be included in the extracted substring.

Return value

Returns a CHString object that contains a copy of the specified range of characters. The returned CHString object may be empty.

Remarks

The Mid method is similar to the Basic MID$ function except in the Basic MID$ function, indexes are zero-based.

Examples

The following code example shows the use of CHString::Mid.

CHString s( L"abcdef" );
assert( s.Mid( 2, 3 ) == L"cde" );

Requirements

See also

CHString

CHString::Left

CHString::Right