defineOutput

Class: clibgen.MethodDefinition
Package: clibgen

Add output argument definition for C++ method

expand all in page

Syntax

defineOutput(methodDef,argName,mltype)
defineOutput(methodDef,argName,mltype,shape)
defineOutput(___,argDesc)
defineOutput(___,'DeleteFcn',deleteFcn)

Description

defineOutput(methodDef,argName,mltype) adds an output argument definition for a C++ method.

defineOutput(methodDef,argName,mltype,shape) provides information about data dimensions.

defineOutput(___,argDesc) adds an argument description, and can include any of the input parameters in previous syntaxes.

defineOutput(___,'DeleteFcn',deleteFcn) specifies a C++ library deleter function to manage the memory of the argument.

Input Arguments

expand all

Method definition, specified as a clibgen.MethodDefinition object.

C++ output argument name, specified as a string scalar or a character vector.

MATLAB® type, specified as a string scalar or a character vector.

Dimension definition used by MATLAB to define data dimensions, specified as a string vector, scalar text, positive integer vector, "nullTerminated", or a cell array. For a cell array, the elements are a combination of scalar text and scalar positive integers.

If you can define the argument dimension as a fixed scalar value, then enter a number, such as 5.

If the dimension is defined by another argument, then enter the argument name as a string. For example, consider the following C++ signature. If argument len defines the length of data, then the value of shape is "len".

myFunc(const int *data, int len)

If the size of an argument is defined by an array, then the value of shape is one of the following:

  • 1

  • Fixed dimensions: Enter a numerical array, such as [5,2].

  • Variable dimensions: Enter a string array of parameter names, such as ["row","col"]

If the C++ type for the argument is a string, then use these options to choose values for the mltype and shape arguments.

C++ TypemltypeOptions for shape
char *

int8

Scalar value
Array of scalar values

const char *

char

MATLAB char
Character vector

string

"nullTerminated"

For more information, see MATLAB to C++ Data Type Mapping.

C++ argument description, specified as a string scalar or a character vector.

Deleter function, specified as a string scalar or character vector. The deleter can be the C++ standard delete operator or a user-defined function. If the function returns a pointer, then MATLAB takes ownership and manages the life cycle of the memory represented by the argument. If deleteFcn is not specified, then the library is responsible for managing the memory.

If you specify a library function for the deleter function, then that function is not included in the interface and users cannot call the function from MATLAB. The MATLAB user calls the MATLAB delete function, which calls the function specified by deleteFcn.

Example: 'DeleteFcn','objFree'

See Also

|

Introduced in R2019a

MATLAB Documentation

Support