get_directories() [2/2]

std::vector< xtd::io::directory_info > xtd::io::directory_info::get_directories

(

const xtd::string &

search_pattern

)

const

Returns an array of directories in the current DirectoryInfo matching the given search criteria.

Parameters

search_pattern

The search string to match against the names of directories. This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

Returns

An array of type xtd::io::directory_info matching search_pattern.

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

TThe following example counts the directories in a path that contain the specified letter.

#include <xtd/xtd>
 
using namespace xtd;
using namespace xtd::collections::generic;
using namespace xtd::io;
 
class program {
public:
  static auto main() {
    try {
      directory_info di(R"(c:\)");
 
      // Get only subdirectories that contain the letter "p."
      list<directory_info> dirs = di.get_directories("*p*");
      console::write_line("The number of directories containing the letter p is {0}.", dirs.size());
 
      for (directory_info di_next : dirs) {
        console::write_line("The number of files in {0} is {1}", di_next, di_next.get_files().size());
      }
    } catch (const exception& e) {
      console::write_line("The process failed: {0}", e.to_string());
    }
  }
};
 
startup_(program::main);

Remarks

search_pattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. The following wildcard specifiers are permitted in search_pattern.

Wildcard specifier	Matches
* (asterisk)	Zero or more characters in that position.
? (question mark)	Zero or one character in that position.

Characters other than the wildcard are literal characters. For example, the string "*t" searches for all names in ending with the letter "t". ". The search_pattern string "s*" searches for all names in path beginning with the letter "s".

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