collate::transform

Converte uma seqüência de caracteres de uma localidade para uma cadeia de caracteres que pode ser usada em comparações lexicographical com outras seqüências de caracteres convertidas a mesma forma da mesma localidade.

string_type transform(
   const CharType* _First,
   const CharType* _Last
) const;

Parâmetros

• _First
  Um ponteiro para o primeiro caractere na seqüência a ser convertido.

• _Last
  Um ponteiro para o caractere o último na seqüência a ser convertido.

Valor de retorno

Uma cadeia de caracteres que contém a seqüência transformada de caracteres.

Comentários

a função de membro retorna do_transform(_First, _Last).

Exemplo

// collate_transform.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
#include <tchar.h>
using namespace std;

int main( )   
{
   locale loc ( "German_Germany" );
   _TCHAR* s1 = _T("\x00dfzz abc."); 
   // \x00df is the German sharp-s (looks like beta), 
   // it comes before z in the alphabet
   _TCHAR* s2 = _T("zzz abc."); 

   collate<_TCHAR>::string_type r1;   // OK for typedef?
   r1 = use_facet< collate<_TCHAR> > ( loc ).
      transform (s1, &s1[_tcslen( s1 )-1 ]);
   
   cout << r1 << endl;

   basic_string<_TCHAR> r2 = use_facet< collate<_TCHAR> > ( loc ).
      transform (s2, &s2[_tcslen( s2 )-1 ]);
   
   cout << r2 << endl;

   int result1 = use_facet<collate<_TCHAR> > ( loc ).compare 
      (s1, &s1[_tcslen( s1 )-1 ],  s2, &s2[_tcslen( s2 )-1 ] );

   cout << _tcscmp(r1.c_str( ),r2.c_str( )) << result1 
      << _tcscmp(s1,s2) <<endl;
}

Requisitos

Cabeçalho: <locale>

namespace: STD

Consulte também

Referência

collate Class