---

utils.h

//FILE:         utils.h
//AUTHOR:       Nathan Cournia <nathan@cournia.com>

#ifndef COURNIA_UTILS_H
#define COURNIA_UTILS_H 1

#include <iostream>
#include <string>


namespace utils 
{
        //error space for utils::functions.
        //Not thread safe, but should be easy to do so.
        //Do not access the variable outside of the utils:: namespace.
        //Use utils::get_error( void ) to get the error message.
        extern std::string error;

        //used internally by utils:: functions to clear the error message
        inline void clear_error( void )
        {
                error = "none";
        }

        //used internally by utils:: functions to set error
        inline void set_error( const std::string& msg )
        {
                error = msg;
        }

        inline const std::string& get_error( void )
        {
                return error;
        }
        

        std::string add_slash( const std::string& filename );


        void to_upper( std::string& str );

        std::string to_upper( const std::string& str );


        bool stricmp( const std::string& a, const std::string& b );


        bool check_extension( const std::string& file, const std::string& ext );

        std::string trim( const std::string& str );
        
        std::string rtrim( const std::string& str );


        template <class T>
        std::istream&
        read( std::istream& stream, T& in )
        {
                char buffer[ sizeof( T ) ];
                stream.read( (char*)buffer, sizeof( T ) );
                in = *((T*)(&buffer[0]));
                return stream;
        }


        template <class T>
        std::ostream&
        write( std::ostream& stream, const T& out )
        {
                return stream.write( (char*)(&out), sizeof( T ) );
        }

        //system dependent functions
        //the following methods should be defined in in a seperate .cpp
        //for each system.  for example: posix.cpp, windows.cpp, mac.cpp, etc.
        

        bool mkdir( const std::string& filename );
        

        bool exists( const std::string& filename );
        

        bool can_read( const std::string& filename );


        bool is_dir( const std::string& filename );


        bool is_link( const std::string& filename );


        bool chdir( const std::string& filename );


        std::string get_valid_absolute_dir( const std::string& filename );


        std::string get_absolute_dir( const std::string& filename );


        std::string get_filename( const std::string& filename );
        
}

#endif

---