Main Content

get

Read variables from connected data source

Since R2024a

    Description

    get(connectionObj,varNames) returns the values of the specified variables varNames in the connected data source connectionObj. The function returns a missing value, displayed as <missing>, for variables that are not defined in the connected data source connectionObj.

    If the data connection can access multiple definitions of the same variable (for example, in a data dictionary and in a referenced dictionary), the function reports an error if the definitions of the variable are inconsistent. For multiple consistent definitions, the function returns the value of one of the variable definitions.

    example

    Examples

    collapse all

    matFile = Simulink.data.connect("myMatFile.mat");
    set(matFile,"b",2);
    get(matFile,"b")
    ans = 
    
        2
    mw = Simulink.data.connect("myModel.slx")
    set(mw,{'e','f'},{5,6});
    get(mw,{'e','x','f'})
    ans = 
    
    1x3 cell array
    
        {[5]}    {[<missing>]}    {[6]}

    Input Arguments

    collapse all

    Connection to data source, specified as a Simulink.data.DataConnection object.

    Variable names, specified by a string, character vector, string array, or cell array of character vectors.

    Tips

    You can also read and assign values to variables by using dot notation. For example:

    dd = Simulink.data.connect('myDictionary.sldd');
    dd.x = 1;
    dd.x
    
    ans = 
    
         1
    
    dd.b
    
    ans = 
    
      missing
    
        <missing>
    

    Version History

    Introduced in R2024a