PutCharArray

Character array in Automation server

Synopsis

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)

MATLAB Client

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


Description

PutCharArray(h,'varname','workspace','string') stores the character array in string in the specified workspace of the server attached to handle h, assigning to it the variable varname. The values for workspace are base or global. The function name is case-sensitive.

Examples

Pass Character Data from Visual Basic® .NET Client to MATLAB®

This example shows how to pass character data from a Visual Basic® .NET client to MATLAB®. Create an application with the following code.

type putchararray.vb

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...")
Matlab.PutCharArray("str", "base", _
  "He jests at scars that never felt a wound.")
MsgBox("In MATLAB, type" & vbCrLf & "str")
MsgBox("closing MATLAB window...")
Matlab.Quit()

Open the MATLAB window, then click Ok.

In the MATLAB window type str; MATLAB displays:

str =

He jests at scars that never felt a wound.

Click Ok to close and terminate MATLAB.

Pass Character Data from VBA Client to MATLAB®

This example shows how to pass character data from a Visual Basic® .NET client to MATLAB®. Create an application with the following code.

type putchararray.vba

Dim Matlab As Object 
Set Matlab = CreateObject("matlab.application") 
MsgBox ("MATLAB window created; now open it...") 
x = Matlab.PutCharArray("str", "base", "He jests at scars that never felt a wound.") 
MsgBox ("In MATLAB, type" & vbCrLf & "str") 
MsgBox ("closing MATLAB window...") 
y = Matlab.Quit()

Open the MATLAB window, then click Ok.

In the MATLAB window type str; MATLAB displays:

str =

He jests at scars that never felt a wound.

Click Ok to close and terminate MATLAB.

Tips

• 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
  
  PutCharArray(h,'Foo','base',chArr)
  tstArr = GetCharArray(h,'Foo','base')
  tstArr =
  adgbehcfk