Compartilhar via


CSimpleStringT::SetString

Defina a cadeia de caracteres de um objeto de CSimpleStringT .

void SetString(
   PCXSTR pszSrc,
   int nLength
);
void SetString(
   PCXSTR pszSrc
);

Parâmetros

  • pszSrc
    Um ponteiro para uma cadeia de caracteres NULL- finalizada.

  • nLength
    Uma contagem do número de caracteres em pszSrc.

Comentários

Copiar uma cadeia de caracteres no objeto de CSimpleStringT .SetString substitui os dados antigos de cadeia de caracteres no buffer.

Ambas as versões de SetString verificar se pszSrc é um ponteiro zero, e se é, acione um erro de E_INVALIDARG .

A versão de um parâmetro de SetString espera pszSrc aponte para uma cadeia de caracteres NULL- finalizada.

A versão de dois parâmetro de SetString também espera pszSrc ser uma cadeia de caracteres NULL- finalizada.Usa nLength como o comprimento da cadeia de caracteres a menos que zero primeiramente localizar um terminador.

A versão de dois parâmetro de SetString também verifica se pontos de pszSrc para um local no buffer atual em CSimpleStringT.Em esses casos especiais, SetString usa uma função de impressão de memória que não substitui os dados da cadeia de caracteres como copiar os dados da cadeia de caracteres de volta ao buffer.

Exemplo

O exemplo a seguir demonstra o uso de CSimpleStringT::SetString.

CSimpleString s(_T("abcdef"), pMgr);
ASSERT(_tcscmp(s, _T("abcdef")) == 0);

s.SetString(_T("Soccer"), 6);
ASSERT(_tcscmp(s, _T("Soccer")) == 0);   

Requisitos

Cabeçalho: atlsimpstr.h

Consulte também

Referência

Classe de CSimpleStringT