.\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
+.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" Distributed under GPL
+.\" %%%LICENSE_END
+.\"
.\" based on the description in glibc source and infopages
.\"
.\" Corrections and additions, aeb
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
.\"
.\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI, all rights reserved.
.\" Translated Mon Feb 2 2003 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
-.TH ENVZ_ADD 3 2007-05-18 "" "Linux Programmer's Manual"
-.SH ̾Á°
-envz_add, envz_entry, envz_get, envz_merge,
-envz_remove, envz_strip \- ´Ä¶ÊÑ¿ôʸ»úÎó¤ÎÁàºî
-.SH ½ñ¼°
+.TH ENVZ_ADD 3 2014\-05\-28 "" "Linux Programmer's Manual"
+.SH 名前
+envz_add, envz_entry, envz_get, envz_merge, envz_remove, envz_strip \-
+環境変数文字列の操作
+.SH 書式
.nf
-.B "#include <envz.h>"
+\fB#include <envz.h>\fP
-.BI "error_t envz_add(char **" envz ", size_t *" envz_len ,
-.ti 20n
-.BI "const char *" name ", const char *" value );
+\fBerror_t envz_add(char **\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB,\fP
+\fB const char *\fP\fIname\fP\fB, const char *\fP\fIvalue\fP\fB);\fP
-.BI "char *envz_entry(const char *" envz ", size_t *" envz_len \
-", const char *" name );
+\fBchar *envz_entry(const char *\fP\fIenvz\fP\fB, size_t \fP\fIenvz_len\fP\fB, const char *\fP\fIname\fP\fB);\fP
-.BI "char *envz_get(const char *" envz ", size_t *" envz_len \
-", const char *" name );
+\fBchar *envz_get(const char *\fP\fIenvz\fP\fB, size_t \fP\fIenvz_len\fP\fB, const char *\fP\fIname\fP\fB);\fP
-.BI "error_t envz_merge(char **" envz ", size_t *" envz_len ,
-.ti 20n
-.BI "const char *" envz2 ", size_t " envz2_len ", int " override );
+\fBerror_t envz_merge(char **\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB,\fP
+\fB const char *\fP\fIenvz2\fP\fB, size_t \fP\fIenvz2_len\fP\fB, int \fP\fIoverride\fP\fB);\fP
-.BI "void envz_remove(char **" envz ", size_t *" envz_len \
-", const char *" name );
+\fBvoid envz_remove(char **\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB, const char *\fP\fIname\fP\fB);\fP
-.BI "void envz_strip(char **" envz ", size_t *" envz_len );
+\fBvoid envz_strip(char **\fP\fIenvz\fP\fB, size_t *\fP\fIenvz_len\fP\fB);\fP
.fi
-.SH ÀâÌÀ
-¤³¤ì¤é¤Î´Ø¿ô glibc ¸ÇͤǤ¢¤ë¡£
+.SH 説明
+これらの関数は glibc 固有である。
.LP
-argz vector ¤ÏŤµ¾ðÊóÉÕ¤¤Îʸ»ú¥Ð¥Ã¥Õ¥¡¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£
-.BR argz_add (3)
-¤ò»²¾È¤Î¤³¤È¡£
-envz vector ¤Ï¡¢Ê¸»úÎó¤¬ "name=value (̾Á°=ÃÍ)" ¤Î·Á¼°¤Ë¤Ê¤Ã¤Æ¤¤¤ëÆÃÊ̤Ê
-argz vector ¤Ç¤¢¤ë¡£
-ºÇ½é¤Î \(aq=\(aq °Ê¹ß¤Ï¤¹¤Ù¤ÆÃͤȤߤʤµ¤ì¤ë¡£\(aq=\(aq ¤¬¤Ê¤±¤ì¤Ð¡¢
-ÃÍ¤Ï NULL ¤È²ò¼á¤µ¤ì¤ë¡£(ʸ»úÎó¤Î°ìÈֺǸå¤Îʸ»ú¤¬ \(aq=\(aq ¤Î¾ì¹ç¡¢Ãͤ϶õʸ»úÎó
-"" ¤È²ò¼á¤µ¤ì¤ë¡£)
+argz vector は長さ情報付きの文字バッファーへのポインターである。 \fBargz_add\fP(3) を参照のこと。 envz vector
+は、文字列が "name=value (名前=値)" の形式になっている特別な argz vector である。 最初の \(aq=\(aq
+以降はすべて値とみなされる。\(aq=\(aq がなければ、 値は NULL と解釈される。(文字列の一番最後の文字が \(aq=\(aq
+の場合、値は空文字列 "" と解釈される。)
.LP
-¤³¤ì¤é¤Î´Ø¿ô¤Ï envz vector ¤òÁàºî¤¹¤ë¤¿¤á¤Î¤â¤Î¤Ç¤¢¤ë¡£
+これらの関数は envz vector を操作するためのものである。
.LP
-.BR envz_add ()
-¤Ï¡¢Ê¸»úÎó
-.RI \&" name = value \&"
-.RI ( value
-¤¬ NULL ¤Ç¤Ê¤¤¾ì¹ç) ¤Þ¤¿¤Ï
-.RI \&" name \&"
-.RI ( value
-¤¬ NULL ¤Î¾ì¹ç) ¤ò
-envz vector
-.RI ( *envz ,\ *envz_len )
-¤ËÄɲä·¡¢
-.I *envz
-¤È
-.I *envz_len
-¤ò¹¹¿·¤¹¤ë¡£
-.I name
-¤ÈƱ¤¸Ì¾Á°¤ò»ý¤Ä¥¨¥ó¥È¥ê¤¬¤¢¤Ã¤¿¾ì¹ç¡¢¸µ¤Î¥¨¥ó¥È¥ê¤Ïºï½ü¤µ¤ì¤ë¡£
+\fBenvz_add\fP() は、文字列 "\fIname\fP=\fIvalue\fP" (\fIvalue\fP が NULL でない場合) または
+"\fIname\fP" (\fIvalue\fP が NULL の場合) を envz vector (\fI*envz\fP,\ \fI*envz_len\fP)
+に追加し、 \fI*envz\fP と \fI*envz_len\fP を更新する。 \fIname\fP
+と同じ名前を持つエントリーがあった場合、元のエントリーは削除される。
.LP
-.BR envz_entry ()
-¤Ï¡¢envz vector
-.RI ( envz ,\ envz_len )
-¤«¤é̾Á°¤¬
-.I name
-¤Î¥¨¥ó¥È¥ê¤ò¸¡º÷¤¹¤ë¡£
-¸«¤Ä¤«¤Ã¤¿¾ì¹ç¤Ï¤½¤Î¥¨¥ó¥È¥ê¤òÊÖ¤·¡¢¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
+\fBenvz_entry\fP() は、envz vector (\fIenvz\fP,\ \fIenvz_len\fP) から名前が \fIname\fP
+のエントリーを検索する。 見つかった場合はそのエントリーを返し、見つからなかった場合は NULL を返す。
.LP
-.BR envz_get ()
-¤Ï¡¢envz vector
-.RI ( envz ,\ envz_len )
-¤«¤é̾Á°¤¬
-.I name
-¤Î¥¨¥ó¥È¥ê¤ò¸¡º÷¤¹¤ë¡£
-¸«¤Ä¤«¤Ã¤¿¾ì¹ç¤Ï¥¨¥ó¥È¥ê¤ÎÃͤòÊÖ¤·¡¢¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
-(ÃÍ¤Ï NULL ¤Î¾ì¹ç¤â¤¢¤ë¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£Ì¾Á°¤¬
-.I name
-¤Î¥¨¥ó¥È¥ê¤Ë \(aq=\(aq Éä¹æ¤¬¤Ê¤¤¾ì¹ç¤¬³ºÅö¤¹¤ë¡£)
+\fBenvz_get\fP() は、envz vector (\fIenvz\fP,\ \fIenvz_len\fP) から名前が \fIname\fP
+のエントリーを検索する。 見つかった場合はエントリーの値を返し、見つからなかった場合は NULL を返す。 (値は NULL
+の場合もあることに注意すること。名前が \fIname\fP のエントリーに \(aq=\(aq 符号がない場合が該当する。)
.LP
-.BR envz_merge ()
-¤Ï¡¢
-.BR envz_add ()
-¤ÈƱ¤¸¤è¤¦¤Ë
-.I envz2
-¤Î³Æ¥¨¥ó¥È¥ê¤ò
-.I *envz
-¤ËÄɲ乤롣
-.I override
-¤¬¿¿¤Î¾ì¹ç¡¢
-.I envz2
-¤ÎÃͤÇ
-.I *envz
-Æâ¤ÎƱ¤¸Ì¾Á°¤ò¤â¤ÄÃͤϾå½ñ¤¤µ¤ì¤ë¡£
-µ¶¤Î¾ì¹ç¤Ï¾å½ñ¤¤µ¤ì¤Ê¤¤¡£
+\fBenvz_merge\fP() は、 \fBenvz_add\fP() と同じように \fIenvz2\fP の各エントリーを \fI*envz\fP に追加する。
+\fIoverride\fP が真の場合、 \fIenvz2\fP の値で \fI*envz\fP 内の同じ名前をもつ値は上書きされる。 偽の場合は上書きされない。
.LP
-.BR envz_remove ()
-¤Ï¡¢Ì¾Á°¤¬
-.I name
-¤Î¥¨¥ó¥È¥ê¤¬¤¢¤ì¤Ð
-.RI ( *envz ,\ *envz_len )
-¤«¤éºï½ü¤¹¤ë¡£
+\fBenvz_remove\fP() は、名前が \fIname\fP のエントリーがあれば (\fI*envz\fP,\ \fI*envz_len\fP)
+から削除する。
.LP
-.BR envz_strip ()
-¤Ï¡¢Ãͤ¬ NULL ¤Î¥¨¥ó¥È¥ê¤ò¤¹¤Ù¤Æºï½ü¤¹¤ë¡£
-.SH ÊÖ¤êÃÍ
-¥á¥â¥ê³ä¤êÅö¤Æ¤ò¹Ô¤¦ envz ´Ø¿ô·²¤Ï¤¹¤Ù¤Æ \fIerror_t\fP ·¿¤ÎÊÖ¤êÃͤò»ý¤Ä¡£
-À®¸ù¤·¤¿¾ì¹ç¤Ï 0 ¤òÊÖ¤·¡¢³ä¤êÅö¤Æ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï
-\fBENOMEM\fP ¤òÊÖ¤¹¡£
-.SH ½àµò
-¤³¤ì¤é¤Î´Ø¿ô¤Ï GNU ¤Ë¤è¤ë³ÈÄ¥¤Ç¤¢¤ë¡£Ãí°Õ¤·¤Æ»ÈÍѤ¹¤ë¤³¤È¡£
-.SH Îã
+\fBenvz_strip\fP() は、値が NULL のエントリーをすべて削除する。
+.SH 返り値
+メモリー割り当てを行う envz 関数群はすべて \fIerror_t\fP 型の返り値を持つ。 成功した場合は 0 を返し、割り当てエラーが発生した場合は
+\fBENOMEM\fP を返す。
+.SH 準拠
+これらの関数は GNU による拡張である。注意して使用すること。
+.SH 例
.nf
#include <stdio.h>
#include <stdlib.h>
exit(EXIT_SUCCESS);
}
.fi
-.SH ´ØÏ¢¹àÌÜ
-.BR argz_add (3)
+.SH 関連項目
+\fBargz_add\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
