pathname.h

这个是symbian下的一个蛮庞大的3D游戏源代码！对于学习3D开发的人有很大的帮助！

#ifndef _IO_PATHNAME_H
#define _IO_PATHNAME_H


namespace lang {
	class String;}


namespace io
{


/**
 * Class for manipulating path names.
 * The class overcomes problems caused by different path name separator characters and tricky manual iteration of name components.
 * Path name consists of optional drive letter and ':',
 * directories separated with '/' or '\' and
 * file name which consists of basename followed by '.' and suffix.
 *
 * PathName class is convenient for path name manipulation as name suggests.
 * For example if you have a directory name and you want to concatenate
 * a file name to it, you can write PathName(dirname,fname) without
 * need to check does the directory name already end with slash or backslash.
 * You can also retrieve directory name from file name by calling parent()
 * method, for example in a situation where you want to load textures
 * from the same directory as the filename.
 *
 * @ingroup io
 */
class PathName
{
public:
	enum 
	{
		/** Maximum number of characters in a path name. */
		MAXLEN=250
	};

	/**
	 * Empty path.
	 */
	PathName();

	/** 
	 * Copy by value.
	 */
	PathName( const PathName& other );

	/**
	 * Path name from string.
	 * @exception IOException If path name too long.
	 */
	PathName( const char* pathname );

	/**
	 * Path name from string.
	 * @exception IOException If path name too long.
	 */
	PathName( const lang::String& pathname );

	/**
	 * Combines two path names.
	 * Note that path name with drive letter cannot be combined
	 * with any path.
	 * @exception IOException If path name too long.
	 */
	PathName( const char* first, const char* second );

	/**
	 * Combines two path names.
	 * Note that path name with drive letter cannot be combined
	 * with any path.
	 * @exception IOException If path name too long.
	 */
	PathName( const lang::String& first, const lang::String& second );

	/** 
	 * Copy by value.
	 */
	PathName& operator=( const PathName& other );

	/**
	 * Returns drive letter of the path name.
	 * Returns empty string if the component is not in path name.
	 */
	const char*		drive() const			{return m_drv;}

	/**
	 * Returns basename of the path name.
	 * Returns empty string if the component is not in path name.
	 * Basename is the name before suffix and after last directory separator.
	 */
	const char*		basename() const		{return m_basename;}

	/**
	 * Returns suffix of the path name including preceding dot.
	 * Returns empty string if the component is not in path name.
	 */
	const char*		suffix() const			{return m_suffix;}

	/**
	 * Returns basename with suffix.
	 */
	lang::String	filename() const;

	/**
	 * Returns parent path.
	 * Parent path is path before last directory separator.
	 */
	PathName		parent() const;

	/**
	 * Returns path name as 0-terminated string.
	 */
	const char*		toString() const		{return m_path;}

private:
	char*	m_path;
	char*	m_drv;
	char*	m_dir;
	char*	m_basename;
	char*	m_suffix;
	int		m_alloc;
	char	m_buf[MAXLEN*2];

	char*	allocate( int chars );
	void	parse( const char* path, const char* second );
};


} // io


#endif // _IO_PATHNAME_H

// Copyright (C) 2004-2006 Pixelgene Ltd. All rights reserved. Consult your license regarding permissions and restrictions.