MEMPCPY

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 11 novembre 2003
Index Menu principal

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 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 17 juillet 2008.

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.

Dernière mise à jour : 17 juillet 2008