strsepのヘルプ・マニュアル／リナックスコマンド

strsepのヘルプ・マニュアル

help
man

strsep --help

man strsep

STRSEP(3) Linux Programmer’s Manual STRSEP(3) 名前 strsep - 文字列からトークンを取り出す書式 #include char *strsep(char **stringp, const char *delim); glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照): strsep(): _BSD_SOURCE 説明 *stringp が NULL の場合、 strsep() 関数は何もせずに NULL を返す。さもなければ、文字列 stringp を delim に含まれる文字で区切ったトークンのうち最初のものを返す。トークンは (区切り文字を上書きすることによって) '\0' 文字で終端され、 *stringp は切り出されたトークンの次の位置を示すように更新される。区切り文字が見つからない場合、*stringp 文字列全体がトークンとして扱われ、*stringp は NULL となる。返り値 strsep() 関数は、トークンへのポインタを返す。つまり、元の *stringp の値を返す。準拠 4.4BSD. 注意 strsep() 関数は、 strtok(3) 関数が空のフィールドを扱えないために、その代替品として導入された。しかしながら、 strtok(3) 関数は C89/C99 に準拠しており、より移植性がある。バグこの関数を使う時は注意すること。もし使うなら、以下のことに注意すること。 * この関数は最初の引数を変更する。 * この関数は定数文字列には使えない。 * 区切り文字が何であったか分からなくなる。関連項目 index(3), memchr(3), rindex(3), strchr(3), strpbrk(3), strspn(3), strstr(3), strtok(3) GNU 2009-01-16 STRSEP(3)

STRSEP(3) Linux Programmer’s Manual STRSEP(3) NAME strsep - extract token from string SYNOPSIS #include char *strsep(char **stringp, const char *delim); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): strsep(): _BSD_SOURCE DESCRIPTION If *stringp is NULL, the strsep() function returns NULL and does noth- ing else. Otherwise, this function finds the first token in the string *stringp, where tokens are delimited by symbols in the string delim. This token is terminated with a '\0' character (by overwriting the delimiter) and *stringp is updated to point past the token. In case no delimiter was found, the token is taken to be the entire string *stringp, and *stringp is made NULL. RETURN VALUE The strsep() function returns a pointer to the token, that is, it returns the original value of *stringp. CONFORMING TO 4.4BSD. NOTES The strsep() function was introduced as a replacement for strtok(3), since the latter cannot handle empty fields. However, strtok(3) con- forms to C89/C99 and hence is more portable. BUGS Be cautious when using this function. If you do use it, note that: * This function modifies its first argument. * This function cannot be used on constant strings. * The identity of the delimiting character is lost. SEE ALSO index(3), memchr(3), rindex(3), strchr(3), strpbrk(3), strspn(3), strstr(3), strtok(3) COLOPHON This page is part of release 3.22 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/. GNU 2009-01-16 STRSEP(3)

リナックスコマンド