memchr, _wmemchr

Nach oben zu mem.h - Index

Header-Datei

mem.h, string.h

Kategorie

Routinen für Speicher- und String-Bearbeitung, Inline-Routinen, C++ Prototyp-Routinen

Prototyp

void *memchr(const void s, int c, size_t n); /* nur C */

const void *memchr(const void *s, int c, size_t n); /* nur C++ */

void *memchr(void *s, int c, size_t n); /* nur C++ */

void *memchr(const void s, int c, size_t n); /* C und C++ */

void * _wmemchr(void s, int c, size_t n); /* Unicode-Version */

Beschreibung

Durchsucht n Bytes nach dem Zeichen c.

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

memchr durchsucht die ersten n Bytes des Blocks, auf den s verweist, nach dem Zeichen c.

Rückgabewert

Wenn erfolgreich, gibt memchr einen Zeiger auf das erste Vorkommen von c in s zurück, ansonsten gibt memchr NULL zurück.

Anmerkung:  Wenn Sie die intrinsische Version dieser Funktionen verwenden, wird im Fall von n = 0 NULL zurückgegeben.

Beispiel

 #include <string.h>
 #include <stdio.h>
 int main(void)
 {
     char str[17];
     char *ptr;
     strcpy(str, "This is a string");
     ptr = (char *) memchr(str, 'r', strlen(str));
     if (ptr)
        printf("The character 'r' is at position: %d\n", ptr - str);
     else
        printf("The character was not found\n");
     return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
memchr	+	+	+	+
_wmemchr		+