CKTIS / C++
std::memcpy — copier des octets de mémoire
std::memcpy de <cstring> copie un nombre donné d’octets entre des zones mémoire qui ne se chevauchent pas. La fonction ne vérifie pas les limites et ne remplace pas la copie d’objets qui gèrent des ressources.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstring>
void* std::memcpy(void* dest, const void* src, std::size_t count);std::memcpy(dest, src, count) de <cstring> copie count octets de src vers dest, et non count éléments. La fonction ne s’arrête pas à un octet nul. Elle renvoie un pointeur vers un objet implicitement créé approprié ou, s’il n’y en a pas, la valeur de dest.
La source doit fournir le nombre requis d’octets lisibles, et la destination doit fournir des octets accessibles en écriture. Les zones ne doivent pas se chevaucher : enfreindre cette exigence entraîne un comportement indéfini ; utilisez std::memmove lorsque les zones se chevauchent. La fonction ne vérifie pas la capacité des tampons.
Copier la représentation complète entre des objets distincts de même type trivialement copiable préserve la valeur, à condition qu’aucun ne soit un sous-objet potentiellement chevauchant. Ne considérez pas cette opération comme un remplacement des constructeurs de copie ou de l’affectation pour les objets qui gèrent des ressources. La création implicite d’objets ne supprime pas les restrictions liées à la durée de vie et aux types.
Dans l’exemple, sizeof src couvre le tableau entier, et non la taille d’un pointeur. Les deux tableaux contiennent des int et occupent des zones mémoire distinctes. La sortie attendue est 10 20 30 suivie d’un saut de ligne.
Exemples
#include <cstring>
#include <iostream>
int main() {
const int src[] = {10, 20, 30};
int dest[3] = {};
std::memcpy(dest, src, sizeof src);
std::cout << dest[0] << ' ' << dest[1] << ' ' << dest[2] << '\n';
}
Résultat
10 20 30
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.