PUTCHARARRAY

Purpose:

Stores data to a variable as a string to DADiSP’s ActiveX Automation Server.

Syntax:

void PutCharArray(

[in] BSTR "name", [in] "workspace", [in] BSTR "string")

"name"	-	A string, the name of the destination variable.
"workspace"	-	A string, the name of the Workspace. Currently unused.
"string"	-	A string, the source string to store.

Returns:

Nothing.

Example:

Visual Basic Example:

Dim DADiSP as Object

Dim Result1 as String

’’’ Connect to DADiSP

Set DADiSP = CreateObject("dadisp.application")

’’’ Create a 2 Window Worksheet without prompting

Call DADiSP.Execute("newworksheet(2, 0)")

’’’ put a string to var1

Call DADiSP.PutCharArray("var1", "base", "This is a String")

’’’ get the string

Result1 = DADiSP.GetCharArray("var1", "base")

Starts DADiSP as an ActiveX Automation server, creates a 2 Window Worksheet and places the string This is a String into the variable var1. The string Result1 contains the string This is a String.

Remarks:

A string can be transferred into any DADiSP variable. If a string is placed into a Window, it is converted into a series of integers representing the character codes of the string.

See PUTSERIES and PUTFULLMATRIX to store a SafeArray to a Window or variable.