📄 function.xattr-set.html

📁 php的帮助文档,涉及到PHP的案例和基本语法,以及实际应用内容
💻 HTML
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html> <head>  <title>Set an extended attribute</title>  <meta http-equiv="content-type" content="text/html; charset=UTF-8"> </head> <body><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="function.xattr-remove.html">xattr_remove</a></div> <div class="next" style="text-align: right; float: right;"><a href="function.xattr-supported.html">xattr_supported</a></div> <div class="up"><a href="ref.xattr.html">xattr Functions</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div><hr /><div id="function.xattr-set" class="refentry"> <div class="refnamediv">  <h1 class="refname">xattr_set</h1>  <p class="verinfo">(PECL xattr:0.9-1.0)</p><p class="refpurpose"><span class="refname">xattr_set</span> &mdash; <span class="dc-title">   Set an extended attribute  </span></p> </div> <div class="refsect1 description">  <h3 class="title">Description</h3>  <div class="methodsynopsis dc-description">   <span class="type">bool</span> <span class="methodname"><b><b>xattr_set</b></b></span>    ( <span class="methodparam"><span class="type">string</span> <tt class="parameter">$filename</tt></span>   , <span class="methodparam"><span class="type">string</span> <tt class="parameter">$name</tt></span>   , <span class="methodparam"><span class="type">string</span> <tt class="parameter">$value</tt></span>   [, <span class="methodparam"><span class="type">int</span> <tt class="parameter">$flags</tt></span>  ] )</div>  <p class="para rdfs-comment">   This function sets the value of an extended attribute of a file.  </p>  <p class="para">Extended attributes have two different namespaces: user and root. The user namespace is available to all users, while the root namespaceis available only to users with root privileges. xattr operates on the usernamespace  by default, but this can be changed with the<i><tt class="parameter">flags</tt></i> parameter.</p> </div> <div class="refsect1 parameters">  <h3 class="title">Parameters</h3>  <p class="para">   <dl>    <dt>     <span class="term"><i><tt class="parameter">filename</tt></i></span>     <dd>      <p class="para">       The file in which we set the attribute.      </p>     </dd>    </dt>    <dt>     <span class="term"><i><tt class="parameter">name</tt></i></span>     <dd>      <p class="para">       The name of the extended attribute. This attribute will be created if        it doesn&#039;t exist or replaced otherwise. You can change this behaviour        by using the <i><tt class="parameter">flags</tt></i> parameter.      </p>     </dd>    </dt>    <dt>     <span class="term"><i><tt class="parameter">value</tt></i></span>     <dd>      <p class="para">       The value of the attribute.      </p>     </dd>    </dt>    <dt>     <span class="term"><i><tt class="parameter">flags</tt></i></span>     <dd>      <p class="para">       <table border="5">        <caption><b>Supported xattr flags</b></caption>        <colgroup>         <tbody valign="middle" class="tbody">          <tr valign="middle">           <td colspan="1" rowspan="1" align="left"><b><tt>XATTR_CREATE</tt></b></td>           <td colspan="1" rowspan="1" align="left">Function will fail if extended attribute already exists.</td>          </tr>          <tr valign="middle">           <td colspan="1" rowspan="1" align="left"><b><tt>XATTR_REPLACE</tt></b></td>           <td colspan="1" rowspan="1" align="left">Function will fail if extended attribute doesn&#039;t exist.</td>          </tr>          <tr valign="middle">           <td colspan="1" rowspan="1" align="left"><b><tt>XATTR_DONTFOLLOW</tt></b></td>           <td colspan="1" rowspan="1" align="left">Do not follow the symbolic link but operate on symbolic link itself.</td>          </tr>          <tr valign="middle">           <td colspan="1" rowspan="1" align="left"><b><tt>XATTR_ROOT</tt></b></td>           <td colspan="1" rowspan="1" align="left">Set attribute in root (trusted) namespace. Requires root privileges.</td>          </tr>         </tbody>        </colgroup>       </table>      </p>     </dd>    </dt>   </dl>  </p> </div> <div class="refsect1 returnvalues">  <h3 class="title">Return Values</h3>  <p class="para">   Returns <b><tt>TRUE</tt></b> on success or <b><tt>FALSE</tt></b> on failure.  </p> </div> <div class="refsect1 examples">  <h3 class="title">Examples</h3>  <p class="para">   <div class="example">    <p><b>Example #1 Sets extended attributes on .wav file</b></p>    <div class="example-contents"><div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$file&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'my_favourite_song.wav'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">xattr_set</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'Artist'</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'Someone'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">xattr_set</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'My&nbsp;ranking'</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'Good'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">xattr_set</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'Listen&nbsp;count'</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'34'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/*&nbsp;...&nbsp;other&nbsp;code&nbsp;...&nbsp;*/<br /><br /></span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"You've&nbsp;played&nbsp;this&nbsp;song&nbsp;%d&nbsp;times"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">xattr_get</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'Listen&nbsp;count'</span><span style="color: #007700">));&nbsp;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>    </div>   </div>  </p> </div> <div class="refsect1 seealso">  <h3 class="title">See Also</h3>  <p class="para">   <ul class="simplelist">    <li class="member"><a href="function.xattr-get.html" class="function" rel="rdfs-seeAlso">xattr_get()</a></li>    <li class="member"><a href="function.xattr-remove.html" class="function" rel="rdfs-seeAlso">xattr_remove()</a></li>   </ul>  </p> </div></div><hr /><div style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="function.xattr-remove.html">xattr_remove</a></div> <div class="next" style="text-align: right; float: right;"><a href="function.xattr-supported.html">xattr_supported</a></div> <div class="up"><a href="ref.xattr.html">xattr Functions</a></div> <div class="home"><a href="index.html">PHP Manual</a></div></div></body></html>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -