Inheritance diagram for xtd::io::file_not_found_exception:

Definition

The exception that is thrown when an attempt to access a file that does not exist on disk fails.

ƒ

class file_not_found_exception : public xtd::io::io_exception

xtd::io::file_not_found_exception

The exception that is thrown when an attempt to access a file that does not exist on disk fails.

Definition file_not_found_exception.hpp:30

xtd::io::io_exception

The exception that is thrown when an I/O error occurs.

Definition io_exception.hpp:29

Inheritance: xtd::io::io_exception → xtd::io::file_not_found_exception

Header: #include <xtd/io/file_not_found_exception>

Namespace: xtd::io

Library: xtd.core

Examples: The following example demonstrates how to throw and catch an file_not_found_exception.

Examples: generic_ienumerable.cpp.

Public Constructors
	file_not_found_exception (const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::optional< xtd::string > &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

template<typename exception_t >
	file_not_found_exception (const xtd::optional< xtd::string > &message, const exception_t &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::optional< xtd::string > &message, const xtd::optional< xtd::string > &file_name, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

template<typename exception_t >
	file_not_found_exception (const xtd::optional< xtd::string > &message, const xtd::optional< xtd::string > &file_name, const exception_t &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::string &message, const std::error_code &error, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::string &message, const std::error_code &error, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const std::exception &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::string &message, const std::exception &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::string &message, const std::exception &inner_exception, const std::error_code &error, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::string &message, const std::exception &inner_exception, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

	file_not_found_exception (const xtd::string &message, const std::exception &inner_exception, const std::error_code &error, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::file_not_found_exception.

Public Properties
virtual const xtd::optional< xtd::string > &	file_name () const noexcept
	Gets the name of the file that cannot be found.

const xtd::string &	message () const noexcept override
	Gets message associate to the exception.

Additional Inherited Members
Public Types inherited from xtd::exception
using	exception_ref = xtd::optional< std::reference_wrapper< const xtd::exception > >
	Optional reference wrapper on std::exception.

Public Member Functions inherited from xtd::io::io_exception
	io_exception (const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::optional< xtd::string > &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

template<typename exception_t >
	io_exception (const xtd::optional< xtd::string > &message, const exception_t &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::string &message, const std::error_code &error, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::string &message, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::string &message, const std::error_code &error, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const std::exception &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::string &message, const std::exception &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::string &message, const std::exception &inner_exception, const std::error_code &error, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::string &message, const std::exception &inner_exception, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

	io_exception (const xtd::string &message, const std::exception &inner_exception, const std::error_code &error, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::io::io_exception.

Public Member Functions inherited from xtd::system_exception
	system_exception (const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::optional< xtd::string > &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

template<typename exception_t >
	system_exception (const xtd::optional< xtd::string > &message, const exception_t &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::string &message, const std::error_code &error, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::string &message, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::string &message, const std::error_code &error, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const std::exception &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::string &message, const std::exception &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::string &message, const std::exception &inner_exception, const std::error_code &error, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::string &message, const std::exception &inner_exception, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

	system_exception (const xtd::string &message, const std::exception &inner_exception, const std::error_code &error, const xtd::string &help_link, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class xtd::system_exception.

virtual const xtd::string &	file_path () const noexcept
	Gets file path where exception occurred.

virtual xtd::size	line_number () const noexcept
	Gets Line number where the exception occurred.

virtual const xtd::string &	member_name () const noexcept
	Gets file member where exception occurred.

virtual const xtd::string &	name () const noexcept
	Gets full class name the exception.

Public Member Functions inherited from xtd::exception
	exception (const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class exception.

	exception (const xtd::optional< xtd::string > &message, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class exception.

template<typename exception_t >
	exception (const xtd::optional< xtd::string > &message, const exception_t &inner_exception, const xtd::diagnostics::stack_frame &stack_frame=xtd::diagnostics::stack_frame::current())
	Create a new instance of class exception.

virtual const xtd::string &	help_link () const noexcept
	Gets a link to the help file associated with this exception.

virtual void	help_link (const xtd::string &value) noexcept
	Sets a link to the help file associated with this exception.

virtual int32	h_result () const noexcept
	Gets HRESULT, a coded numerical value that is assigned to a specific exception.

virtual void	h_result (int32 value) noexcept
	Sets HRESULT, a coded numerical value that is assigned to a specific exception.

virtual const std::error_code &	error_code () const noexcept
	Gets error associate to the exception.

virtual void	error_code (const std::error_code &value) noexcept
	Sets error associate to the exception.

virtual exception_ref	inner_exception () const noexcept
	Gets the exception instance that caused the current exception.

virtual const xtd::string &	source () const noexcept
	Gets the name of the application or the object that causes the error.

virtual void	source (const xtd::string &value) noexcept
	Sets the name of the application or the object that causes the error.

virtual xtd::string	stack_trace () const noexcept
	Gets a string representation of the immediate frames on the call stack.

virtual const xtd::diagnostics::stack_frame &	get_last_stack_frame () const noexcept
	Gets the last stack frame where the exception occurred.

xtd::string	to_string () const noexcept override
	Returns a string that represents the current exception.

const char *	what () const noexcept override
	Gets message associate to the exception.

Public Member Functions inherited from xtd::object
	object ()=default
	Create a new instance of the ultimate base class object.

virtual bool	equals (const object &obj) const noexcept
	Determines whether the specified object is equal to the current object.

virtual size_t	get_hash_code () const noexcept
	Serves as a hash function for a particular type.

virtual type_object	get_type () const noexcept
	Gets the type of the current instance.

template<typename object_t >
xtd::uptr< object_t >	memberwise_clone () const
	Creates a shallow copy of the current object.

Static Public Member Functions inherited from xtd::exception
static bool	enable_stack_trace () noexcept
	Gets if the generation of the stack trace is enabled.

static void	enable_stack_trace (bool enable) noexcept
	Sets if the generation of the stack trace is enabled. @paran enable triue if stack trace enabled; otherwhise false.

Static Public Member Functions inherited from xtd::object
template<typename object_a_t , typename object_b_t >
static bool	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are considered equal.

template<typename object_a_t , typename object_b_t >
static bool	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept
	Determines whether the specified object instances are the same instance.

Constructor & Destructor Documentation

◆ file_not_found_exception() [1/12]

xtd::io::file_not_found_exception::file_not_found_exception ( const xtd::diagnostics::stack_frame & stack_frame = xtd::diagnostics::stack_frame::current() )

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

stack_frame (optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

Remarks: Message is set with the default message associate to the exception.

◆ file_not_found_exception() [2/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::optional< xtd::string > &	message,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

◆ file_not_found_exception() [3/12]

template<typename exception_t >

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::optional< xtd::string > &	message,
		const exception_t &	inner_exception,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

inline

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

◆ file_not_found_exception() [4/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::optional< xtd::string > &	message,
		const xtd::optional< xtd::string > &	file_name,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
file_name	The full name of the file that cannot be found.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

◆ file_not_found_exception() [5/12]

template<typename exception_t >

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::optional< xtd::string > &	message,
		const xtd::optional< xtd::string > &	file_name,
		const exception_t &	inner_exception,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

inline

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
file_name	The full name of the file that cannot be found.
inner_exception	The exception that is the cause of the current exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

◆ file_not_found_exception() [6/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::string &	message,
		const std::error_code &	error,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
error	Error code associate to the exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

Deprecated:: Use xtd::io::directory_not_found_exception (const xtd::string& message, const xtd::diagnostics::stack_frame& stack_frame) and manually set the property xtd::exception::error_code - Will be removed in version 0.4.0.

◆ file_not_found_exception() [7/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::string &	message,
		const std::error_code &	error,
		const xtd::string &	help_link,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
error	Error code associate to the exception.
help_link	Help link string associate to the exception.

Deprecated:: Use xtd::io::directory_not_found_exception (const xtd::string& message, const xtd::diagnostics::stack_frame& stack_frame) and manually set the properties xtd::exception::error_code and xtd::exception::help_link - Will be removed in version 0.4.0.

◆ file_not_found_exception() [8/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const std::exception &	inner_exception,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

inner_exception	The exception that is the cause of the current exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

Remarks: Message is set with the default message associate to the exception.

Deprecated:: Use xtd::io::directory_not_found_exception (const xtd::string& message, const exception_t& inner_exception, const xtd::diagnostics::stack_frame& stack_frame) - Will be removed in version 0.4.0.

◆ file_not_found_exception() [9/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::string &	message,
		const std::exception &	inner_exception,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

Deprecated:: Use xtd::io::directory_not_found_exception (const xtd::string& message, const exception_t& inner_exception, const xtd::diagnostics::stack_frame& stack_frame) - Will be removed in version 0.4.0.

◆ file_not_found_exception() [10/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::string &	message,
		const std::exception &	inner_exception,
		const std::error_code &	error,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
error	Error code associate to the exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

Deprecated:: Use xtd::io::directory_not_found_exception (const xtd::string& message, const exception_t& inner_exception, const xtd::diagnostics::stack_frame& stack_frame) and manually set the property xtd::exception::error_code - Will be removed in version 0.4.0.

◆ file_not_found_exception() [11/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::string &	message,
		const std::exception &	inner_exception,
		const xtd::string &	help_link,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
help_link	Help link string associate to the exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

Deprecated:: Use xtd::io::directory_not_found_exception (const xtd::string& message, const exception_t& inner_exception, const xtd::diagnostics::stack_frame& stack_frame) and manually set the property xtd::exception::help_link - Will be removed in version 0.4.0.

◆ file_not_found_exception() [12/12]

xtd::io::file_not_found_exception::file_not_found_exception	(	const xtd::string &	message,
		const std::exception &	inner_exception,
		const std::error_code &	error,
		const xtd::string &	help_link,
		const xtd::diagnostics::stack_frame &	stack_frame = `xtd::diagnostics::stack_frame::current()`
	)

explicit

Create a new instance of class xtd::io::file_not_found_exception.

Parameters

message	Message string associate to the exception.
inner_exception	The exception that is the cause of the current exception.
error	Error code associate to the exception.
help_link	Help link string associate to the exception.
stack_frame	(optional) Contains current stack frame about member name, file path and line number in the file where the exception is occurred. Typically xtd::diagnostics::stack_frame::current().

Deprecated:: Use xtd::io::directory_not_found_exception (const xtd::string& message, const exception_t& inner_exception, const xtd::diagnostics::stack_frame& stack_frame) and manually set the properties xtd::exception::error_code and xtd::exception::help_link - Will be removed in version 0.4.0.

Member Function Documentation

◆ file_name()

virtual const xtd::optional< xtd::string > & xtd::io::file_not_found_exception::file_name ( ) const

virtualnoexcept

Gets the name of the file that cannot be found.

Returns: The name of the file, or empty if no file name was passed to the constructor for this instance. @remrks This property is read-only.

◆ message()

const xtd::string & xtd::io::file_not_found_exception::message ( ) const

overridevirtualnoexcept

Gets message associate to the exception.

Returns: A string represent a massage associate to the exception

Reimplemented from xtd::exception.

The documentation for this class was generated from the following file:

xtd.core/include/xtd/io/file_not_found_exception.hpp

Definition

Public Constructors

Public Properties

Additional Inherited Members

Constructor & Destructor Documentation

◆ file_not_found_exception() [1/12]

◆ file_not_found_exception() [2/12]

◆ file_not_found_exception() [3/12]

◆ file_not_found_exception() [4/12]

◆ file_not_found_exception() [5/12]

◆ file_not_found_exception() [6/12]

◆ file_not_found_exception() [7/12]

◆ file_not_found_exception() [8/12]

◆ file_not_found_exception() [9/12]

◆ file_not_found_exception() [10/12]

◆ file_not_found_exception() [11/12]

◆ file_not_found_exception() [12/12]

Member Function Documentation

◆ file_name()

◆ message()