====== strpbrk() ======

strpbrk ist definiert in der ''[[start|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 =====

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

**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 =====

<code cpp>
#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;
}
</code>

** Ausgabe **
<code>
Selbstlaute in 'Programmieren lernen auf proggen.org': o a i e e e e a u o e o
</code>

===== siehe auch =====

[[c:lib:string:start|string]]: [[c:lib:string:strcspn|strcspn()]], [[c:lib:string:strspn|strspn()]], [[c:lib:string:strstr|strstr()]], [[c:lib:string:strcmp|strcmp()]], [[c:lib:string:strncmp|stncmp()]]