strtok

文字列を区切り文字で分解する

【書式】
#include <string.h>
char *strtok(char *s1, const char *s2);

【説明】
分解対象文字列 s1 を、文字群 s2 中の文字を区切りに字句(トークン)に分解します。
次のような手順で strtok() を用いて文字列をトークンに分解することが出来ます。
  1. 最初の呼び出しでは s1 には分解対象の文字列を指定します。トークンがあれば、strtok() はトークンへのポインタを返却します。
  2. 2回目以降の呼び出しでは s1 に NULL を指定します。分解できるトークンがあるうちは、strtok() はトークンへのポインタを返却します。
  3. トークンがなくなると strtok() は NULL を返却します。
strtok() はトークンへのポインタを返却しながら、分解対象文字列 s1 中の区切り文字に空文字('\0')を埋めていきます。ですから、s1 に文字列リテラルや変更されては困る文字列を指定してはいけません。

【引数】
char *s1    : 分解対象文字列
const char *s2 : 区切り文字群。複数の区切り文字を指定することが可能。
            例えば '?' と '/'と '!' で区切りたいときには "?/!" と指定。

【戻り値】
トークンが見つかったとき    : 字句(トークン)へのポインタ
トークンが見つからなかったとき : NULL

【使用例】
#include        <stdio.h>
#include        <string.h>

int main(void)
{
        char str[] = "ABCD ef.1234.G";
        char *tp;

        /* スペース.を区切りに文字列を抽出 */   
        tp = strtok( str, " ." );
        puts( tp );
        while ( tp != NULL ) {
                tp = strtok( NULL," ." );
                if ( tp != NULL ) puts( tp );
        }
        
        return 0;
}
【実行結果】
ABCD
ef
1234
G
【どのような動きでstrtok() が文字列をトークンに分解していくか】

上記の使用例で strtok() がどのように文字列を分解していくか、下図で確認してください。 strtok() は空文字('\0)を区切り文字に埋めることにより、次々に文字列からトークンを取り出していきます。

  1. strtok()呼び出し前
  2. strtok() 1回目呼出し :  tp = strtok(str, " ." );  s1 には分解対象の文字列を指定
    strtok() は区切り文字に'\0'を設定
  3. strtok() 2回目呼出し :  tp = strtok(NULL, " ." );  s1 にはNULLを指定
    strtok() は次の区切り文字に'\0'を設定
  4. strtok() 3回目呼出し :  tp = strtok(NULL, " ." );
    strtok() は次の区切り文字に'\0'を設定
  5. strtok() 4回目呼出し :  tp = strtok(NULL, " ." );
  6. strtok() 5回目呼び出し : tp = strtok(NULL, " ." );  
    strtok() は分解するトークンがないので、tp に NULL を返却

戻る


banner
初心者のためのポイント学習C言語」
Copyright(c) 2000-2004 TOMOJI All Rights Reserved