// -*- C++ -*-
/**
 * \file Path.h
 * This file is part of LyX, the document processor.
 * Licence details can be found in the file COPYING.
 *
 * \author Lars Gullik Bjønnes
 *
 * Full author contact details are available in file CREDITS.
 */

#ifndef PATH_H
#define PATH_H

#include "support/FileName.h"


namespace lyx {
namespace support {

/**
 * Path - utility closs for stackable working directories
 *
 * You can use a local variable of this type to temporarily
 * change to a directory as the cwd, for example :
 *
 * if (blah) {
 *	FileName pp("/tmp/blah");
 *	PathChanger p(pp);
 *	...
 * }
 *
 * At the end of p's scope the cwd is reset to its previous value.
 */
class PathChanger {
public:
	/// change to the given directory
	explicit PathChanger(FileName const & path);

	/// set cwd to the previous value if needed
	~PathChanger();

	/// set cwd to the previous value if needed
	int pop();
private:
	/// noncopyable
	PathChanger(PathChanger const &);
	void operator=(PathChanger const &);

	/// whether we are in the new cwd or not
	bool popped_;
	/// the previous cwd
	FileName pushedDir_;
};

// To avoid the wrong usage:
// PathChanger("/tmp");   // wrong
// PathChanger p("/tmp");  // right
// we add this macro:
#define PathChanger(x) unnamed_PathChanger;
// Tip gotten from Bobby Schmidt's column in C/C++ Users Journal

} // namespace support
} // namespace lyx

#endif // PATH_H