Name

creadchain (obsolete) — Read a single string from Scilab memory using call_scilab. Starting with Scilab 5.2, this function is obsolete. See API_Scilab: String reading for remplacement.

Synopsis

int C2F(creadchain)(char *name, int *itslen, char *myString, unsigned long name_len, unsigned long myString_len);

Parameters

name

The name of the future Scilab variable

itslen

The length of the future buffer (usually, use bsiz, it skips the need to detect the size of a char). This variable will be altered to contain the actual size of myString

myString

The actual String (char *) which is going to content the content of the Scilab variable name

name_len

The length of the variable name (fortran compatibility)

myString_len

The length of the string (fortran compatibility)

C2F

C2F is just a macro which provides to this function the ability to be called from fortran

Description

This help describes how to use the function creadchain.

Using this function will retrieve a variable called name from Scilab memory into a standard C char *.

Examples

 
/* Load the previously set variable A */
// See: modules/call_scilab/examples/basicExamples/readwritestring.c
int sizeA = 0;
char myStringFromScilab[bsiz]; /* Static char */
int length_myStringFromScilab = bsiz; /* Max size (it is going to be changed by creadchain */
char variableToBeRetrieved[]="A";

/* We are loading a single string from Scilab */
C2F(creadchain)(variableToBeRetrieved,&length_myStringFromScilab,myStringFromScilab,strlen(variableToBeRetrieved),strlen(myStringFromScilab));

printf("\n");
printf("Display of A (size %d): %s\n", length_myStringFromScilab, myStringFromScilab);
 

See Also

Call_Scilab,api Scilab,API_Scilab: String reading, API_Scilab: String writing, SendScilabJob, StartScilab, cwritechain, String Management

Authors

Sylvestre Ledru