LIBRARY

PRODUCTS

FORUMS

CART

Join CodeCogs

Or login with:

Computing › C › String.h ›

strtok

String tokens

View other versions (3)

Contents

Interface
Description
See Also
Standards
Bugs
Page Comments

Interface

#include <string.h>
char  strtok (char *str, const char *sep)
char  strtok_r (char *str, const char *sep, char **last)

Description

The strtok function is used to isolate sequential tokens in a null-terminated string, str. These tokens are separated in the string by at least one of the characters in sep. The first time that strtok is called, str should be specified; subsequent calls, wishing to obtain further tokens from the same string, should pass a null pointer instead. The separator string, sep, must be supplied each time, and may change between calls.

The implementation will behave as if no library function calls strtok.

The strtok_r function is a reentrant version of strtok. The context pointer last must be provided on each call. The strtok_r function may also be used to nest two parsing loops within one another, as long as separate context pointers are used. The strtok and strtok_r functions return a pointer to the beginning of each subsequent token in the string, after replacing the token itself with a NUL character. When no more tokens remain, a null pointer is returned.

Example:

Example - String tokens

Problem

The following uses strtok_r to parse two strings using separate contexts:

Workings

char test[80], blah[80];
char *sep = "\\/:;=-";
char *word, *phrase, *brkt, *brkb;
 
strcpy(test, "This;is.a:test:of=the/string\\tokenizer-function.");
 
for (word = strtok_r(test, sep, &brkt);
     word;
     word = strtok_r(NULL, sep, &brkt))
{
    strcpy(blah, "blah:blat:blab:blag");
 
    for (phrase = strtok_r(blah, sep, &brkb); 
           phrase; 
           phrase = strtok_r(NULL, sep, &brkb))
    {
        printf("So far we're at %s:%s\n", word, phrase);
    }
}

Standards

The strtok function conforms to ISO/IEC 9899:1990 ("ISO C90").

Bugs

The System V strtok, if handed a string containing only delimiter characters, will not alter the next starting point, so that a call to strtok with a different (or empty) delimiter string may return a non- NULL value. Since this implementation always alters the next starting point, such a sequence of calls would always return NULL.

Page Comments

$graceR\′s Photo$

graceR

18 Mar 11, 7:48PM

(1 reply)

converting from char * to int on result from strtok

input is something like "word-2" How do I convert from char pointer to int ?

char *tmp_result = NULL;
char standard = "";
int version = 0;
tmp_result = strtok( argv[1], delims );
printf( "token standard is "%s"
", tmp_result );
standard = *tmp_result;
if( tmp_result != NULL ) {
tmp_result = strtok( NULL, delims );
printf( "token tmp_result is "%s"
", tmp_result ); <===== prints "2" as it should be
version = *tmp_result;
printf( "token as_version is "%d"
", as_version ); <===== prints "50" after assignment

}

$john\′s Photo$

john

19 Mar 11, 11:31PM

A char pointer refers to the start memory address of a string. You can't directly transfer to an int.

However, it your trying to convert a string (ie "123.42") then you can use atoi for integers or atof for real numbers

$muthamilnathan\′s Photo$

muthamilnathan

6 Feb 11, 6:25AM

This context was very useful for me thank u

$CodeCogs\′s Photo$

CodeCogs

18 Jan 11, 1:59PM

Fixed

$csig\′s Photo$

csig

14 Jan 11, 9:22AM

//The return types are char*, so the prototypes should be:
char *	strtok (char *str, const char *sep);
char *	strtok_r (char *str, const char *sep, char **last);
 
//The sample code needs these changes (escaping the backslash):
char *sep = "\\/:;=-";
strcpy(test, "This;is.a:test:of=the/string\\tokenizer-function.");

You must login to leave a messge

char	`strtok` (char str, const char sep)
char	`strtok_r` (char str, const char sep, char **last)