mxSetSingles (Fortran)

Set real data elements in mxSINGLE_CLASS array

Fortran Syntax

#include "fintrf.h"
integer*4 mxSetSingles(pa, dt)
mwPointer pa, dt

Description

Use mxSetSingles to set mxSingle data in the specified array.

All mxCreate* functions allocate heap space to hold data. Therefore, you do not ordinarily use the function to initialize the elements of an array. Rather, call the function to replace existing values with new values.

Input Arguments

expand all

`pa` — MATLAB array
`mwPointer`

Pointer to an mxSINGLE_CLASS array.

`dt` — Data array
`mwPointer`

Pointer to the first mxSingle element of the data array. dt must be allocated by the functions mxCalloc or mxMalloc.

Output Arguments

expand all

`status` — Function status
`integer*4`

Function status, returned as integer*4. If successful, then the function returns 1.

If pa is 0, then the function returns 0.

The function is unsuccessful when mxArray is not an unshared mxSINGLE_CLASS array, or if the data is not allocated with mxCalloc. If the function is unsuccessful, then:

MEX file — Function terminates the MEX file and returns control to the MATLAB^® prompt.
Standalone (non-MEX file) application — Function returns 0.

API Version

This function is available in the interleaved complex API. To build myMexFile.F using this function, type:

mex -R2018a myMexFile.F

Version History

Introduced in R2018b