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

Article
08/19/2022

[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,
  int nCount
);

Parameters

nFirst

The zero-based index of the first character in this <wdcml:xref targtype="object" rid="wmi.chstring" xmlns:wdcml="http://microsoft.com/wdcml">CHString</wdcml:xref> string that is be included in the extracted substring.

nCount

The number of characters to extract form this CHString string. If this parameter is not supplied, then the remainder of the string is extracted.

Return value

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

CHeap_Exception

Remarks

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

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

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

Requirements

Requirement	Value
Header	chstring.h