AfxExtractSubString

Globální funkce lze extrahovat podřetězec řetězce daný zdroj.

BOOL AFXAPI AfxExtractSubString (
   CString& rString,
   LPCTSTR lpszFullString,
   int iSubString,
   TCHAR chSep = '\n'
);

Parametry

• rString

  • Odkaz CString objekt, který bude přijímat jednotlivé podřetězce.

• lpszFullString

  • Řetězec obsahující úplný text z řetězce.

• iSubString

  • Z nuly vycházející index podřetězec extrahovat z lpszFullString.

• chSep

  • Oddělovací znak použitý k oddělení dílčích řetězců.

Vrácená hodnota

TRUE -li funkci úspěšně extrahovány řetězec zadaný index; jinak FALSE.

Poznámky

Tato funkce je užitečná pro extrahování několika dílčích řetězců ze zdrojové řetězce při známé znak odděluje jednotlivé podřetězce.Tato funkce vyhledá od začátku lpszFullString parametr pokaždé, když se nazývá.

Tato funkce vrací hodnotu FALSE, pokud lpszFullString je nastavena na NULL nebo funkce dosáhne konce lpszFullString bez zjištění iSubString+ 1 výskyty znaku zadaného oddělovače.rString Parametr nebude změněn z původní hodnotu, pokud lpszFullString byl nastaven na NULL; jinak rString parametr nastaven na prázdný řetězec, pokud nelze pro zadaný index extrahována podřetězec.

Příklad

// The following example extracts a series of name, value pairs from a
// given source string:

// Input string consisting of a number of name, value pairs
LPCTSTR lpszSource = _T("\"Name\"=\"John Smith\"\n")
   _T("\"Company\"=\"Contoso, Ltd\"\n\"Salary\"=\"25,000\"");

CString strNameValue; // an individual name, value pair

int i = 0; // substring index to extract
while (AfxExtractSubString(strNameValue, lpszSource, i))
{
   // Prepare to move to the next substring
   i++;

   CString strName, strValue; // individual name and value elements

   // Attempt to extract the name element from the pair
   if (!AfxExtractSubString(strName, strNameValue, 0, _T('=')))
   {
      // Pass an error message to the debugger for display
      OutputDebugString(_T("Error extracting name\r\n"));
      continue;
   }

   // Attempt to extract the value element from the pair
   if (!AfxExtractSubString(strValue, strNameValue, 1, _T('=')))
   {
      // Pass an error message to the debugger for display
      OutputDebugString(_T("Error extracting value element\r\n"));
      continue;
   }

   // Pass the name, value pair to the debugger for display
   CString strOutput = strName + _T(" equals ") + strValue + _T("\r\n");
   OutputDebugString(strOutput);
}

Požadavky

Záhlaví: <afxwin.h>

Viz také

Koncepty

MFC makra a Globals

Další zdroje

Pomocí CString