parent()

xtd::io::directory_info xtd::io::directory_info::parent

(

)

const

Gets the parent directory of a specified subdirectory.

Returns

The parent directory, or null if the path is null or if the file path denotes a root (such as \, C:\, or \server\share).

Exceptions

xtd::security::security_exception

The caller does not have the required permission.

Examples

The following example refers to the parent directory of a specified directory.

#include <xtd/xtd>
 
using namespace xtd;
using namespace xtd::io;
 
class program {
public:
  static auto main() {
    // Make a reference to a directory.
    directory_info di("TempDir");
 
    // Create the directory only if it does not already exist.
    if (di.exists() == false)
      di.create();
 
    // Create a subdirectory in the directory just created.
    directory_info dis = di.create_subdirectory("SubDir");
 
    // Get a reference to the parent directory of the subdirectory you just made.
    directory_info parent_dir = dis.parent();
    console::write_line("The parent directory of '{0}' is '{1}'", dis.name(), parent_dir.name());
 
    // Delete the parent directory.
    di.remove(true);
  }
};
startup_(program::main);

Remarks

To ensure consistent behavior across versions and to make your intent explicit, retrieve the value of one of the following properties on the xtd::io::directory_info instance returned by xtd::io::directory_info::parent.

• xtd::io::directory_info::name, which returns the simple name of the directory (such as bin).
• xtd::io::directory_info::full_name, which returns the absolute path of the directory.

For a list of common I/O tasks, see Common I/O Tasks.