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

Article
02/22/2024

[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

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	chstring.h (include FwCommon.h)
Library	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll