get_files() [1/2]

std::vector< xtd::io::file_info > xtd::io::directory_info::get_files

(

)

const

Returns a file list from the current directory.

Returns

An array of type xtd::io::file_info.

Exceptions

xtd::io::directory_not_found_exception	The specified path is invalid, such as being on an unmapped drive.
xtd::security::security_exception	The caller does not have code access permission to create the directory.

Examples

The following example shows how to get a list of files from a directory by using different search options. The example assumes a directory that has files named log1.txt, log2.txt, test1.txt, test2.txt, test3.tx

#include <xtd/xtd>
 
using namespace xtd;
using namespace xtd::io;
 
class program {
public:
  static auto main() {
    directory_info di(R"(C:\ExampleDir)");
    console::write_line("No search pattern returns:");
    for (auto fi : di.get_files()) {
      console::write_line(fi.name());
    }
 
    console::write_line();
 
    console::write_line("Search pattern *2* returns:");
    for (auto fi : di.get_files("*2*")) {
      console::write_line(fi.name());
    }
 
    console::write_line();
 
    console::write_line("Search pattern test?.txt returns:");
    for (auto fi : di.get_files("test?.txt")) {
      console::write_line(fi.name());
    }
  }
};
 
startup_(program::main);
 
/*
 This code produces output similar to the following:
 
 No search pattern returns:
 log1.txt
 log2.txt
 test1.txt
 test2.txt
 test3.txt
 
 Search pattern *2* returns:
 log2.txt
 test2.txt
 
 Search pattern test?.txt returns:
 test1.txt
 test2.txt
 test3.txt
 *&zwj;/

Remarks

The xtd::io::directory_info::enumerate_files and xtd::io::directory_info::get_files methods differ as follows:

• When you use xtd::io::directory_info::enumerate_files, you can start enumerating the collection of xtd::io::directory_info objects before the whole collection is returned.
• When you use xtd::io::directory_info::get_files, you must wait for the whole array of xtd::io::directory_info objects to be returned before you can access the array.

Therefore, when you are working with many files and directories, xtd::io::directory_info::enumerate_files can be more efficient.

This method pre-populates the values of the following xtd::io::directory_info properties:

• xtd::io::file_system_info::attributes
• xtd::io::file_system_info::creation_time
• xtd::io::file_system_info::last_access_time
• xtd::io::file_system_info::last_write_time
• xtd::io::file_system_info::size