Partager via


basic_string::_Copy_s

Copies au plus un nombre spécifié de caractères d'une position indexée dans une chaîne source en tableau de caractères cible.

size_type _Copy_s(
    value_type *_Dest,
    size_type _Dest_size,
    size_type _Count,
    size_type _Off = 0
) const;

Paramètres

  • _Dest
    Le tableau de caractères cible dans lequel les éléments doivent être copiés.

  • _Dest_size
    La taille d' _Dest.

  • _Count
    Le nombre de caractères à copier, au plus, de la chaîne source.

  • _Off
    La position de début de la chaîne source dans lequel les copies doivent être effectuées.

Valeur de retour

Le nombre de caractères réellement copiés.

Notes

Un caractère Null n'est pas ajouté à la fin de la copie.

Exemple

// 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;
}
  

Configuration requise

en-tête : <string>

l'espace de noms : DST

Voir aussi

Référence

basic_string Class

Bibliothèques sécurisées : bibliothèque C++ standard