manual/LDP_man-pages/release/man3/envz_add.3

   1 .\" Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" Distributed under GPL
   3 .\" based on the description in glibc source and infopages
   4 .\"
   5 .\" Corrections and additions, aeb
   6 .\"
   7 .\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI, all rights reserved.
   8 .\" Translated Mon Feb  2 2003 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   9 .\"
  10 .TH ENVZ_ADD 3 2007-05-18 "" "Linux Programmer's Manual"
  11 .SH Ì¾Á°
  12 envz_add, envz_entry, envz_get, envz_merge,
  13 envz_remove, envz_strip \- ´Ä¶ÊÑ¿ôÊ¸»úÎó¤ÎÁàºî
  14 .SH ½ñ¼°
  15 .nf
  16 .B "#include <envz.h>"
  17
  18 .BI "error_t envz_add(char **" envz ", size_t *" envz_len ,
  19 .ti 20n
  20 .BI "const char *" name ", const char *" value );
  21
  22 .BI "char *envz_entry(const char *" envz ", size_t *" envz_len \
  23 ", const char *" name );
  24
  25 .BI "char *envz_get(const char *" envz ", size_t *" envz_len \
  26 ", const char *" name );
  27
  28 .BI "error_t envz_merge(char **" envz ", size_t *" envz_len ,
  29 .ti 20n
  30 .BI "const char *" envz2 ", size_t " envz2_len ", int " override );
  31
  32 .BI "void envz_remove(char **" envz ", size_t *" envz_len \
  33 ", const char *" name );
  34
  35 .BI "void envz_strip(char **" envz ", size_t *" envz_len );
  36 .fi
  37 .SH ÀâÌÀ
  38 ¤³¤ì¤é¤Î´Ø¿ô glibc ¸ÇÍ¤Ç¤¢¤ë¡£
  39 .LP
  40 argz vector ¤ÏÄ¹¤µ¾ðÊóÉÕ¤¤ÎÊ¸»ú¥Ð¥Ã¥Õ¥¡¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤¢¤ë¡£
  41 .BR argz_add (3)
  42 ¤ò»²¾È¤Î¤³¤È¡£
  43 envz vector ¤Ï¡¢Ê¸»úÎó¤¬ "name=value (Ì¾Á°=ÃÍ)" ¤Î·Á¼°¤Ë¤Ê¤Ã¤Æ¤¤¤ëÆÃÊÌ¤Ê
  44 argz vector ¤Ç¤¢¤ë¡£
  45 ºÇ½é¤Î \(aq=\(aq °Ê¹ß¤Ï¤¹¤Ù¤ÆÃÍ¤È¤ß¤Ê¤µ¤ì¤ë¡£\(aq=\(aq ¤¬¤Ê¤±¤ì¤Ð¡¢
  46 ÃÍ¤Ï NULL ¤È²ò¼á¤µ¤ì¤ë¡£(Ê¸»úÎó¤Î°ìÈÖºÇ¸å¤ÎÊ¸»ú¤¬ \(aq=\(aq ¤Î¾ì¹ç¡¢ÃÍ¤Ï¶õÊ¸»úÎó
  47 "" ¤È²ò¼á¤µ¤ì¤ë¡£)
  48 .LP
  49 ¤³¤ì¤é¤Î´Ø¿ô¤Ï envz vector ¤òÁàºî¤¹¤ë¤¿¤á¤Î¤â¤Î¤Ç¤¢¤ë¡£
  50 .LP
  51 .BR envz_add ()
  52 ¤Ï¡¢Ê¸»úÎó
  53 .RI \&" name = value \&"
  54 .RI ( value
  55 ¤¬ NULL ¤Ç¤Ê¤¤¾ì¹ç) ¤Þ¤¿¤Ï
  56 .RI \&" name \&"
  57 .RI ( value
  58 ¤¬ NULL ¤Î¾ì¹ç) ¤ò
  59 envz vector
  60 .RI ( *envz ,\  *envz_len )
  61 ¤ËÄÉ²Ã¤·¡¢
  62 .I *envz
  63 ¤È
  64 .I *envz_len
  65 ¤ò¹¹¿·¤¹¤ë¡£
  66 .I name
  67 ¤ÈÆ±¤¸Ì¾Á°¤ò»ý¤Ä¥¨¥ó¥È¥ê¤¬¤¢¤Ã¤¿¾ì¹ç¡¢¸µ¤Î¥¨¥ó¥È¥ê¤Ïºï½ü¤µ¤ì¤ë¡£
  68 .LP
  69 .BR envz_entry ()
  70 ¤Ï¡¢envz vector
  71 .RI ( envz ,\  envz_len )
  72 ¤«¤éÌ¾Á°¤¬
  73 .I name
  74 ¤Î¥¨¥ó¥È¥ê¤ò¸¡º÷¤¹¤ë¡£
  75 ¸«¤Ä¤«¤Ã¤¿¾ì¹ç¤Ï¤½¤Î¥¨¥ó¥È¥ê¤òÊÖ¤·¡¢¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
  76 .LP
  77 .BR envz_get ()
  78 ¤Ï¡¢envz vector
  79 .RI ( envz ,\  envz_len )
  80 ¤«¤éÌ¾Á°¤¬
  81 .I name
  82 ¤Î¥¨¥ó¥È¥ê¤ò¸¡º÷¤¹¤ë¡£
  83 ¸«¤Ä¤«¤Ã¤¿¾ì¹ç¤Ï¥¨¥ó¥È¥ê¤ÎÃÍ¤òÊÖ¤·¡¢¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
  84 (ÃÍ¤Ï NULL ¤Î¾ì¹ç¤â¤¢¤ë¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£Ì¾Á°¤¬
  85 .I name
  86 ¤Î¥¨¥ó¥È¥ê¤Ë \(aq=\(aq Éä¹æ¤¬¤Ê¤¤¾ì¹ç¤¬³ºÅö¤¹¤ë¡£)
  87 .LP
  88 .BR envz_merge ()
  89 ¤Ï¡¢
  90 .BR envz_add ()
  91 ¤ÈÆ±¤¸¤è¤¦¤Ë
  92 .I envz2
  93 ¤Î³Æ¥¨¥ó¥È¥ê¤ò
  94 .I *envz
  95 ¤ËÄÉ²Ã¤¹¤ë¡£
  96 .I override
  97 ¤¬¿¿¤Î¾ì¹ç¡¢
  98 .I envz2
  99 ¤ÎÃÍ¤Ç
 100 .I *envz
 101 Æâ¤ÎÆ±¤¸Ì¾Á°¤ò¤â¤ÄÃÍ¤Ï¾å½ñ¤¤µ¤ì¤ë¡£
 102 µ¶¤Î¾ì¹ç¤Ï¾å½ñ¤¤µ¤ì¤Ê¤¤¡£
 103 .LP
 104 .BR envz_remove ()
 105 ¤Ï¡¢Ì¾Á°¤¬
 106 .I name
 107 ¤Î¥¨¥ó¥È¥ê¤¬¤¢¤ì¤Ð
 108 .RI ( *envz ,\  *envz_len )
 109 ¤«¤éºï½ü¤¹¤ë¡£
 110 .LP
 111 .BR envz_strip ()
 112 ¤Ï¡¢ÃÍ¤¬ NULL ¤Î¥¨¥ó¥È¥ê¤ò¤¹¤Ù¤Æºï½ü¤¹¤ë¡£
 113 .SH ÊÖ¤êÃÍ
 114 ¥á¥â¥ê³ä¤êÅö¤Æ¤ò¹Ô¤¦ envz ´Ø¿ô·²¤Ï¤¹¤Ù¤Æ \fIerror_t\fP ·¿¤ÎÊÖ¤êÃÍ¤ò»ý¤Ä¡£
 115 À®¸ù¤·¤¿¾ì¹ç¤Ï 0 ¤òÊÖ¤·¡¢³ä¤êÅö¤Æ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï
 116 \fBENOMEM\fP ¤òÊÖ¤¹¡£
 117 .SH ½àµò
 118 ¤³¤ì¤é¤Î´Ø¿ô¤Ï GNU ¤Ë¤è¤ë³ÈÄ¥¤Ç¤¢¤ë¡£Ãí°Õ¤·¤Æ»ÈÍÑ¤¹¤ë¤³¤È¡£
 119 .SH Îã
 120 .nf
 121 #include <stdio.h>
 122 #include <stdlib.h>
 123 #include <envz.h>
 124
 125 int
 126 main(int argc, char *argv[], char *envp[])
 127 {
 128     int i, e_len = 0;
 129     char *str;
 130
 131     for (i = 0; envp[i] != NULL; i++)
 132         e_len += strlen(envp[i]) + 1;
 133
 134     str = envz_entry(*envp, e_len, "HOME");
 135     printf("%s\en", str);
 136     str = envz_get(*envp, e_len, "HOME");
 137     printf("%s\en", str);
 138     exit(EXIT_SUCCESS);
 139 }
 140 .fi
 141 .SH ´ØÏ¢¹àÌÜ
 142 .BR argz_add (3)