MEMPCPY(3) Руководство программиста Linux MEMPCPY(3)

ИМЯ

mempcpy, wmempcpy — копирует участок памяти

ОБЗОР

#define _GNU_SOURCE         /* смотрите feature_test_macros(7) */
#include <string.h>
void *mempcpy(void *dest, const void *src, size_t n);
#define _GNU_SOURCE         /* смотрите feature_test_macros(7) */
#include <wchar.h>
wchar_t *wmempcpy(wchar_t *dest, const wchar_t *src, size_t n);

ОПИСАНИЕ

Функция mempcpy() почти идентична memcpy(3). Она копирует n байт из src в dest, но вместо возвращения значения dest, она возвращает указатель на байт, следующий за последним записанным байтом.

Она удобна если требуется скопировать несколько участков памяти в другой участок последовательно, чтобы они располагались в нем друг за другом.

wmempcpy() делает тоже самое, но принимает wchar_t тип аргументов и копирует n широких символов.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

dest + n.

ВЕРСИИ

Впервые mempcpy() появилась в glibc версии 2.1.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
mempcpy(), wmempcpy() Безвредность в нитях MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ

Эта функция является расширением GNU.

ПРИМЕР

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

СМОТРИТЕ ТАКЖЕ

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

2015-03-02 GNU