====== strspn() ======

strspn ist definiert in der ''[[start|string]]'', die in C über ''string.h'', bzw. in C++ über ''cstring'' eingebunden wird.

===== Funktion =====
strspn() prüft wieviele Zeichen im String aus den gewünschten Zeichen besteht.
Es kann eine ganze Folge von Zeichen gleichzeitig gesucht werden; die gesuchten Zeichen werden in Form einer Zeichenkette an die Funktion übergeben. Die Position des ersten Zeichens, das **nicht** in der Zeichenkette erlaubter Zeichen enthalten ist, wird zurückgeben.

===== Signatur =====

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

**string**: Der zu durchsuchende String \\ 
**characters**: Eine Zeichenkette mit Zeichen, die vorne im ''string'' erwartet werden. \\ 

**Return value**: Ein [[size_t]], das die Position des ersten Zeichens im Suchstring angibt, das nicht in ''characters'' auftaucht.

===== Fehlerquellen =====

Beide Strings müssen mit einen Nullbyte enden.

===== Beispiel =====

<code cpp>
#include <string.h>      // definiert strspn

#include <stdio.h>       // definiert printf
#include <stdlib.h>      // definiert EXIT_SUCCESS

int main( void )
{
  char string[]     = "192.168.0.1";
  char characters[] = "0123456789";
  int pos;

  pos = strspn( string, characters );
  printf( "Die erste Zahl der IP-Adresse '%s' ist %d Ziffern lang.\n", string, pos );

  return EXIT_SUCCESS;
}
</code>

**Ausgabe:**
<code>
Die erste Zahl der IP-Adresse '192.168.0.1' ist 3 Ziffern lang.
</code>

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

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