.\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI, all rights reserved.
.\" Translated Mon Feb 2 2003 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
-.TH ARGZ_ADD 3 2007\-05\-18 "" "Linux Programmer's Manual"
+.TH ARGZ_ADD 3 2014\-05\-28 "" "Linux Programmer's Manual"
.SH 名前
argz_add, argz_add_sep, argz_append, argz_count, argz_create,
argz_create_sep, argz_delete, argz_extract, argz_insert, argz_next,
\fBerror_t argz_create_sep(const char *\fP\fIstr\fP\fB, int \fP\fIsep\fP\fB, char **\fP\fIargz\fP\fB,\fP
\fB size_t *\fP\fIargz_len\fP\fB);\fP
.sp
-\fBerror_t argz_delete(char **\fP\fIargz\fP\fB, size_t *\fP\fIargz_len\fP\fB, char *\fP\fIentry\fP\fB);\fP
+\fBvoid argz_delete(char **\fP\fIargz\fP\fB, size_t *\fP\fIargz_len\fP\fB, char *\fP\fIentry\fP\fB);\fP
.sp
-\fBvoid argz_extract(char *\fP\fIargz\fP\fB, size_t \fP\fIargz_len\fP\fB, char **\fP\fIargv\fP\fB);\fP
+\fBvoid argz_extract(const char *\fP\fIargz\fP\fB, size_t \fP\fIargz_len\fP\fB, char **\fP\fIargv\fP\fB);\fP
.sp
\fBerror_t argz_insert(char **\fP\fIargz\fP\fB, size_t *\fP\fIargz_len\fP\fB, char *\fP\fIbefore\fP\fB,\fP
\fB const char *\fP\fIentry\fP\fB);\fP
.sp
-\fBchar *argz_next(char *\fP\fIargz\fP\fB, size_t \fP\fIargz_len\fP\fB, const char *\fP\fIentry\fP\fB);\fP
+\fBchar *argz_next(const char *\fP\fIargz\fP\fB, size_t \fP\fIargz_len\fP\fB, const char *\fP\fIentry\fP\fB);\fP
.sp
\fBerror_t argz_replace(char **\fP\fIargz\fP\fB, size_t *\fP\fIargz_len\fP\fB, const char *\fP\fIstr\fP\fB,\fP
\fB const char *\fP\fIwith\fP\fB, unsigned int *\fP\fIreplace_count\fP\fB);\fP
.SH 説明
これらの関数は glibc 固有である。
.LP
-argz vector ã\81¯é\95·ã\81\95æ\83\85å ±ä»\98ã\81\8dã\81®æ\96\87å\97ã\83\90ã\83\83ã\83\95ã\82¡ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\81§ã\81\82ã\82\8bã\80\82 æ\96\87å\97ã\83\90ã\83\83ã\83\95ã\82¡では、複数の文字列がヌルバイト (\(aq\e0\(aq)
-で区切られており、 文字列の配列として解釈されるようになっている。 長さが 0 でない場合、バッファの最後のバイトはヌルバイトでなければならない。
+argz vector ã\81¯é\95·ã\81\95æ\83\85å ±ä»\98ã\81\8dã\81®æ\96\87å\97ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81§ã\81\82ã\82\8bã\80\82 æ\96\87å\97ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼では、複数の文字列がヌルバイト (\(aq\e0\(aq)
+ã\81§å\8cºå\88\87ã\82\89ã\82\8cã\81¦ã\81\8aã\82\8aã\80\81 æ\96\87å\97å\88\97ã\81®é\85\8då\88\97ã\81¨ã\81\97ã\81¦è§£é\87\88ã\81\95ã\82\8cã\82\8bã\82\88ã\81\86ã\81«ã\81ªã\81£ã\81¦ã\81\84ã\82\8bã\80\82 é\95·ã\81\95ã\81\8c 0 ã\81§ã\81ªã\81\84å ´å\90\88ã\80\81ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81®æ\9c\80å¾\8cã\81®ã\83\90ã\82¤ã\83\88ã\81¯ã\83\8cã\83«ã\83\90ã\82¤ã\83\88ã\81§ã\81ªã\81\91ã\82\8cã\81°ã\81ªã\82\89ã\81ªã\81\84ã\80\82
.LP
これらの関数は argz vector を操作するためのものである。 ペア (NULL,0) は argz vector であり、逆に言えば 長さ 0
-の argz vectorはヌルポインタを持たなければならない。 空でない argz vector の割り当ては \fBmalloc\fP(3)
+ã\81® argz vectorã\81¯ã\83\8cã\83«ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92æ\8c\81ã\81\9fã\81ªã\81\91ã\82\8cã\81°ã\81ªã\82\89ã\81ªã\81\84ã\80\82 空ã\81§ã\81ªã\81\84 argz vector ã\81®å\89²ã\82\8aå½\93ã\81¦ã\81¯ \fBmalloc\fP(3)
を使って行われる。したがって、argz vector を解放するのに \fBfree\fP(3) を使うことができる。
.LP
\fBargz_add\fP() は、文字列 \fIstr\fP を配列 \fI*argz\fP の末尾に追加し、 \fI*argz\fP と \fI*argz_len\fP
を更新する。
.LP
\fBargz_add_sep\fP() も同様の動作をするが、区切り文字 \fIdelim\fP にしたがって文字列 \fIstr\fP
-ã\82\92è¤\87æ\95°ã\81®æ\96\87å\97å\88\97ã\81«å\88\86å\89²ã\81\99ã\82\8bç\82¹ã\81\8cç\95°ã\81ªã\82\8bã\80\82 ä¾\8bã\81\88ã\81°ã\80\81å\8cºå\88\87ã\82\8aæ\96\87å\97 \(aq:\(aq ã\82\92æ\8c\87å®\9aã\81\97ã\81¦ã\80\81UNIX ã\82µã\83¼ã\83\81ã\83»ã\83\91ã\82¹ã\81«å¯¾ã\81\97ã\81¦
+を複数の文字列に分割する点が異なる。 例えば、区切り文字 \(aq:\(aq を指定して、UNIX サーチパスに対して
この関数を使うことができるだろう。
.LP
\fBargz_append\fP() は argz vector (\fIbuf\fP,\ \fIbuf_len\fP) の後ろに (\fI*argz\fP,\ \fI*argz_len\fP) を付け加え、 \fI*argz\fP と \fI*argz_len\fP を更新する。 (したがって、 \fI*argz_len\fP は
.LP
\fBargz_delete\fP() は、 \fIentry\fP で指し示された文字列を argz vector (\fI*argz\fP,\ \fI*argz_len\fP) から削除し、 \fI*argz\fP と \fI*argz_len\fP を更新する。
.LP
-\fBargz_extract\fP() は \fBargz_create\fP() の反対の操作を行う。argz vector (\fIargz\fP,\ \fIargz_len\fP) を調べ、 \fIargv\fP から始まる配列をサブ文字列へのポインタで埋めていき、 一番最後に NULL を入れて、UNIX
+\fBargz_extract\fP() ã\81¯ \fBargz_create\fP() ã\81®å\8f\8d対ã\81®æ\93\8dä½\9cã\82\92è¡\8cã\81\86ã\80\82argz vector (\fIargz\fP,\ \fIargz_len\fP) ã\82\92調ã\81¹ã\80\81 \fIargv\fP ã\81\8bã\82\89å§\8bã\81¾ã\82\8bé\85\8då\88\97ã\82\92ã\82µã\83\96æ\96\87å\97å\88\97ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81§å\9f\8bã\82\81ã\81¦ã\81\84ã\81\8dã\80\81 ä¸\80ç\95ªæ\9c\80å¾\8cã\81« NULL ã\82\92å\85¥ã\82\8cã\81¦ã\80\81UNIX
流の argv ベクトルを作成する。 配列 \fIargv\fP は \fIargz_count\fP(\fIargz\fP,\fIargz_len\fP) + 1
-個のポインタを収容できる空間を持っていなければならない。
+å\80\8bã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92å\8f\8e容ã\81§ã\81\8dã\82\8b空é\96\93ã\82\92æ\8c\81ã\81£ã\81¦ã\81\84ã\81ªã\81\91ã\82\8cã\81°ã\81ªã\82\89ã\81ªã\81\84ã\80\82
.LP
\fBargz_insert\fP() は \fBargz_delete\fP() の反対の操作を行う。argz vector (\fI*argz\fP,\ \fI*argz_len\fP) の位置 \fIbefore\fP に引き数 \fIentry\fP を挿入し、 \fI*argz\fP と \fI*argz_len\fP
を更新する。 \fIbefore\fP が NULL の場合、 \fIentry\fP は末尾に挿入される。
.LP
\fBargz_next\fP() は argz vector を順番に調べるための関数である。 \fIentry\fP が NULL
-ã\81®å ´å\90\88ã\80\81æ\9c\80å\88\9dã\81®ã\82¨ã\83³ã\83\88ã\83ªã\82\92è¿\94ã\81\99ã\80\82 ã\81\9dã\81\86ã\81§ã\81ªã\81\84å ´å\90\88ã\80\81次ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\82\92è¿\94ã\81\99ã\80\82 次ã\81®ã\82¨ã\83³ã\83\88ã\83ªがない場合、NULL を返す。
+ã\81®å ´å\90\88ã\80\81æ\9c\80å\88\9dã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\82\92è¿\94ã\81\99ã\80\82 ã\81\9dã\81\86ã\81§ã\81ªã\81\84å ´å\90\88ã\80\81次ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\82\92è¿\94ã\81\99ã\80\82 次ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼がない場合、NULL を返す。
.LP
\fBargz_replace\fP() は、 \fIstr\fP をすべて \fIwith\fP で置き換える (必要に応じて argz の再割り当てを行う)。
\fIreplace_count\fP が NULL でない場合、 \fI*replace_count\fP を置き換えを行った数だけ増やす。
\fBargz_stringify\fP() は \fBargz_create_sep\fP() の反対の操作を行う。 末尾の ヌルバイト以外の全てのヌルバイト
(\(aq\e0\(aq) を \fIsep\fP で置き換えて、 argz vector を通常の文字列に変換する。
.SH 返り値
-メモリ割り当てを行う argz 関数群はすべて \fIerror_t\fP 型の返り値を持つ。 成功した場合は 0 を返し、割り当てエラーが発生した場合は
+メモリー割り当てを行う argz 関数群はすべて \fIerror_t\fP 型の返り値を持つ。 成功した場合は 0 を返し、割り当てエラーが発生した場合は
\fBENOMEM\fP を返す。
.SH 準拠
これらの関数は GNU による拡張である。注意して使用すること。
.SH 関連項目
\fBenvz_add\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.65 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
