exportImpl

Class: Simulink.io.FileType
Namespace: Simulink.io

Export signals to file

Since R2020a

Syntax

[didWrite,errMsg] = exportImpl(exportFileName,varNames,varValues,isAppend)


Description

[didWrite,errMsg] = exportImpl(exportFileName,varNames,varValues,isAppend) exports signals from Signal Editor using the specified variables and returns didWrite and errMsg and saves them to exportFileName.

Input Arguments

exportFileName — File name for exported signals

character array

File name for exported signals, specified as a character array.

Data Types: char

varNames — Signal names

cell array of character vectors

Signal names, specified as a cell array of character vectors.

Data Types: cell

varValues — Signal values

cell array of signal variables

Signal values associated with the signals in varNames, specified as a cell array of signal variables of supported types. For more information on supported types, see Choose a Base Workspace and MAT-File Format.

Data Types: cell

isAppend — Append or overwrite signal file

false or 0 (default) | true or 1

Append or overwrite signal file, specified as true (1) or false (0).

Data Types: logical

Output Arguments

didWrite — Whether signals were successfully written

false or 0 | true or 1

Whether the signals were successfully written to exportFileName, returned as true (1) or false (0).

errMsg — Error message

character array

Error message, indicating errors with the reporting process, returned as a character array.

Examples

Subclass FileType Class and Implement exportImpl Method

Subclass FileType class and implement exportImpl method.

classdef MySignalMatFile < Simulink.io.FileType

Implement the static method exportImpl.

methods
        
        function [didWrite,errMsg] = exportImpl(obj,fileName,cellOfVarNames, ...
                cellOfVarValues,isAppend)
            didWrite = false;
            errMsg = '';
            
            saveStruct = struct;
            
            for k = 1: length (cellOfVarNames)
                saveStruct.(cellOfVarNames{k}) = cellOfVarValues{k};
            end
            
            try
                if isAppend
                    save(fileName,'-struct','saveStruct','-append');
                else
                    save(fileName,'-struct','saveStruct');
                end
                didWrite = true;
            catch ME
                
                % Optional, return errMsg or throw hard error.
                % Returning an error message allows your automated
                % processes to carry on while allowing you to report the
                % error at a later time.
                errMsg = ME.message;
            end
            
        end
    end
end

Version History

Introduced in R2020a