Maple Professional
Maple Academic
Maple Student Edition
Maple Personal Edition
Maple Player
Maple Player for iPad
MapleSim Professional
MapleSim Academic
Maple T.A. - Testing & Assessment
Maple T.A. MAA Placement Test Suite
Möbius - Online Courseware
Machine Design / Industrial Automation
Aerospace
Vehicle Engineering
Robotics
Power Industries
System Simulation and Analysis
Model development for HIL
Plant Modeling for Control Design
Robotics/Motion Control/Mechatronics
Other Application Areas
Mathematics Education
Engineering Education
High Schools & Two-Year Colleges
Testing & Assessment
Students
Financial Modeling
Operations Research
High Performance Computing
Physics
Live Webinars
Recorded Webinars
Upcoming Events
MaplePrimes
Maplesoft Blog
Maplesoft Membership
Maple Ambassador Program
MapleCloud
Technical Whitepapers
E-Mail Newsletters
Maple Books
Math Matters
Application Center
MapleSim Model Gallery
User Case Studies
Exploring Engineering Fundamentals
Teaching Concepts with Maple
Maplesoft Welcome Center
Teacher Resource Center
Student Help Center
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");
rt = args[1];
RTableGetSettings(kv,&rts,rt);
if( rts.data_type != RTABLE_FLOAT64 ) {
MapleRaiseError(kv,"float[8] rtable expected for parameter 1");
data = (FLOAT64*)RTableDataBlock(kv,rt);
n = RTableNumElements(kv,rt);
for( val=0,i=0; i<n; ++i ) {
val += data[i];
return( ToMapleFloat(kv,val) );
Execute the external function from Maple.
See Also
CustomWrapper, define_external, OpenMaple, OpenMaple/C/API, OpenMaple/C/Examples, rtable
Download Help Document