MEMPCPY(3)

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 13 décembre 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.