Linux Certif

Toute la documentation sur la certification Linux LPI

mempcpy

NOM

mempcpy, wmempcpy - Copier une zone mémoire

SYNOPSIS

 #define _GNU_SOURCE
 

 #include <string.h>
 
 void *mempcpy(void *dest, const void *src, size_t n);
 
 #define _GNU_SOURCE
 

 #include <wchar.h>
 
 wchar_t *wmempcpy(wchar_t *dest, const wchar_t *src, size_t n);
 

DESCRIPTION

La fonction mempcpy() est quasiment identique à la fonction memcpy(3). Elle copie n octets à partir de l'objet commençant à src octets dans l'objet pointé par dest. Mais plutôt que de retourner la valeur de dest, elle retourne un pointeur sur l'octet suivant le dernier octet écrit.

Cette fonction est pratique dans les situations où plusieurs objets doivent être copiés dans des positions consécutives en mémoire.

La fonction wmempcpy() est identique mais prend des arguments de type wchar_t et copie n caractères larges.

VALEUR RENVOYÉE

dest + n .

CONFORMITÉ

Cette fonction est une extension GNU.

EXEMPLE

 void *
 combine (void *o1, size_t s1, void *o2, size_t s2) {
      void *result = malloc(s1 + s2);
      if (result != NULL)
           mempcpy(mempcpy(result, o1, s1), o2, s2);
      return result;
 }
 

VOIR AUSSI

memccpy(3), memcpy(3), memmove(3), wmemcpy(3), feature_test_macros(7)

TRADUCTION

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 4 juillet 2005 et révisée le 26 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 mempcpy ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.