PA_Dial4DGetArrayString

version 2003

PA_Dial4DGetArrayString (dialog; variable; string; index)

Parameter	Type		Description
dialog	PA_Dial4D	→	Dialog reference
variable	char*	→	Name of the array to access
string	char*	←	Value of the element
index	long	→	Element to access

Description

The routine PA_Dial4DGetArrayString retrieves a string from a string/text array .


   
    variable

is the name of the array. This array can be created externally using


   
    PA_Dial4DNewArrayString

, or it can be created using 4th Dimension code in the form.

By default, variable and string are null terminated C strings. If you have previously called PA_UsePStrings you must pass and you will receive a Pascal string from the command.

By default, varName and string use Macintosh characters set on Macintosh, and ANSI characters set under Windows. You can call PA_UseMacCharacters or PA_UseAnsiCharacters to specifically use Macintosh or ANSI characters.

Example

Get the current value of a string array.

   void Dial4D_GetCurrentStringElement( PA_Dial4D ref, char *variable, char *value )
   {
      long   index = PA_Dial4DGetLong( ref, variable );
      return PA_Dial4DGetArrayReal( ref, variable, value, index );
   }

Error Handling

None.