Difference between revisions of "Retclen()"
From Lianjapedia
Yvonne.milne (Talk | contribs) m (1 revision) |
Yvonne.milne (Talk | contribs) m (Text replace - "lianjaapi.h" to "lianja_api.h") |
||
Line 7: | Line 7: | ||
==SYNOPSIS== | ==SYNOPSIS== | ||
<code lang="c"> | <code lang="c"> | ||
− | #include " | + | #include "lianja_api.h" |
int _retclen(string, len) | int _retclen(string, len) | ||
Line 34: | Line 34: | ||
<code lang="c"> | <code lang="c"> | ||
− | #include " | + | #include "lianja_api.h" |
lianjaapi_ltow() | lianjaapi_ltow() |
Latest revision as of 08:59, 11 April 2013
PURPOSE
Return a character string
SYNONYM
api_ret_clen()
SYNOPSIS
#include "lianja_api.h" int _retclen(string, len) <input parameters> char *string; /*Address of a buffer containing a character string */ int len; /* Length of string */ <output parameters> none
DESCRIPTION
The _retclen() function is used to pass a character pointer back to your application. The second parameter, len, is used to specify the length of the character string returned. The maximum length of a string that can be returned is 64kB. If the string is too long, an error message will be returned.
EXAMPLE
The following example evaluates the first parameter passed and returns the English translation of the logical condition with a length of 5 characters.
Example Lianja script:
m_word=ltow(.T.)
Example 'C' function:
#include "lianja_api.h" lianjaapi_ltow() { char strbuff[6]; if (_parinfo(1) == API_LTYPE) { if ( _parl(1) == 0 ) { strcpy( strbuff, "False" ); } else { strcpy( strbuff, "True" ); } }else { strcpy(strbuff, ""); } _retclen(strbuff, 5); }
SEE ALSO
_parc(), _parclen(), _parcsiz(), _parinfo(), _retc(), ISCHAR(), CHAR_ALLTRIM(), CHAR_LOWER(), CHAR_LPAD(), CHAR_LTRIM(), CHAR_RPAD(), CHAR_RTRIM(), CHAR_STR(), CHAR_UPPER(), DATE_STOD()