LSEARCH - Linux手册页

时间:2019-08-20 18:00:50  来源:igfitidea点击:

Linux程序员手册 第3部分
更新日期: 2017-09-15

名称

lfind,lsearch-数组的线性搜索

语法

#include <search.h>

void *lfind(const void *key, const void *base, size_t *nmemb,
         size_t size, int(*compar)(const void *, const void *));

void *lsearch(const void *key, void *base, size_t *nmemb,
         size_t size, int(*compar)(const void *, const void *));

说明

lfind()和lsearch()对数组基础中的键执行线性搜索,该数组中的每个元素都有* nmemb个大小为字节的元素。预计compar引用的比较函数将具有两个参数,该参数按此顺序指向键对象和数组成员,如果键对象与数组成员匹配,则返回零,否则返回非零。

如果lsearch()找不到匹配的元素,则将密钥对象插入表的末尾,并将* nmemb递增。特别是,应该知道存在匹配的元素,或者有更多可用空间。

返回值

lfind()返回指向数组匹配成员的指针;如果未找到匹配项,则返回NULL。 lsearch()返回一个指向数组匹配成员的指针,或者如果找不到匹配项,则指向新添加的成员的指针。

属性

有关本节中使用的术语的说明,请参见attribute(7)。

InterfaceAttributeValue
lfind(),lsearch()Thread safetyMT-Safe

遵循规范

POSIX.1-2001,POSIX.1-2008,SVr4、4.3BSD。自libc-4.6.27起在libc中存在。

BUGS

命名很不幸。

另外参见

bsearch(3),hsearch(3),tsearch(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本,请访问https://www.kernel.org/doc/man-pages/