std::memmove

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Null-terminierte Byte-Strings

Funktionen
Zeichenklassifizierung
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
Zeichenmanipulation
tolower	toupper
Konvertierungen in numerische Formate
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
Stringmanipulation
strcpy strncpy strxfrm	strcat strncat
Stringuntersuchung
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Zeichen-Array-Funktionen
memchr memcmp memset	memcpy memmove
Sonstiges
strerror

 

Definiert in Header <cstring>
void* memmove( void* dest, const void* src, std::size_t count );

Führt die folgenden Operationen in der angegebenen Reihenfolge aus

1. Erzeugt implizit Objekte an dest.
2. Kopiert count Zeichen (als ob vom Typ unsigned char, unten ebenfalls) aus dem Objekt, auf das src zeigt, in ein temporäres Array arr von count Zeichen, wobei arr nicht mit den Objekten überlappt, auf die dest und src zeigen.
3. Kopiert count Zeichen aus arr in das Objekt, auf das dest zeigt.

Wenn dest oder src ein Nullzeiger oder ein ungültiger Zeiger ist, ist das Verhalten undefiniert.

Parameter

dest	-	Zeiger auf den Speicherort, zu dem kopiert werden soll
src	-	Zeiger auf den Speicherort, von dem kopiert werden soll
zählt	-	Anzahl der zu kopierenden Bytes

Rückgabewert

Wenn ein geeignetes erzeugtes Objekt vorhanden ist, wird ein Zeiger darauf zurückgegeben; andernfalls wird dest zurückgegeben.

Hinweise

Obwohl die Spezifikation besagt, dass ein temporärer Puffer verwendet wird, verursachen tatsächliche Implementierungen dieser Funktion nicht den Overhead von doppeltem Kopieren oder zusätzlichen Speicher. Für kleine count können Register geladen und geschrieben werden; für größere Blöcke ist ein gängiger Ansatz (glibc und bsd libc), Bytes vorwärts vom Anfang des Puffers zu kopieren, wenn das Ziel vor der Quelle beginnt, und rückwärts vom Ende, wenn dies nicht der Fall ist, mit einem Fallback auf std::memcpy, wenn überhaupt keine Überlappung vorliegt.

Wo Strict Aliasing das Betrachten desselben Speichers als Werte zweier verschiedener Typen verbietet, kann std::memmove verwendet werden, um die Werte zu konvertieren.

Beispiel

Führen Sie diesen Code aus

#include <cstring>
#include <iostream>
 
int main()
{
    char str[] = "1234567890";
    std::cout << str << '\n';
    std::memmove(str + 4, str + 3, 3); // copies from [4, 5, 6] to [5, 6, 7]
    std::cout << str << '\n';
}

Ausgabe

1234567890
1234456890

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 4064	C++98	Es war unklar, ob der zurückgegebene Zeiger auf ein geeignetes erzeugtes Objekt zeigt	wurde klargestellt

Siehe auch

memcpy	kopiert einen Puffer in einen anderen (Funktion)
memset	füllt einen Puffer mit einem Zeichen (Funktion)
wmemmove	kopiert eine bestimmte Anzahl breiter Zeichen zwischen zwei, möglicherweise überlappenden, Arrays (Funktion)
copycopy_if (C++11)	Kopiert einen Elementbereich an einen neuen Speicherort (Funktionstempelat)
copy_backward	Kopiert einen Elementbereich in umgekehrter Reihenfolge (Funktionstempelat)
is_trivially_copyable (C++11)	prüft, ob ein Typ trivial kopierbar ist (Klassenvorlage)
C-Dokumentation für memmove