cet::search_path Class Reference

#include <search_path.h>

Public Member Functions
	search_path (std::string const &env_name_or_path)
	search_path (std::string const &env_name, std::nothrow_t)
	search_path (std::string const &path, cet::path_tag_t)
std::string const &	showenv () const
bool	empty () const
std::size_t	size () const
std::string const &	operator[] (std::size_t k) const
std::string	find_file (std::string const &filename) const
bool	find_file (std::string const &filename, std::string &result) const
std::size_t	find_files (std::string const &filename_pattern, std::vector< std::string > &result) const
template<class OutIter >
std::size_t	find_files (std::string const &filename_pattern, OutIter dest) const
std::string	to_string () const

Private Attributes
std::string	env_
std::vector< std::string >	dirs_ {}

Detailed Description

Definition at line 36 of file search_path.h.

Constructor & Destructor Documentation

search_path::search_path ( std::string const &  env_name_or_path )

explicit

Definition at line 62 of file search_path.cc.

  : env_{get_env_if_colon_present(env_name_or_path)}
  , dirs_{get_dirs(env_, env_name_or_path)}
{}

search_path::search_path	(	std::string const &	env_name,
		std::nothrow_t
	)

Definition at line 67 of file search_path.cc.

  : env_{env_name}, dirs_{get_dirs(env_, std::nothrow)}
{}

search_path::search_path	(	std::string const &	path,
		cet::path_tag_t
	)

Definition at line 71 of file search_path.cc.

  : env_{}, dirs_{get_dirs(path)}
{}

Member Function Documentation

bool search_path::empty

(

)

const

Definition at line 76 of file search_path.cc.

{
  return dirs_.empty();
}

string search_path::find_file

(

std::string const &

filename

)

const

Definition at line 96 of file search_path.cc.

{
  string result;
  if (find_file(filename, result))
    return result;
  throw cet::exception(exception_category)
    << "Can't find file \"" << filename << '"';
}

bool search_path::find_file	(	std::string const &	filename,
		std::string &	result
	)		const

Definition at line 106 of file search_path.cc.

{
  if (filename.empty())
    return false;

  for (auto const& dir : dirs_) {
    string fullpath = dir + '/' + filename;
    for (size_t k; (k = fullpath.find("//")) != string::npos;) {
      fullpath.erase(k, 1);
    }
    if (cet::file_exists(fullpath)) {
      result = fullpath;
      return true;
    }
  }
  return false;
}

size_t search_path::find_files	(	std::string const &	filename_pattern,
		std::vector< std::string > &	result
	)		const

Definition at line 126 of file search_path.cc.

{
  regex const re{pat};
  size_t count{};
  for (auto const& dir : dirs_) {
    unique_ptr<DIR, function<int(DIR*)>> dd(opendir(dir.c_str()), closedir);
    if (dd.get() == nullptr) {
      // The opendir() failed, we do not care why, skip it.
      continue;
    }
    while (1) {
      // Note: errno is a thread-local!
      errno = 0;
      // Note: This is thread-safe so long as each thread
      // has their own dd, which is the case here.
      auto entry = readdir(dd.get());
      if (errno != 0) {
        throw cet::exception(exception_category)
          << "Failed to read directory \"" << dir
          << "\"; error num = " << errno;
      }
      if (entry == nullptr) {
        // We have reached the end of this directory stream.
        break;
      }
      if (regex_match(entry->d_name, re)) {
        out.push_back(dir + '/' + entry->d_name);
        ++count;
      }
    }
  }
  return count;
}

template<class OutIter >

std::size_t cet::search_path::find_files	(	std::string const &	filename_pattern,
		OutIter	dest
	)		const

Definition at line 102 of file search_path.h.

{
  std::vector<std::string> results;
  size_t const nfound{find_files(pattern, results)};
  cet::copy_all(results, dest);
  return nfound;
}

string const & search_path::operator[]

(

std::size_t

k

)

const

Definition at line 87 of file search_path.cc.

{
  return dirs_.at(k);
}

std::string const& cet::search_path::showenv ( ) const

inline

Definition at line 50 of file search_path.h.

  {
    return env_;
  }

size_t search_path::size

(

)

const

Definition at line 82 of file search_path.cc.

{
  return dirs_.size();
}

std::string search_path::to_string

(

)

const

Definition at line 161 of file search_path.cc.

{
  std::ostringstream oss;
  oss << *this;
  return oss.str();
}

Member Data Documentation

std::vector<std::string> cet::search_path::dirs_ {}

private

Definition at line 97 of file search_path.h.

std::string cet::search_path::env_

private

Definition at line 96 of file search_path.h.

---

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

• cetlib/cetlib/search_path.h
• cetlib/cetlib/search_path.cc