std::filesystem::is_block_file

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

文件系统库

类
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator    filesystem::file_status filesystem::space_info	filesystem::file_type filesystem::file_time_type filesystem::perms filesystem::perm_options filesystem::copy_options filesystem::directory_options
函数
filesystem::absolute filesystem::canonicalfilesystem::weakly_canonical filesystem::relativefilesystem::proximate filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path filesystem::temp_directory_path	filesystem::exists filesystem::equivalent filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status
文件类型
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

在标头 <filesystem> 定义
bool is_block_file(std::filesystem::file_status s )noexcept;	(1)	(C++17 起)
bool is_block_file(conststd::filesystem::path& p );	(2)	(C++17 起)
bool is_block_file(conststd::filesystem::path& p, std::error_code& ec )noexcept;	(3)	(C++17 起)

检查给定的文件状态或路径是否对应一个块特殊文件，如同通过 POSIX S_ISBLK 确定。块特殊文件的例子是块设备，例如 Linux 上的 /dev/sda 或 /dev/loop0。

1) 等价于 s.type()== file_type::block。

2) 等价于 is_block_file(status(p)) 或 is_block_file(status(p, ec))。

参数

s	-	要检查的文件状态
p	-	要检验的路径
ec	-	不抛出重载中报告错误的输出形参

返回值

若 p 所指示的文件或 s 所指示的类型指代一个块设备，则返回 true。若错误发生则不抛出重载返回 false。

异常

若内存分配失败，则任何不标记为 noexcept 的重载可能抛出 std::bad_alloc 。

2,3) 若 OS API 调用失败，则设置 std::error_code& 为 OS API 错误码，而未发生错误时则执行 ec.clear()。

示例

运行此代码

#include <cstdio>#include <cstring>#include <filesystem>#include <fstream>#include <iostream>#include <sys/socket.h>#include <sys/stat.h>#include <sys/un.h>#include <unistd.h>   namespace fs = std::filesystem;   void demo_status(const fs::path& p, fs::file_status s){std::cout<< p;// 也可以用: switch(s.type()) { case fs::file_type::regular: ...}if(fs::is_regular_file(s))std::cout<<" 是常规文件\n";if(fs::is_directory(s))std::cout<<" 是目录\n";if(fs::is_block_file(s))std::cout<<" 是块设备\n";if(fs::is_character_file(s))std::cout<<" 是字符设备\n";if(fs::is_fifo(s))std::cout<<" 是具名 IPC 管道\n";if(fs::is_socket(s))std::cout<<" 是具名 IPC 套接字\n";if(fs::is_symlink(s))std::cout<<" 是符号链接\n";if(!fs::exists(s))std::cout<<" 不存在\n";}   int main(){// 创建不同种类的文件 fs::create_directory("sandbox"); fs::create_directory("sandbox/dir");std::ofstream("sandbox/file");// 创建常规文件 fs::create_symlink("file", "sandbox/symlink");   mkfifo("sandbox/pipe", 0644); sockaddr_un addr; addr.sun_family= AF_UNIX;std::strcpy(addr.sun_path, "sandbox/sock");int fd = socket(PF_UNIX, SOCK_STREAM, 0); bind(fd, reinterpret_cast<sockaddr*>(&addr), sizeof addr);   // 演示不同的状态访问器for(auto it{fs::directory_iterator("sandbox")}; it != fs::directory_iterator();++it) demo_status(*it, it->symlink_status());// 使用 directory_entry 缓存的状态 demo_status("/dev/null", fs::status("/dev/null"));// 直接调用 status demo_status("/dev/sda", fs::status("/dev/sda")); demo_status("sandbox/no", fs::status("/sandbox/no"));   // 清理（推荐采用基于 std::unique_ptr 的自定义删除器) close(fd); fs::remove_all("sandbox");}

可能的输出：

"sandbox/file" 是常规文件 "sandbox/dir" 是目录 "sandbox/pipe" 是具名 IPC 管道 "sandbox/sock" 是具名 IPC 套接字 "sandbox/symlink" 是符号链接 "/dev/null" 是字符设备 "/dev/sda" 是块设备 "sandbox/no" 不存在

参阅

statussymlink_status (C++17)(C++17)	确定文件属性 确定文件属性，检查符号链接目标 (函数)
file_status (C++17)	表示文件类型及权限 (类)
status_known (C++17)	检查文件状态是否已知 (函数)
is_character_file (C++17)	检查给定的路径是否表示字符设备 (函数)
is_directory (C++17)	检查给定的路径是否表示一个目录 (函数)
is_fifo (C++17)	检查给定的路径是否表示一个命名管道 (函数)
is_other (C++17)	检查参数是否表示一个其他文件 (函数)
is_regular_file (C++17)	检查参数是否表示一个常规文件 (函数)
is_socket (C++17)	检查参数是否表示一个具名 IPC 套接字 (函数)
is_symlink (C++17)	检查参数是否表示一个符号链接 (函数)
exists (C++17)	检查路径是否指代既存的文件系统对象 (函数)
is_block_file	检查 directory_entry 是否代表块设备 (std::filesystem::directory_entry 的公开成员函数)