//
// Copyright(c) BreezeWay Software Corporation.  
// All rights reserved.
// 
//                    Simple.hpp
//
//  This sample is intended to guide you though many RapidXLL(tm) features.
//  
//       Simple.hpp contains examples of :  
//              RAPID_EXPORT, RXLL, Help, Hide, Default, PadSize, PadWith 
//
//       Simple_B.hpp contains examples of :
//              Category, CallPrefix, 
//              Exporting a class, RapidIDCtor, Rapid 
//              Volatile, Hidden Functions
//
//       Simple_C.hpp contains examples of :
//              RXLL_OpenMsgBox   = Openning Msg Box
//              RXLL_CloseMsgBox  = Closing Msg Box
//              RXLL_FileCategory = Default function category 
//              RXLL_FilePrefix   = Default function prefix 
//              RXLL_InitFunc     = XLL Init Function (called after openning)
//              RXLL_FinishFunc   = XLL Finish Function (called before closing)
//
//  FEATURE                        MEANING
//  ------------------------       -------------------------------------------
//
//  RXLL_EXPORT                    This is all that is needed!   
//                                 Export this function to Excel.  
//
//  RXLL                           Start RapidXLL customization parameters
//                                 Implies export to Excel.
//                                 Customizations are case in-sensitive.
//                                 R((apid)|(XLL)|(apidXLL)) would also work.
//
//  Help = function help           Function information displayed on Wizard.
//
//  Help var = info for variable   Variable information displayed on Wizard.
//                                 This is also read from function prototype.
//
//  Default: var = value           Assigns a default value to a variable.
//                                 This is also read from function prototype.
//
//  Hide var1[,var2...]            Hide these variables from Excel.
//                                 (These should be defaulted.)
//
//  PadSize = Rows x Cols          When returning ranges, pad result range.
//                                 Inhibits Excel's #N/A or duplicates.
//                                 Supplies user with run-time customization.
// 
//  PadWith  (Zeros|Blanks)        When returning ranges, padding value
//
//----------------------------------------------------------------------------

#include <RapidXLL.hpp>      // API  ( REQUIRED )
using namespace RapidXLL;    // Makes coding simpler 

namespace SimpleNS
{

  //----------------------------------------------------------------
  RAPID_EXPORT
  string       VersionInfo();


  //----------------------------------------------------------------
  //+ RapidXLL This function returns a range with numbers doubled.
  RAPID_EXPORT
  RapidRange   Double(const RapidRange& vals);


  //----------------------------------------------------------------
  /*  RXLL
   *  Help = This function reverses a string.
   *  Help str = [Help variableName]  string to reverse.
   */
  RAPID_EXPORT
  string   ReverseString(const string& str);


  //----------------------------------------------------------------
  //+ RXLL : This function defines F(a,b,c,d,e) = (a * b) + (c * d) + e. 
  //+ Help : [ a,b,d,e have default values. ]
  //+ Help : [ b,e are completely hidden [Hide] from users. ]
  //+ Help : [ e's default value comes from the prototype itself ]
  //+ Help : [ d's default value is overridden ]

  //+ Hide b, e

  //+ Default: b = 3.2, d=22
  //+ Default: a = 2.0
  RAPID_EXPORT
  double   Polynomial(const double a, 
		      const double b, 
		      const double c, 
		      const double d = 2.0, 
		      const double e = 13.3);

  //----------------------------------------------------------------
  /* RXLL
   * Help = This function flips a range and padds result to ensure that a 
   * Help = [Padding = rows x cols] 10x10 section has no #N/As.  
   * Help flipSrc = [Help variableName]   Range of rows to be flipped.

   * PadSize = 10 x 10
   * PadWith Zeroes
   */
  RAPID_EXPORT
  RapidRange   FlipAndPad(const RapidRange& flipSrc);


} // end of NS namespace