memccpy

Nach oben zu mem.h - Index

Header-Datei

mem.h, string.h

Kategorie

Routinen für Speicher- und String-Bearbeitung

Prototyp

void *memccpy(void *dest, const void *src, int c, size_t n);

Beschreibung

Kopiert einen Block von n Bytes.

memccpy ist auf UNIX System V-Systemen verfügbar.

memccpy kopiert einen Block von n Bytes von src nach dest. Der Kopiervorgang endet, sobald eine der folgenden Bedingungen erfüllt ist:

• Das Zeichen c wird zum ersten Mal nach dest kopiert.
• Es wurden n Bytes nach dest kopiert.

Rückgabewert

Wurde c kopiert, gibt memccpy einen Zeiger auf das c unmittelbar folgende Byte in dest zurück; andernfalls gibt memccpy NULL zurück.

Beispiel

 #include <string.h>
 #include <stdio.h>
 int main(void)
 {
    char *src = "This is the source string";
    char dest[50];
    char *ptr;
    ptr = (char *) memccpy(dest, src, 'c', strlen(src));
    if (ptr)
    {
       *ptr = '\0';
       printf("The character was found: %s\n", dest);
    }
    else
       printf("The character wasn't found\n");
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+