engOutputBuffer (External Interfaces Reference)

Specify buffer for MATLAB output

C Syntax

#include "engine.h"
int engOutputBuffer(Engine *ep, char *p, int n);

Arguments

ep
Engine pointer.

p
Pointer to character buffer of length n.

n
Length of buffer p.

Description

engOutputBuffer defines a character buffer for engEvalString to return any output that ordinarily appears on the screen.

The default behavior of engEvalString is to discard any standard output caused by the command it is executing. engOutputBuffer(ep, p, n) tells any subsequent calls to engEvalString to save the first n characters of output in the character buffer pointed to by p.

To turn off output buffering, use engOutputBuffer(ep, NULL, 0);

Note The buffer returned by engEvalString is not guaranteed to be NULL terminated.

Examples

UNIX

See engdemo.c in the eng_mat subdirectory of the examples directory for a sample program that illustrates how to call the MATLAB engine functions from a C program.

Windows

See engwindemo.c in the eng_mat subdirectory of the examples directory for a sample program that illustrates how to call the MATLAB engine functions from a C program for Windows.

engOpenSingleUse engPutArray (Obsolete)