RTableDataBlock - Maple Programming Help

# Online Help

###### All Products    Maple    MapleSim

Home : Support : Online Help : Programming : OpenMaple : C Application Programming Interface : RTable Manipulation : OpenMaple/C/RTableDataBlock

RTableDataBlock

access the rtable data block in external code

 Calling Sequence RTableDataBlock(kv, rt)

Parameters

 kv - kernel handle of type MKernelVector rt - type ALGEB rtable object

Description

 • This function can be used in external code with OpenMaple or define_external.
 • RTableDataBlock returns a pointer to the data contained in the given rtable, rt.  The returned pointer must be cast into the correct hardware datatype to access elements. The data type can be obtained from the data_type field of the RTableSettings structure returned by RTableGetSettings.
 • Before modifying data in the data block, ensure the rtable rt is not read-only.  The read-only flag value can be obtained from the read_only field of the RTableSettings structure returned by RTableGetSettings.
 • Do not directly modify the data block of an rtable with an indexing function.  The data stored in position [1,1] of an rtable with a special indexing function may not correspond to the [1,1] element accessed from the rtable.
 • An error is raised if an attempt is made to get the data block from a Maple-sparse rtable.

Examples

 #include "maplec.h" ALGEB M_DECL MySumElems( MKernelVector kv, ALGEB *args ) { M_INT argc, n, i; ALGEB rt; FLOAT64 val, *data; RTableSettings rts; argc = MapleNumArgs(kv,(ALGEB)args); if( argc != 1 ) { MapleRaiseError(kv,"one argument expected"); return( NULL ); } if( !IsMapleRTable(kv,args[1]) ) { MapleRaiseError(kv,"rtable expected for parameter 1"); return( NULL ); } rt = args[1]; RTableGetSettings(kv,&rts,rt); if( rts.data_type != RTABLE_FLOAT64 ) { MapleRaiseError(kv,"float[8] rtable expected for parameter 1"); return( NULL ); } data = (FLOAT64*)RTableDataBlock(kv,rt); n = RTableNumElements(kv,rt); for( val=0,i=0; i

Execute the external function from Maple.

 > $\mathrm{with}\left(\mathrm{ExternalCalling}\right):$
 > $\mathrm{dll}≔\mathrm{ExternalLibraryName}\left("HelpExamples"\right):$
 > $\mathrm{sum_elems}≔\mathrm{DefineExternal}\left("MySumElems",\mathrm{dll}\right):$
 > $M≔\mathrm{Matrix}\left(3,\left(i,j\right)→3\left(i-1\right)+j,\mathrm{datatype}=\mathrm{float}[8]\right)$
 ${M}{:=}\left[\begin{array}{ccc}{1.}& {2.}& {3.}\\ {4.}& {5.}& {6.}\\ {7.}& {8.}& {9.}\end{array}\right]$ (1)
 > $\mathrm{sum_elems}\left(M\right)$
 ${45.}$ (2)

 See Also

## Was this information helpful?

 Please add your Comment (Optional) E-mail Address (Optional) What is ? This question helps us to combat spam