libsidl-dev 1.4.0.dfsg-8.2 / usr / include / sidl_rmi_InstanceHandle.h

/*
 * File:          sidl_rmi_InstanceHandle.h
 * Symbol:        sidl.rmi.InstanceHandle-v0.9.17
 * Symbol Type:   interface
 * Babel Version: 1.4.0 (Revision: 6607 release-1-4-0-branch)
 * Release:       $Name:  $
 * Revision:      @(#) $Id: $
 * Description:   Client-side glue code for sidl.rmi.InstanceHandle
 * 
 * Copyright (c) 2000-2002, Lawrence Livermore National Security, LLC.
 * Produced at the Lawrence Livermore National Laboratory.
 * Written by the Components Team <components@llnl.gov>
 * All rights reserved.
 * 
 * This file is part of Babel. For more information, see
 * http://www.llnl.gov/CASC/components/. Please read the COPYRIGHT file
 * for Our Notice and the LICENSE file for the GNU Lesser General Public
 * License.
 * 
 * This program 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) version 2.1 dated February 1999.
 * 
 * This program 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 terms and
 * conditions of the GNU Lesser General Public License for more details.
 * 
 * You should have recieved a copy of the GNU Lesser General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 * 
 * WARNING: Automatically generated; changes will be lost
 * 
 */

#ifndef included_sidl_rmi_InstanceHandle_h
#define included_sidl_rmi_InstanceHandle_h

/**
 * Symbol "sidl.rmi.InstanceHandle" (version 0.9.17)
 * 
 *  
 * This interface holds the state information for handles to
 * remote objects.  Client-side messaging libraries are expected
 * to implement <code>sidl.rmi.InstanceHandle</code>,
 * <code>sidl.rmi.Invocation</code> and
 * <code>sidl.rmi.Response</code>.
 * 
 * Every stub with a connection to a remote object holds a pointer
 * to an InstanceHandle that manages the connection. Multiple
 * stubs may point to the same InstanceHandle, however.  Babel
 * takes care of the reference counting, but the developer should
 * keep concurrency issues in mind.
 * 
 * When a new remote object is created:
 * sidl_rmi_InstanceHandle c = 
 * sidl_rmi_ProtocolFactory_createInstance( url, typeName,
 * _ex );
 * 
 * When a new stub is created to connect to an existing remote
 * instance:
 * sidl_rmi_InstanceHandle c = 
 * sidl_rmi_ProtocolFactory_connectInstance( url, _ex );
 * 
 * When a method is invoked:
 * sidl_rmi_Invocation i = 
 * sidl_rmi_InstanceHandle_createInvocation( methodname );
 * sidl_rmi_Invocation_packDouble( i, "input_val" , 2.0 );
 * sidl_rmi_Invocation_packString( i, "input_str", "Hello" );
 * ...
 * sidl_rmi_Response r = sidl_rmi_Invocation_invokeMethod( i );
 * sidl_rmi_Response_unpackBool( i, "_retval", &succeeded );
 * sidl_rmi_Response_unpackFloat( i, "output_val", &f );
 */
struct sidl_rmi_InstanceHandle__object;
struct sidl_rmi_InstanceHandle__array;
typedef struct sidl_rmi_InstanceHandle__object* sidl_rmi_InstanceHandle;

/*
 * Includes for all header dependencies.
 */

#ifndef included_sidl_header_h
#include "sidl_header.h"
#endif
#ifndef included_sidl_BaseException_h
#include "sidl_BaseException.h"
#endif
#ifndef included_sidl_BaseInterface_h
#include "sidl_BaseInterface.h"
#endif
#ifndef included_sidl_ClassInfo_h
#include "sidl_ClassInfo.h"
#endif
#ifndef included_sidl_RuntimeException_h
#include "sidl_RuntimeException.h"
#endif
#ifndef included_sidl_SIDLException_h
#include "sidl_SIDLException.h"
#endif
#ifndef included_sidl_io_Serializable_h
#include "sidl_io_Serializable.h"
#endif
#ifndef included_sidl_rmi_Invocation_h
#include "sidl_rmi_Invocation.h"
#endif

#ifndef included_sidl_rmi_Call_h
#include "sidl_rmi_Call.h"
#endif
#ifndef included_sidl_rmi_Return_h
#include "sidl_rmi_Return.h"
#endif
#ifdef SIDL_C_HAS_INLINE
#ifndef included_sidl_rmi_InstanceHandle_IOR_h
#include "sidl_rmi_InstanceHandle_IOR.h"
#endif
#endif /* SIDL_C_HAS_INLINE */
#ifdef __cplusplus
extern "C" {
#endif

#if !defined(SIDL_RMI_INSTANCEHANDLE_INLINE_DECL) && defined(SIDL_C_HAS_INLINE)
#if (defined(__STDC_VERSION__) && (__STDC_VERSION__ >= 199901L)) || defined(__INTEL_COMPILER) || !defined(__GNUC__)
#define SIDL_RMI_INSTANCEHANDLE_INLINE_DECL inline
#else
#define SIDL_RMI_INSTANCEHANDLE_INLINE_DECL extern inline
#endif
#endif /* inline preprocessor definitions */
#ifdef WITH_RMI

/**
 * RMI constructor function for the class.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__createRemote(const char * url, sidl_BaseInterface 
  *_ex);

/**
 * RMI connector function for the class.(addrefs)
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__connect(const char *, sidl_BaseInterface *_ex);


#endif /*WITH_RMI*/
/**
 * Method to enable/disable interface contract enforcement.
 */
void
sidl_rmi_InstanceHandle__set_contracts(
  sidl_rmi_InstanceHandle self,
  sidl_bool   enable,
  const char* enfFilename,
  sidl_bool   resetCounters,
  struct sidl_BaseInterface__object **_ex);

/**
 * Method to dump interface contract enforcement statistics.
 */
void
sidl_rmi_InstanceHandle__dump_stats(
  sidl_rmi_InstanceHandle self,
  const char* filename,
  const char* prefix,
  struct sidl_BaseInterface__object **_ex);

/**
 *  initialize a connection (intended for use by the
 * ProtocolFactory, (see above).  This should parse the url and
 * do everything necessary to create the remote object.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_bool
sidl_rmi_InstanceHandle_initCreate(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ const char* url,
  /* in */ const char* typeName,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_bool _result;
  _result = (*self->d_epv->f_initCreate)(
    self->d_object,
    url,
    typeName,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 * initialize a connection (intended for use by the ProtocolFactory) 
 * This should parse the url and do everything necessary to connect 
 * to a remote object.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_bool
sidl_rmi_InstanceHandle_initConnect(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ const char* url,
  /* in */ const char* typeName,
  /* in */ sidl_bool ar,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_bool _result;
  _result = (*self->d_epv->f_initConnect)(
    self->d_object,
    url,
    typeName,
    ar,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 *  Get a connection specifically for the purpose for requesting a 
 * serialization of a remote object (intended for use by the
 * ProtocolFactory, (see above).  This should parse the url and
 * request the object.  It should return a deserializer..
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_io_Serializable
sidl_rmi_InstanceHandle_initUnserialize(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ const char* url,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_io_Serializable _result;
  _result = (*self->d_epv->f_initUnserialize)(
    self->d_object,
    url,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 *  return the short name of the protocol 
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
char*
sidl_rmi_InstanceHandle_getProtocol(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  char* _result;
  _result = (*self->d_epv->f_getProtocol)(
    self->d_object,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 *  return the object ID for the remote object
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
char*
sidl_rmi_InstanceHandle_getObjectID(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  char* _result;
  _result = (*self->d_epv->f_getObjectID)(
    self->d_object,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 *  
 * return the full URL for this object, takes the form: 
 * protocol://serviceID/objectID (where serviceID would = server:port 
 * on TCP/IP)
 * So usually, like this: protocol://server:port/objectID
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
char*
sidl_rmi_InstanceHandle_getObjectURL(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  char* _result;
  _result = (*self->d_epv->f_getObjectURL)(
    self->d_object,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 *  create a serializer handle to invoke the named method 
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_rmi_Invocation
sidl_rmi_InstanceHandle_createInvocation(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ const char* methodName,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_rmi_Invocation _result;
  _result = (*self->d_epv->f_createInvocation)(
    self->d_object,
    methodName,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 *  
 * closes the connection (called by the destructor, if not done
 * explicitly) returns true if successful, false otherwise
 * (including subsequent calls)
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_bool
sidl_rmi_InstanceHandle_close(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_bool _result;
  _result = (*self->d_epv->f_close)(
    self->d_object,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 * <p>
 * Add one to the intrinsic reference count in the underlying object.
 * Object in <code>sidl</code> have an intrinsic reference count.
 * Objects continue to exist as long as the reference count is
 * positive. Clients should call this method whenever they
 * create another ongoing reference to an object or interface.
 * </p>
 * <p>
 * This does not have a return value because there is no language
 * independent type that can refer to an interface or a
 * class.
 * </p>
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
void
sidl_rmi_InstanceHandle_addRef(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  (*self->d_epv->f_addRef)(
    self->d_object,
    _ex);
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 * Decrease by one the intrinsic reference count in the underlying
 * object, and delete the object if the reference is non-positive.
 * Objects in <code>sidl</code> have an intrinsic reference count.
 * Clients should call this method whenever they remove a
 * reference to an object or interface.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
void
sidl_rmi_InstanceHandle_deleteRef(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  (*self->d_epv->f_deleteRef)(
    self->d_object,
    _ex);
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 * Return true if and only if <code>obj</code> refers to the same
 * object as this object.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_bool
sidl_rmi_InstanceHandle_isSame(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ sidl_BaseInterface iobj,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_bool _result;
  _result = (*self->d_epv->f_isSame)(
    self->d_object,
    iobj,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 * Return whether this object is an instance of the specified type.
 * The string name must be the <code>sidl</code> type name.  This
 * routine will return <code>true</code> if and only if a cast to
 * the string type name would succeed.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_bool
sidl_rmi_InstanceHandle_isType(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ const char* name,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_bool _result;
  _result = (*self->d_epv->f_isType)(
    self->d_object,
    name,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 * Return the meta-data about the class implementing this interface.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_ClassInfo
sidl_rmi_InstanceHandle_getClassInfo(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_ClassInfo _result;
  _result = (*self->d_epv->f_getClassInfo)(
    self->d_object,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */


/**
 * Cast method for interface and class type conversions.
 */
struct sidl_rmi_InstanceHandle__object*
sidl_rmi_InstanceHandle__cast(
  void* obj,
  sidl_BaseInterface* _ex);

/**
 * String cast method for interface and class type conversions.
 */
void*
sidl_rmi_InstanceHandle__cast2(
  void* obj,
  const char* type,
  sidl_BaseInterface *_ex);

/**
 * Select and execute a method by name
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
void
sidl_rmi_InstanceHandle__exec(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ const char* methodName,
  /* in */ sidl_rmi_Call inArgs,
  /* in */ sidl_rmi_Return outArgs,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  (*self->d_epv->f__exec)(
    self->d_object,
    methodName,
    inArgs,
    outArgs,
    _ex);
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */

/**
 * Get the URL of the Implementation of this object (for RMI)
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
char*
sidl_rmi_InstanceHandle__getURL(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  char* _result;
  _result = (*self->d_epv->f__getURL)(
    self->d_object,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */

/**
 * On a remote object, addrefs the remote instance.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
void
sidl_rmi_InstanceHandle__raddRef(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  (*self->d_epv->f__raddRef)(
    self->d_object,
    _ex);
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */

/**
 * TRUE if this object is remote, false if local
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
sidl_bool
sidl_rmi_InstanceHandle__isRemote(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  sidl_bool _result;
  _result = (*self->d_epv->f__isRemote)(
    self->d_object,
    _ex);
  return _result;
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */

/**
 * TRUE if this object is remote, false if local
 */
sidl_bool
sidl_rmi_InstanceHandle__isLocal(
  /* in */ sidl_rmi_InstanceHandle self,
  /* out */ sidl_BaseInterface *_ex);
/**
 * Method to enable/disable method hooks invocation.
 */
SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
void
sidl_rmi_InstanceHandle__set_hooks(
  /* in */ sidl_rmi_InstanceHandle self,
  /* in */ sidl_bool enable,
  /* out */ sidl_BaseInterface *_ex)
#ifdef SIDL_RMI_INSTANCEHANDLE_INLINE_DECL
{
  (*self->d_epv->f__set_hooks)(
    self->d_object,
    enable,
    _ex);
}
#else
;
#endif /* SIDL_RMI_INSTANCEHANDLE_INLINE_DECL */

/**
 * Create a contiguous array of the given dimension with specified
 * index bounds in column-major order. This array
 * owns and manages its data.
 * This function initializes the contents of the array to
 * NULL.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_createCol(
  int32_t       dimen,
  const int32_t lower[],
  const int32_t upper[]);

/**
 * Create a contiguous array of the given dimension with specified
 * index bounds in row-major order. This array
 * owns and manages its data.
 * This function initializes the contents of the array to
 * NULL.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_createRow(
  int32_t       dimen,
  const int32_t lower[],
  const int32_t upper[]);

/**
 * Create a contiguous one-dimensional array with a lower index
 * of 0 and an upper index of len-1. This array
 * owns and manages its data.
 * This function initializes the contents of the array to
 * NULL.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_create1d(int32_t len);

/**
 * Create a dense one-dimensional vector with a lower
 * index of 0 and an upper index of len-1. The initial data for this
 * new array is copied from data. This will increment the reference
 * count of each non-NULL object/interface reference in data.
 * 
 * This array owns and manages its data.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_create1dInit(
  int32_t len, 
  sidl_rmi_InstanceHandle* data);

/**
 * Create a contiguous two-dimensional array in column-major
 * order with a lower index of (0,0) and an upper index of
 * (m-1,n-1). This array owns and manages its data.
 * This function initializes the contents of the array to
 * NULL.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_create2dCol(int32_t m, int32_t n);

/**
 * Create a contiguous two-dimensional array in row-major
 * order with a lower index of (0,0) and an upper index of
 * (m-1,n-1). This array owns and manages its data.
 * This function initializes the contents of the array to
 * NULL.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_create2dRow(int32_t m, int32_t n);

/**
 * Create an array that uses data (memory) from another
 * source. The initial contents are determined by the
 * data being borrowed.
 * Any time an element in the borrowed array is replaced
 * via a set call, deleteRef will be called on the
 * value being replaced if it is not NULL.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_borrow(
  sidl_rmi_InstanceHandle* firstElement,
  int32_t       dimen,
  const int32_t lower[],
  const int32_t upper[],
  const int32_t stride[]);

/**
 * If array is borrowed, allocate a new self-sufficient
 * array and copy the borrowed array into the new array;
 * otherwise, increment the reference count and return
 * the array passed in. Use this whenever you want to
 * make a copy of a method argument because arrays
 * passed into methods aren't guaranteed to exist after
 * the method call.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_smartCopy(
  struct sidl_rmi_InstanceHandle__array *array);

/**
 * Increment the array's internal reference count by one.
 */
void
sidl_rmi_InstanceHandle__array_addRef(
  struct sidl_rmi_InstanceHandle__array* array);

/**
 * Decrement the array's internal reference count by one.
 * If the reference count goes to zero, destroy the array.
 * If the array isn't borrowed, this releases all the
 * object references held by the array.
 */
void
sidl_rmi_InstanceHandle__array_deleteRef(
  struct sidl_rmi_InstanceHandle__array* array);

/**
 * Retrieve element i1 of a(n) 1-dimensional array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get1(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1);

/**
 * Retrieve element (i1,i2) of a(n) 2-dimensional array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get2(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2);

/**
 * Retrieve element (i1,i2,i3) of a(n) 3-dimensional array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get3(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3);

/**
 * Retrieve element (i1,i2,i3,i4) of a(n) 4-dimensional array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get4(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4);

/**
 * Retrieve element (i1,i2,i3,i4,i5) of a(n) 5-dimensional array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get5(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4,
  const int32_t i5);

/**
 * Retrieve element (i1,i2,i3,i4,i5,i6) of a(n) 6-dimensional array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get6(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4,
  const int32_t i5,
  const int32_t i6);

/**
 * Retrieve element (i1,i2,i3,i4,i5,i6,i7) of a(n) 7-dimensional array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get7(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4,
  const int32_t i5,
  const int32_t i6,
  const int32_t i7);

/**
 * Retrieve element indices of an n-dimensional array.
 * indices is assumed to have the right number of elements
 * for the dimension of array.
 */
sidl_rmi_InstanceHandle
sidl_rmi_InstanceHandle__array_get(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t indices[]);

/**
 * Set element i1 of a(n) 1-dimensional array to value.
 */
void
sidl_rmi_InstanceHandle__array_set1(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  sidl_rmi_InstanceHandle const value);

/**
 * Set element (i1,i2) of a(n) 2-dimensional array to value.
 */
void
sidl_rmi_InstanceHandle__array_set2(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  sidl_rmi_InstanceHandle const value);

/**
 * Set element (i1,i2,i3) of a(n) 3-dimensional array to value.
 */
void
sidl_rmi_InstanceHandle__array_set3(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  sidl_rmi_InstanceHandle const value);

/**
 * Set element (i1,i2,i3,i4) of a(n) 4-dimensional array to value.
 */
void
sidl_rmi_InstanceHandle__array_set4(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4,
  sidl_rmi_InstanceHandle const value);

/**
 * Set element (i1,i2,i3,i4,i5) of a(n) 5-dimensional array to value.
 */
void
sidl_rmi_InstanceHandle__array_set5(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4,
  const int32_t i5,
  sidl_rmi_InstanceHandle const value);

/**
 * Set element (i1,i2,i3,i4,i5,i6) of a(n) 6-dimensional array to value.
 */
void
sidl_rmi_InstanceHandle__array_set6(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4,
  const int32_t i5,
  const int32_t i6,
  sidl_rmi_InstanceHandle const value);

/**
 * Set element (i1,i2,i3,i4,i5,i6,i7) of a(n) 7-dimensional array to value.
 */
void
sidl_rmi_InstanceHandle__array_set7(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t i1,
  const int32_t i2,
  const int32_t i3,
  const int32_t i4,
  const int32_t i5,
  const int32_t i6,
  const int32_t i7,
  sidl_rmi_InstanceHandle const value);

/**
 * Set element indices of an n-dimensional array to value.indices is assumed to have the right number of elements
 * for the dimension of array.
 */
void
sidl_rmi_InstanceHandle__array_set(
  struct sidl_rmi_InstanceHandle__array* array,
  const int32_t indices[],
  sidl_rmi_InstanceHandle const value);

/**
 * Return the dimension of array. If the array pointer is
 * NULL, zero is returned.
 */
int32_t
sidl_rmi_InstanceHandle__array_dimen(
  const struct sidl_rmi_InstanceHandle__array* array);

/**
 * Return the lower bound of dimension ind.
 * If ind is not a valid dimension, 0 is returned.
 * The valid range for ind is from 0 to dimen-1.
 */
int32_t
sidl_rmi_InstanceHandle__array_lower(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t ind);

/**
 * Return the upper bound of dimension ind.
 * If ind is not a valid dimension, -1 is returned.
 * The valid range for ind is from 0 to dimen-1.
 */
int32_t
sidl_rmi_InstanceHandle__array_upper(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t ind);

/**
 * Return the length of dimension ind.
 * If ind is not a valid dimension, -1 is returned.
 * The valid range for ind is from 0 to dimen-1.
 */
int32_t
sidl_rmi_InstanceHandle__array_length(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t ind);

/**
 * Return the stride of dimension ind.
 * If ind is not a valid dimension, 0 is returned.
 * The valid range for ind is from 0 to dimen-1.
 */
int32_t
sidl_rmi_InstanceHandle__array_stride(
  const struct sidl_rmi_InstanceHandle__array* array,
  const int32_t ind);

/**
 * Return a true value iff the array is a contiguous
 * column-major ordered array. A NULL array argument
 * causes 0 to be returned.
 */
int
sidl_rmi_InstanceHandle__array_isColumnOrder(
  const struct sidl_rmi_InstanceHandle__array* array);

/**
 * Return a true value iff the array is a contiguous
 * row-major ordered array. A NULL array argument
 * causes 0 to be returned.
 */
int
sidl_rmi_InstanceHandle__array_isRowOrder(
  const struct sidl_rmi_InstanceHandle__array* array);

/**
 * Create a sub-array of another array. This resulting
 * array shares data with the original array. The new
 * array can be of the same dimension or potentially
 * less assuming the original array has dimension
 * greater than 1.  If you are removing dimension,
 * indicate the dimensions to remove by setting
 * numElem[i] to zero for any dimension i wthat should
 * go away in the new array.  The meaning of each
 * argument is covered below.
 * 
 * src       the array to be created will be a subset
 *           of this array. If this argument is NULL,
 *           NULL will be returned. The array returned
 *           borrows data from src, so modifying src or
 *           the returned array will modify both
 *           arrays.
 * 
 * dimen     this argument must be greater than zero
 *           and less than or equal to the dimension of
 *           src. An illegal value will cause a NULL
 *           return value.
 * 
 * numElem   this specifies how many elements from src
 *           should be taken in each dimension. A zero
 *           entry indicates that the dimension should
 *           not appear in the new array.  This
 *           argument should be an array with an entry
 *           for each dimension of src.  Passing NULL
 *           here will cause NULL to be returned.  If
 *           srcStart[i] + numElem[i]*srcStride[i] is
 *           greater than upper[i] for src or if
 *           srcStart[i] + numElem[i]*srcStride[i] is
 *           less than lower[i] for src, NULL will be
 *           returned.
 * 
 * srcStart  this array holds the coordinates of the
 *           first element of the new array. If this
 *           argument is NULL, the first element of src
 *           will be the first element of the new
 *           array. If non-NULL, this argument should
 *           be an array with an entry for each
 *           dimension of src.  If srcStart[i] is less
 *           than lower[i] for the array src, NULL will
 *           be returned.
 * 
 * srcStride this array lets you specify the stride
 *           between elements in each dimension of
 *           src. This stride is relative to the
 *           coordinate system of the src array. If
 *           this argument is NULL, the stride is taken
 *           to be one in each dimension.  If non-NULL,
 *           this argument should be an array with an
 *           entry for each dimension of src.
 * 
 * newLower  this argument is like lower in a create
 *           method. It sets the coordinates for the
 *           first element in the new array.  If this
 *           argument is NULL, the values indicated by
 *           srcStart will be used. If non-NULL, this
 *           should be an array with dimen elements.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_slice(
  struct sidl_rmi_InstanceHandle__array* src,
  int32_t        dimen,
  const int32_t  numElem[],
  const int32_t  *srcStart,
  const int32_t  *srcStride,
  const int32_t  *newStart);

/**
 * Copy the contents of one array (src) to a second array
 * (dest). For the copy to take place, both arrays must
 * exist and be of the same dimension. This method will
 * not modify dest's size, index bounds, or stride; only
 * the array element values of dest may be changed by
 * this function. No part of src is ever changed by copy.
 * 
 * On exit, dest[i][j][k]... = src[i][j][k]... for all
 * indices i,j,k...  that are in both arrays. If dest and
 * src have no indices in common, nothing is copied. For
 * example, if src is a 1-d array with elements 0-5 and
 * dest is a 1-d array with elements 2-3, this function
 * will make the following assignments:
 *   dest[2] = src[2],
 *   dest[3] = src[3].
 * The function copied the elements that both arrays have
 * in common.  If dest had elements 4-10, this function
 * will make the following assignments:
 *   dest[4] = src[4],
 *   dest[5] = src[5].
 */
void
sidl_rmi_InstanceHandle__array_copy(
  const struct sidl_rmi_InstanceHandle__array* src,
  struct sidl_rmi_InstanceHandle__array* dest);

/**
 * If necessary, convert a general matrix into a matrix
 * with the required properties. This checks the
 * dimension and ordering of the matrix.  If both these
 * match, it simply returns a new reference to the
 * existing matrix. If the dimension of the incoming
 * array doesn't match, it returns NULL. If the ordering
 * of the incoming array doesn't match the specification,
 * a new array is created with the desired ordering and
 * the content of the incoming array is copied to the new
 * array.
 * 
 * The ordering parameter should be one of the constants
 * defined in enum sidl_array_ordering
 * (e.g. sidl_general_order, sidl_column_major_order, or
 * sidl_row_major_order). If you specify
 * sidl_general_order, this routine will only check the
 * dimension because any matrix is sidl_general_order.
 * 
 * The caller assumes ownership of the returned reference
 * unless it's NULL.
 */
struct sidl_rmi_InstanceHandle__array*
sidl_rmi_InstanceHandle__array_ensure(
  struct sidl_rmi_InstanceHandle__array* src,
  int32_t dimen,
  int     ordering);


#pragma weak sidl_rmi_InstanceHandle__connectI

/**
 * RMI connector function for the class. (no addref)
 */
struct sidl_rmi_InstanceHandle__object*
sidl_rmi_InstanceHandle__connectI(const char * url, sidl_bool ar, struct 
  sidl_BaseInterface__object **_ex);

#ifdef __cplusplus
}
#endif
#endif