Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Português - 日本語

Please note that the recommended version of Scilab is 6.0.0. This page might be outdated.
However, this page did not exist in the previous stable version.

Aide Scilab >> API call_scilab (moteur Scilab) > creadchain (obsolete)

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.

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



The name of the future Scilab variable


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


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


The length of the variable name(fortran compatibility)


The length of the string (fortran compatibility)


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


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 *.


/* 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 */

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

See Also

  • Call_Scilab — call_scilab is an interface which provides the ability to call Scilab engine from C/C++ code
  • api Scilab — api_scilab is the Scilab interface to read/write data from/to Scilab memory
  • API_Scilab: String reading — How to read matrices of strings in a gateway.
  • API_Scilab: String writing — How to write matrices of string in a gateway.
  • SendScilabJob — Send a Scilab task from a C/C++ code (call_scilab)
  • StartScilab — Initializes and starts Scilab engine in Call Scilab
  • cwritechain — Write a single string into Scilab memory using call_scilab. Starting with Scilab 5.2, this function is obsolete. See API_Scilab: String writing for remplacement.
  • String Management — How to manage Scilab's String read and write process using call_scilab and api_scilab


Sylvestre Ledru

Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:11:04 CEST 2011