uTools-Manuals/docs/php/xattr_remove.html
2019-04-28 19:00:34 +08:00

132 lines
5.3 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Remove an extended attribute</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.xattr-remove" class="refentry">
<div class="refnamediv">
<h1 class="refname">xattr_remove</h1>
<p class="verinfo">(PECL xattr &gt;= 0.9.0)</p><p class="refpurpose"><span class="refname">xattr_remove</span> &mdash; <span class="dc-title">
Remove an extended attribute
</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.xattr-remove-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>xattr_remove</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$filename</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$name</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$flags</code><span class="initializer"> = 0</span></span>
] ) : <span class="type">bool</span></div>
<p class="para rdfs-comment">
This function removes an extended attribute of a file.
</p>
<p class="para">扩展的属性有两种 不同的命名空间user
和 root。user 命名空间对所有用户均有效,而 root
命名空间仅对拥有 root 权限的用户有效。
xattr 默认在 user 命名空间上操作,但可使用
<code class="parameter">flags</code> 参数进行更改。</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.xattr-remove-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">filename</code></dt>
<dd>
<p class="para">
The file from which we remove the attribute.
</p>
</dd>
<dt>
<code class="parameter">name</code></dt>
<dd>
<p class="para">
The name of the attribute to remove.
</p>
</dd>
<dt>
<code class="parameter">flags</code></dt>
<dd>
<p class="para">
<table class="doctable table">
<caption><strong>Supported xattr flags</strong></caption>
<tbody class="tbody">
<tr>
<td><strong><code>XATTR_DONTFOLLOW</code></strong></td>
<td>Do not follow the symbolic link but operate on symbolic link itself.</td>
</tr>
<tr>
<td><strong><code>XATTR_ROOT</code></strong></td>
<td>Set attribute in root (trusted) namespace. Requires root privileges.</td>
</tr>
</tbody>
</table>
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.xattr-remove-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
成功时返回 <strong><code>TRUE</code></strong> 或者在失败时返回 <strong><code>FALSE</code></strong>
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.xattr-remove-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-2859">
<p><strong>Example #1 Removes all extended attributes of a file</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$file&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #DD0000">'some_file'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$attributes&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">xattr_list</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">);<br /><br />foreach&nbsp;(</span><span style="color: #0000BB">$attributes&nbsp;</span><span style="color: #007700">as&nbsp;</span><span style="color: #0000BB">$attr_name</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">xattr_remove</span><span style="color: #007700">(</span><span style="color: #0000BB">$file</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$attr_name</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.xattr-remove-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="xattr_list.html" class="function" rel="rdfs-seeAlso">xattr_list()</a> - Get a list of extended attributes</span></li>
<li class="member"><span class="function"><a href="xattr_set.html" class="function" rel="rdfs-seeAlso">xattr_set()</a> - Set an extended attribute</span></li>
<li class="member"><span class="function"><a href="xattr_get.html" class="function" rel="rdfs-seeAlso">xattr_get()</a> - Get an extended attribute</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>