BEZEICHNUNG

memcpy - kopiert Speicherbereich

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <string.h>

void *memcpy(void Ziel[restrict .n], const void Quelle[restrict .n],
             size_t n);

BESCHREIBUNG

Die Funktion memcpy() kopiert n Byte von Speicherbereich Quelle nach Speicherbereich Ziel. Die Speicherbereiche dürfen sich nicht überschneiden. Verwenden Sie memmove(3), wenn sich die Speicherbereiche überschneiden.

RÜCKGABEWERT

Die Funktion memcpy() gibt einen Zeiger auf Ziel zurück.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS

C11, POSIX.1-2008.

GESCHICHTE

POSIX.1-2001, C89, SVr4, 4.3BSD.

WARNUNGEN

Ignorierung der Anforderung, dass sich Speicherbereiche nicht überlappen, ist die Quelle von erheblichen Fehlern. (POSIX und der C-Standard sagen deutlich, dass der Einsatz von memcpy() mit überlappenden Bereichen undefiniertes Verhalten hervorruft.) Insbesondere eine Leistungsoptimierung von memcpy() in Glibc 2.13 auf einigen Plattformen (darunter x86-64) führten zur Änderung der Reihenfolge in der Bytes von Quelle nach Ziel kopiert wurden.

Diese Änderung deckte Defekte in einer Reihe von Anwendungen auf, die überlappende Bereiche kopierten. Unter der bisherigen Implementierung hatte die Reihenfolge, in der Bytes kopiert wurden, den Fehler zufälligerweise versteckt, was dann bei der Änderung der Kopierreihenfolge aufgedeckt wurde. Unter Glibc 2.14 wurde ein versioniertes Symbol hinzugefügt, so dass alte Programme (d.h. solche, die gegen Glibc-Versionen älter als 2.14 gelinkt worden waren) eine memcpy()-Implementierung einsetzten, die solche überlappende Pufferfälle sicher handhabt (indem sie eine »ältere« Implementierung von memcpy() verwendet, die als memmove(3) bekannt gemacht wurde).

SIEHE AUCH

bcopy(3), bstring(3), memccpy(3), memmove(3), mempcpy(3), strcpy(3), strncpy(3), wmemcpy(3)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Patrick Rother <krd@gulu.net>, Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>, Helge Kreutzmann <debian@helgefjell.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.