home | help
std::filesy...d_link_count(3)  C++ Standard Libary std::filesy...d_link_count(3)

NAME
     std::filesystem::directory_entry::hard_link_count - std::filesystem::direc-
     tory_entry::hard_link_count

Synopsis
	std::uintmax_t	hard_link_count()  const;			     (1)
     (since C++17)
	std::uintmax_t hard_link_count( std::error_code& ec )  const	     (2)
     (since C++17)
	noexcept;

	If  the  number of hard links is cached in this directory_entry, returns
     the cached
	value. Otherwise, returns:

	1) std::filesystem::hard_link_count(path()),
	2) std::filesystem::hard_link_count(path(), ec).

Parameters
	ec - out-parameter for error reporting in the non-throwing overload

Return value
	The number of hard links for the referred-to filesystem object.

Exceptions
	Any overload not marked noexcept may throw std::bad_alloc if memory  al-
     location
	fails.

	1) Throws std::filesystem::filesystem_error on underlying OS API errors,
     constructed
	with  p  as  the  first path argument and the OS error code as the error
     code argument.
	2) Sets a std::error_code& parameter to the OS API error code if  an  OS
     API call
	fails, and executes ec.clear() if no errors occur.

Example
	 This section is incomplete
	 Reason: no example

See also
	hard_link_count  returns  the number of hard links referring to the spe-
     cific file
	(C++17) 	(function)

Category:
	  * Todo no example

http://cppreference.com 	   2024.06.10	   std::filesy...d_link_count(3)

home | help