Partilhar via


CStringT::Tokenize

Localiza o próximo token em uma seqüência de caracteres de destino

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

Parâmetros

  • pszTokens
    Uma seqüência contendo delimitadores de token.A ordem desses delimitadores não é importante.

  • iStart
    O índice baseado em zero para iniciar a Pesquisar.

Valor de retorno

A CStringT objeto que contém o valor corrente de token.

Comentários

The Tokenize função localiza o próximo token na seqüência de caracteres de destino. O conjunto de caracteres em pszTokens Especifica delimitadores possíveis do token a ser localizado. Em cada telefonar para Tokenize a função começa com iStart, ignora delimitadores entrelinhamento e retorna um CStringT objeto que contém o símbolo corrente, que é a seqüência de caracteres até o próximo caractere delimitador. O valor de iStart é atualizado para ser a posição após o caractere delimitador participante, ou -1 se o participante da seqüência de caracteres foi atingido. Tokens mais podem estar quebradas fora do restante da seqüência destino por uma série de chamadas para Tokenize, usando iStart para controlar onde na seqüência de caracteres próximo token é ser lido. Quando não houver nenhum símbolo mais a função retornará uma seqüência vazia e iStart será definido como -1.

Ao contrário do CRT indexar funções, como strtok_s _strtok_s_l wcstok_s, _wcstok_s_l, _mbstok_s, _mbstok_s_l, Tokenize não modifica a seqüência 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 deste exemplo é sistema autônomo segue:

Resulting Token: First

Resulting Token: Second

Resulting Token: Third

Requisitos

Cabeçalho: cstringt.h

Consulte também

Referência

Classe CStringT

Outros recursos

CStringT membros