dio_fcntl
(PHP 4 >= 4.2.0, PHP 5 < 5.1.0)
dio_fcntl — 在 fd 上执行 C 标准库的 fcntl
说明
dio_fcntl() 函数在 fd
文件描述符上执行 cmd
指定的操作。一些命令需要提供额外的 args
参数。
参数
fd
dio_open() 返回的文件描述符。
cmd
可以是以下操作:
-
F_SETLK- 设置或清除锁。如果其他人持有锁 dio_fcntl() 返回 -1。 -
F_GETLK- 如果其他人阻止锁定,dio_fcntl() 返回关联数组(如下所述)。如果没有阻塞,键“type”将设置为F_UNLCK。 -
F_DUPFD- 查找大于或等于args的最小可用文件描述符,并将其返回。 -
F_SETFL- 设置args指定的文件描述符标志。可以是O_APPEND、O_NONBLOCK或O_ASYNC。要使用O_ASYNC需要依赖 PCNTL 扩展。
args
当 cmd 是 F_SETLK
或 F_SETLLW 时,args
是包含以下键的关联数组:
返回值
返回 C 调用的结果。
示例
示例 #1 设置并清除锁
<?php
$fd = dio_open('/dev/ttyS0', O_RDWR);
if (dio_fcntl($fd, F_SETLK, Array("type"=>F_WRLCK)) == -1) {
// the file descriptor appears locked
echo "The lock can not be cleared. It is held by someone else.";
} else {
echo "Lock successfully set/cleared";
}
dio_close($fd);
?>注释
注意:
此函数未在 Windows 平台下实现。
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
