RTableDataBlock - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


RTableDataBlock

access the rtable data block in external code

 

Calling Sequence

Parameters

Description

Examples

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<n; ++i ) {

        val += data[i];

    }

    return( ToMapleFloat(kv,val) );

    }

Execute the external function from Maple.

withExternalCalling&colon;

dllExternalLibraryNameHelpExamples&colon;

sum_elemsDefineExternalMySumElems&comma;dll&colon;

MMatrix3&comma;i&comma;j3i3+j&comma;datatype=float8

M1.2.3.4.5.6.7.8.9.

(1)

sum_elemsM

45.

(2)

See Also

CustomWrapper

define_external

OpenMaple

OpenMaple/C/API

OpenMaple/C/Examples

rtable