CHString::Mid method

[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

   
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

See Also

CHString

CHString::Left

CHString::Right