oasisscriptrubyinterpreter.h

使用stl技术,(还没看,是听说的)

/******************************************************************************
 * This source file is part of Bad Camel Gaming
 * Copyright (C) 2003  Zephie Greyvenstein
 * See Readme.html for acknowledgements
 *
 * This library is free software; you can 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.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *****************************************************************************/

/******************************************************************************
 * FILENAME    : oasisInterpreter.h
 * DESCRIPTION : The Specifics of Ruby Scripting
 * AUTHOR      : Godot
 *****************************************************************************/

/// Avoid double inclusion
#ifndef __SCRIPT_RUBY_RESOURCE_H__
#define __SCRIPT_RUBY_RESOURCE_H__

/// Include the rest of the needed oasis stuff
#include "oasisScriptInterpreter.h"
#include "oasisScriptCommon.h"

namespace Oasis {
  /// The Specifics of Ruby Scripting
  /** @remarks
        Ruby is a very nice language with yummi-ness all around.
        But don't trust me, see for your self @ www.ruby-lang.org/en/
        **/
  class _oasisExport scriptRubyInterpreter : public scriptInterpreter {
  public:
    scriptRubyInterpreter();
    virtual ~scriptRubyInterpreter();
    /// This should open up a script file/execute it for you.
    bool executeScript(string &name);
    /// This is a blunt "Execute the given string" function.
    /// type will be type(retv), while retv will be the converted 
    /// type from script's execution.
    void *executeString(string &command, uint8 &type);
    /// Most likened to killing the interpreter and reloading it.
    void reset();
    /// This is used when Scripted calling a function from C with multiple arguments.
    void *convertFromC(void *cObject, uint8 type);
    /// This is used (for one) to convert return values from functions to C
    /// data types.
    void *convertToC(void *scriptObject, uint8 &type);
    void *callFunction( string &name, string &types, 
                        void ** arguments, uint8 &returntype );
    ///Ruby Garbage collection.
    void freeVariable( void *script_value );
  private:
    ///A helper function to actually call the script.
    
    VALUE executeFunction( VALUE recv, int ID, int argc, VALUE *argv );
    
    void printError( );
  };
};
#endif