1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
.\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
.\" Distributed under GPL
.\" based on the description in glibc source and infopages
.\"
.\" Corrections and additions, aeb
.\"
.\" 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
.SH ̾
envz_add, envz_entry, envz_get, envz_merge,
envz_remove, envz_strip \- Ķѿʸ
.SH
.nf
.sp
.B "#include <envz.h>"
.sp
.BI "error_t"
.BI "envz_add(char **" envz ", size_t *" envz_len ,
.ti 16n
.BI "const char *" name ", const char *" value );
.sp
.BI "char *"
.BI "envz_entry(const char *" envz ", size_t *" envz_len ", const char *" name );
.sp
.BI "char *"
.BI "envz_get(const char *" envz ", size_t *" envz_len ", const char *" name );
.sp
.BI "error_t"
.BI "envz_merge(char **" envz ", size_t *" envz_len ,
.ti 16n
.BI "const char *" envz2 ", size_t " envz2_len ", int " override );
.sp
.BI "void"
.BI "envz_remove(char **" envz ", size_t *" envz_len ", const char *" name );
.sp
.BI "void"
.BI "envz_strip(char **" envz ", size_t *" envz_len );
.sp
.SH
δؿ glibc ͭǤ롣
.LP
argz vector ĹդʸХåեؤΥݥǤ롣
.BR argz_add (3)
ȤΤȡ
envz vector ϡʸ "name=value (̾=)" ηˤʤäƤ̤
argz vector Ǥ롣ǽ '=' ʹߤϤ٤ͤȤߤʤ롣'=' ʤС
ͤ NULL Ȳᤵ롣(ʸΰֺǸʸ '=' ξ硢ͤ϶ʸ
"" Ȳᤵ롣)
.LP
δؿ envz vector 뤿ΤΤǤ롣
.LP
.B envz_add()
ϡʸ
.RI \&" name = value \&"
.RI ( value
NULL Ǥʤ) ޤ
.RI \&" name \&"
.RI ( value
NULL ξ)
envz vector
.RI (* envz ,* envz_len )
ɲä
.RI * envz
.RI * envz_len
롣
.I name
Ʊ̾ĥȥ꤬ä硢ΥȥϺ롣
.LP
.B envz_entry()
ϡenvz vector
.RI ( envz , envz_len )
̾
.I name
Υȥ롣
ĤäϤΥȥ֤Ĥʤä NULL ֤
.LP
.B envz_get()
ϡenvz vector
.RI ( envz , envz_len )
̾
.I name
Υȥ롣
Ĥäϥȥ֤ͤĤʤä NULL ֤
(ͤ NULL ξ⤢뤳Ȥդ뤳ȡ̾
.I name
Υȥ '=' 椬ʤ礬롣)
.LP
.B envz_merge()
ϡ
.B envz_add()
Ʊ褦
.I envz2
γƥȥ
.RI * envz
ɲä롣
.I override
ξ硢
.I envz2
ͤ
.RI * envz
Ʊ̾ͤϾ롣
ξϾʤ
.LP
.B envz_remove()
ϡ̾
.I name
Υȥ꤬
.RI (* envz ,* envz_len )
롣
.LP
.B envz_strip
ϡͤ NULL Υȥ٤ƺ롣
.SH ֤
ƤԤ envz ؿϤ٤ \fIerror_t\fP ֤ͤġ
\fB0\fP ֤ƥ顼ȯ
\fBENOMEM\fP ֤
.SH
.sp
.nf
#include <stdio.h>
#include <envz.h>
int
main(int argc, char *argv[], char *envp[]) {
int i, e_len = 0;
char *str;
for (i=0; envp[i] != NULL; i++)
e_len += strlen(envp[i]) + 1;
str = envz_entry(*envp, e_len, "HOME");
printf("%s\en", str);
str = envz_get(*envp, e_len, "HOME");
printf("%s\en", str);
return 0;
}
.fi
.SH
δؿ GNU ˤĥǤ롣դƻѤ뤳ȡ
.SH Ϣ
.BR argz (3)
|
