Compartilhar via


CStringT::Tokenize

Localiza o símbolo seguir em uma cadeia de caracteres de destino

CStringT Tokenize(
   PCXSTR pszTokens,
   int& iStart
) const;

Parâmetros

  • pszTokens
    Uma cadeia de caracteres que contém os delimitadores um. A ordem de esses delimitadores não é importante.

  • iStart
    O índice com base zero para iniciar a pesquisa.

Valor de retorno

Um objeto de CStringT que contém o valor simbólico atual.

Comentários

A função de Tokenize localiza o símbolo seguir na cadeia de caracteres de destino. O conjunto de caracteres em pszTokens especifica delimitadores possíveis do símbolo a ser encontrado. Em cada chamada a Tokenize a função começa em iStart, ignora delimitadores chave, e retorna um objeto de CStringT que contém o identificador atual, que é a cadeia de caracteres até o caractere de delimitador seguir. O valor de iStart é atualizado para ser a posição após o caractere delimitador de final, ou -1 se o final da cadeia de caracteres foi alcançado. Mais tokens podem ser estoirados do restante da cadeia de caracteres de destino por uma série de chamadas a Tokenize, usando iStart para manter controle de onde cadeia de caracteres no símbolo seguir deve ser lido. Quando não há mais token a função retornará uma cadeia de caracteres vazia e iStart será definido como -1.

A o contrário de CRT tokenize funções como strtok_s, _strtok_s_l, wcstok_s, _wcstok_s_l, _mbstok_s, _mbstok_s_l, Tokenize não altera a cadeia de caracteres de destino.

Exemplo

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString str(_T("%First Second#Third"));
CAtlString resToken;
int curPos = 0;

resToken= str.Tokenize(_T("% #"),curPos);
while (resToken != _T(""))
{
   _tprintf_s(_T("Resulting token: %s\n"), resToken);
   resToken = str.Tokenize(_T("% #"), curPos);
};   

Comentários

A saída de esse exemplo são:

Resulting Token: First

Resulting Token: Second

Resulting Token: Third

Requisitos

Cabeçalho: cstringt.h

Consulte também

Referência

Classe de CStringT