basic_string::_Copy_s
Copias como máximo un número especificado de caracteres de una posición indizados en una cadena de origen a una matriz de caracteres de destino.
size_type _Copy_s(
value_type *_Dest,
size_type _Dest_size,
size_type _Count,
size_type _Off = 0
) const;
Parámetros
_Dest
La matriz de caracteres de destino en la que los elementos deben copiarse._Dest_size
El tamaño de _Dest._Count
El número de caracteres que se van a copiar, como máximo, de la cadena de origen._Off
El principio colocar en la cadena de origen desde la que copias deben hacerse.
Valor devuelto
el número de caracteres copiado realmente.
Comentarios
Un carácter null no se anexa al final de la copia.
Ejemplo
// basic_string__Copy_s.cpp
// compile with: /EHsc
#include <string>
#include <iostream>
int main( )
{
using namespace std;
string str1("Hello World");
basic_string<char>::iterator str_Iter;
const int array1_size = 20;
char array1[array1_size] = { 0 };
const int array2_size = 10;
char array2[array2_size] = { 0 };
basic_string<char>:: pointer array1Ptr = array1;
basic_string<char>:: value_type *array2Ptr = array2;
cout << "The original string str1 is: ";
for (str_Iter = str1.begin(); str_Iter != str1.end(); str_Iter++)
cout << *str_Iter;
cout << endl;
basic_string<char>::size_type nArray1;
nArray1 = str1._Copy_s(array1Ptr, array1_size, 12);
cout << "The number of copied characters in array1 is: "
<< nArray1 << endl;
cout << "The copied characters array1 is: " << array1 << endl;
basic_string<char>:: size_type nArray2;
nArray2 = str1._Copy_s(array2Ptr, array2_size, 5, 6);
cout << "The number of copied characters in array2 is: "
<< nArray2 << endl;
cout << "The copied characters array2 is: " << array2Ptr << endl;
}
Requisitos
encabezado: <cadena>
espacio de nombres: std