Share via


char_traits::move

Copia un número especificado de caracteres en una secuencia a otro, posiblemente superpuestos secuencia.

Este método es potencialmente peligroso, como se basa en el llamador para comprobar que los valores pasados son correctos.En su lugar, considere la posibilidad de utilizar char_traits::_Move_s.

static char_type *move(
   char_type* _To, 
   const char_type* _From, 
   size_t _Num 
);

Parámetros

  • _To
    El elemento al principio de la cadena o de matriz de caracteres de destino para recibir la secuencia copiada de caracteres.

  • _From
    El elemento al principio de la cadena o de matriz de caracteres de origen que se copiarán.

  • _Num
    El número de elementos que se copiarán de la cadena de origen.

Valor devuelto

El primer elemento _To copiado en la cadena o la matriz de caracteres de destino para recibir la secuencia copiada de caracteres.

Comentarios

El origen y el destino pueden superponer.

Ejemplo

// char_traits_move.cpp
// compile with: /EHsc /W3
#include <string>
#include <iostream>

int main( )
{
   using namespace std;

   char_traits<char>::char_type sFrom1[] =  "abcd-1234-abcd";
   char_traits<char>::char_type sTo1[] =  "ABCD-1234";
   char_traits<char>::char_type* result1;
   cout << "The source string sFrom1 is: " << sFrom1 << endl;
   cout << "The destination stringsTo1 is: " << sTo1 << endl;
   // Note: char_traits::move is potentially unsafe, consider
   // using char_traits::_Move_s instead.
   result1 = char_traits<char>::move ( sTo1 ,  sFrom1 , 4 );  // C4996
   cout << "The result1 = move ( sTo1 , sFrom1 , 4 ) is: "
        << result1 << endl << endl;

   // When source and destination overlap
   char_traits<char>::char_type sToFrom2[] = "abcd-1234-ABCD";
   char_traits<char>::char_type* result2;
   cout << "The source/destination string sToFrom2 is: "
        << sToFrom2 << endl;
   const char* findc = char_traits<char>::find ( sToFrom2 , 4 , 'c' );
   // Note: char_traits::move is potentially unsafe, consider
   // using char_traits::_Move_s instead.
   result2 = char_traits<char>::move ( sToFrom2 , findc , 8 );  // C4996
   cout << "The result2 = move ( sToFrom2 , findc , 8 ) is: "
        << result2 << endl;
}
  

Requisitos

encabezado: <cadena>

espacio de nombres: std

Vea también

Referencia

char_traits Struct