isdeployed

Determine whether code is running in deployed or MATLAB mode

Syntax

x = isdeployed

Description

x = isdeployed returns logical 1 (true) when the function is running in deployed mode using MATLAB^® Runtime and 0 (false) if it is running in a MATLAB session.

An application running in deployed mode consists of a collection of MATLAB functions and data packaged using MATLAB Compiler SDK™ into software components that run outside of a MATLAB session using MATLAB Runtime libraries.

Examples

Access Files from Deployed Functions

You can access files included in a packaged application by using the which function, or by specifying the file location relative to ctfroot.

Add a file such as extern_app.exe to your MATLAB Compiler SDK project.

Check if the code is running in deployed mode by using isdeployed. Then, obtain the path to the file by using the which function.

if isdeployed
    locate_externapp = which(fullfile('extern_app.exe'));
end

The which function returns the path to the file extern_app.exe, as long as it is located within the deployable archive.

For more information, see Access Files in Packaged Applications.

Protect Use of ADDPATH

The path of a deployed application is fixed at compile time and cannot change. Use isdeployed to ensure that the application uses path modifying functions, such as addpath, before deployment.

if ~(ismcc || isdeployed)
    addpath(mypath);
end

Display Documentation

You cannot use the doc function to open the Help browser from a deployed application. Instead, redirect a help query to the MathWorks^® website.

if ~isdeployed
    doc(mfile);
else 
   web('https://www.mathworks.com/support.html');
end

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• Returns true and false as appropriate for MEX targets.

• Returns false for SIM targets, which you should query using coder.target (MATLAB Coder).

• Returns false for other targets.