strspn()

strspn ist definiert in der 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

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

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

#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;
}

Ausgabe:

Die erste Zahl der IP-Adresse '192.168.0.1' ist 3 Ziffern lang.

siehe auch