version 2003
PA_SetTextInArray (array; index; text; len)
Parameter | Type | Description | |
array | PA_Variable | Array to access | |
index | long | Index of the element to access | |
text | char * | Pointer to the text to put in the index element | |
len | long | Size of text |
Description
The routine PA_SetTextInArray sets the index element of the text array array to text.
Pass a pointer to the new text value in text and its length in len.
If array is not a eVK_ArrayText or if index is out of range, the routine does nothing.
By default, PA_SetTextInArray expect text to use Macintosh characters on Macintosh and ANSI characters under Windows. If you have called PA_UseMacCharacters or PA_UseAnsiCharacters previously, PA_SetStringInArray will expect text to use the specified characters set.
Example
Initialize every element of a text array to a special value.
void FillTextArrayWith( PA_Variable arr, char *text, long len ) { long count, i; count = PA_GetArrayNbElements( arr ); for ( i = 1; i <= count; i++ ) PA_SetTextInArray( arr, i, text, len ); }
See Also
PA_GetTextInArray, PA_UseAnsiCharacters, PA_UseMacCharacters.
Error Handling
None.