path_search.h

// ---------------------------------------------------------------------
//
// Copyright (C) 2005 - 2017 by the deal.II authors
//
// This file is part of the deal.II library.
//
// The deal.II library is free software; you can use it, redistribute
// it, and/or modify it under the terms of the GNU Lesser General
// Public License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// The full text of the license can be found in the file LICENSE at
// the top level of the deal.II distribution.
//
// ---------------------------------------------------------------------

#ifndef dealii_path_search_h
#define dealii_path_search_h


#include <deal.II/base/config.h>
#include <deal.II/base/exceptions.h>

#include <string>
#include <fstream>
#include <map>
#include <vector>
#include <memory>


DEAL_II_NAMESPACE_OPEN

class PathSearch
{
public:
  enum Position
  {
    back,
    front,
    after_none
  };

  PathSearch (const std::string &cls,
              const unsigned int debug=0);

  std::string find (const std::string &filename,
                    const char *open_mode = "r");

  std::string find (const std::string &filename,
                    const std::string &suffix,
                    const char *open_mode = "r");

  template <class StreamType>
  void show(StreamType &stream) const;

  static void add_class (const std::string &cls);

  void add_path (const std::string &path, Position pos = back);

  void add_suffix (const std::string &suffix, Position pos = back);

  DeclException1(ExcNoClass,
                 std::string,
                 << "The class "
                 << arg1
                 << " must be registered before referring it in PathSearch.");
  DeclException2(ExcFileNotFound,
                 std::string, std::string,
                 << "The file \"" << arg1 << "\" was not found in the path for "
                 << "files of class " << arg2 << ".");

private:
  typedef std::map<std::string, std::vector<std::string> >::value_type map_type;

  static void initialize_classes();

  static std::vector<std::string> &get_path_list(const std::string &cls);

  static std::vector<std::string> &get_suffix_list(const std::string &cls);

  const std::string cls;

  static std::map<std::string, std::vector<std::string> > path_lists;

  static std::map<std::string, std::vector<std::string> > suffix_lists;

  std::vector<std::string> &my_path_list;

  std::vector<std::string> &my_suffix_list;

  const unsigned int debug;

  static std::string empty;
};


/* ----------------------------- inline functions ------------------------- */


template <class StreamType>
inline
void
PathSearch::show(StreamType &out) const
{
  out << "DEAL_II_" << cls << "PATH=\"";
  bool first = true;
  for (std::vector<std::string>::iterator p = my_path_list.begin();
       p != my_path_list.end(); ++p)
    {
      if (!first)
        out << ':';
      out << *p;
      first = false;
    }
  out << '"' << std::endl << " Suffixes";
  for (std::vector<std::string>::iterator s = my_suffix_list.begin();
       s != my_suffix_list.end(); ++s)
    out << " \"" << *s << '"';
  out << std::endl;
}

DEAL_II_NAMESPACE_CLOSE

#endif