strpbrk()

strpbrk ist definiert in der string, die in C über string.h, bzw. in C++ über cstring eingebunden wird.

Funktion

strpbrk() sucht nach dem ersten Auftreten eines Zeichens. Es kann eine ganze Folge von Zeichen gleichzeitig gesucht werden, die gesuchten Zeichen werden in Form eines Strings an die Funktion übergeben. Wird eins der Zeichen im Suchstring entdeckt, so endet die Suche und es wird die Position des gefundenen Zeichens zurückgegeben.

Wird kein Zeichen gefunden, so gibt strpbrk() NULL zurück.

Signatur

#include <string.h>
char const * strpbrk( char const * string, char const * characters );
char       * strpbrk( char       * string, char const * characters );

string: Der zu durchsuchende String
characters: Eine Zeichenkette mit Zeichen, die im string gesucht werden.

Return value: Ein Zeiger auf das gefundene Zeichen (char *) oder NULL, falls kein Zeichen gefunden wurde.

Fehlerquellen

Beide Strings müssen mit einem Nullbyte enden.

Beispiel

#include <string.h>      // definiert strpbrk
 
#include <stdio.h>       // definiert printf
#include <stdlib.h>      // definiert EXIT_SUCCESS
 
int main( void )
{
  char * string   = "Programmieren lernen auf proggen.org";
  char   vowels[] = "aeiou";
 
  printf( "Selbstlaute in '%s': ", string );
 
  while( 1 )
  {
    string = strpbrk( string, vowels );  // Nächsten Selbstlaut finden
 
    if( string )
      printf( "%c ", *string );
    else
      break;
 
    string++;                            // gefundenen Selbstlaut überspringen
  }
  printf( "\n" );
 
  return EXIT_SUCCESS;
}

Ausgabe

Selbstlaute in 'Programmieren lernen auf proggen.org': o a i e e e e a u o e o

siehe auch