WSPutReal32Array (C Function)

int WSPutReal32Array(WSLINK link,float *a,int *dims,char **heads,
int d)

puts an array of single-precision floatingpoint numbers to the WSTP connection specified by link to form a depth-d array with dimensions dims.


  • The array a must be laid out in memory like a C array declared explicitly as .
  • If heads is given as NULL, the array will be assumed to have head List at every level.
  • The length of the array at level i is taken to be .
  • WSPutReal32Array() returns 0 in the event of an error and a nonzero value otherwise.
  • Use WSError() to retrieve the error code if WSPutReal32Array() fails.
  • WSPutReal32Array() is declared in the WSTP header file wstp.h.


Basic Examples  (1)

#include "wstp.h"

/* put an array of single-precision floating-point numbers to a link */

void f(WSLINK lp)
    float array[2][10][2];
    long dims[3];
    int i;

    for(i = 0; i < 40; i++)
        *((float *)array +i) = i + .2;

    dims[0] = 2;
    dims[1] = 10;
    dims[2] = 2;

    if(! WSPutReal32Array(lp, (float *)array, (int *)dims, (char **)0, 3))
        { /* unable to send the array to lp */ }