/*
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - Sylvestre LEDRU
 *
 * This file must be used under the terms of the CeCILL.
 * This source file is licensed as described in the file COPYING, which
 * you should have received as part of this distribution.  The terms
 * are also available at
 * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
 *
 */
/*--------------------------------------------------------------------------*/
#ifndef __CVSTR_H__
#define __CVSTR_H__

#include "machine.h" /* C2F */
#include "dynlib_string.h"

/**
* converts from ascii to Scilab internal coding
* @param n integer, length of the string to be converted integer
* @param line: int array (where Scilab coded string are stored )
* @param str: string
* @param job: int flag
* @param str_len : length of str
* @return 1: code-->ascii
* @return 0: ascii-->code
*/
STRING_IMPEXP int C2F(cvstr)(int * n, int * line, char * str, int * job, unsigned long str_len);

/**
* converts from ascii to Scilab internal coding
* ascii->code is performed from end to the begining
* @param n integer, length of the string to be converted integer
* @param line: int array (where Scilab coded string are stored )
* @param str: string
* @param job: int flag
* @param str_len : length of str
* @return 0: ascii-->code
*/
STRING_IMPEXP int C2F(cvstr1)(int *n, int * line, char * str, int * job, unsigned long str_len);

/**
* converts from Scilab internal coding to ascii
* @param n integer, length of the string to be converted integer
* @param line: int array (where Scilab coded string are stored )
* @param str: string
* @param str_len : length of str
* @return 0
*/
STRING_IMPEXP int C2F(codetoascii)(int *n, int * line, char * str, unsigned long str_len);

/**
* converts from ascii to Scilab internal coding
* @param n integer, length of the string to be converted integer
* @param line: int array (where Scilab coded string are stored )
* @param str: string
* @param flagx:  1 or -1 and this is used when the
* conversion is made with line and str stored at overlapping
* memory zone
* @param str_len : length of str
* @return 0
*/
STRING_IMPEXP int C2F(asciitocode)(int * n, int * line, char * str, int * flagx, unsigned long  str_len);

#endif /* __CVSTR_H__ */
/*--------------------------------------------------------------------------*/