Learn more about MATLAB

PutCharArray - Store character array in Automation server

Synopsis

MATLAB Client

h.PutCharArray('varname', 'workspace', 'string')
PutCharArray(h, 'varname', 'workspace', 'string')
invoke(h, 'PutCharArray', 'varname', 'workspace', 'string')

IDL Method Signature

PutCharArray([in] BSTR varname, [in] BSTR workspace,  
[in] BSTR string)

Microsoft Visual Basic Client

PutCharArray(varname As String, workspace As String, 
string As String)

Description

PutCharArray stores the character array in string in the specified workspace of the server attached to handle h, assigning to it the variable varname. The workspace argument can be either base or global.

Remarks

The character array specified in the string argument can have any dimensions. However, PutCharArray changes the dimensions to a 1–by-n column-wise representation, where n is the number of characters in the array. Executing the following commands in MATLAB illustrates this behavior:

h = actxserver('matlab.application');
chArr = ['abc'; 'def'; 'ghk']
chArr =
abc
def
ghk

h.PutCharArray('Foo', 'base', chArr)
tstArr = h.GetCharArray('Foo', 'base')
tstArr =
adgbehcfk 

Server function names, like PutCharArray, are case sensitive when using the dot notation syntax shown in the Syntax section.

There is no difference in the operation of the three syntaxes shown above for the MATLAB client.

Examples

Store string str in the base workspace of the server using PutCharArray.

MATLAB Client

h = actxserver('matlab.application');
h.PutCharArray('str', 'base', ...
   'He jests at scars that never felt a wound.')

S = h.GetCharArray('str', 'base')
S =
    He jests at scars that never felt a wound.

Visual Basic .NET Client

This example uses the Visual Basic MsgBox command to control flow between MATLAB and the Visual Basic Client.

Dim Matlab As Object
Try
    Matlab = GetObject(, "matlab.application")
Catch e As Exception
    Matlab = CreateObject("matlab.application")
End Try
MsgBox("MATLAB window created; now open it...")

Open the MATLAB window, then click Ok.

Matlab.PutCharArray("str", "base", _
       "He jests at scars that never felt a wound.")
MsgBox("In MATLAB, type" & vbCrLf _
  & "str")

In the MATLAB window type str; MATLAB displays:

str =
He jests at scars that never felt a wound.

Click Ok.

MsgBox("closing MATLAB window...")

Click Ok to close and terminate MATLAB.

Matlab.Quit()

See Also

GetCharArray, PutWorkspaceData, GetWorkspaceData, Execute

publish

PutFullMatrix

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS