Difference between revisions of "SET STRINGLEN"

From Recital Documentation Wiki
Jump to: navigation, search
Line 1: Line 1:
=SET STRINGLEN=
 
 
 
 
==Class==
 
==Class==
 
Expressions and Type Conversion
 
Expressions and Type Conversion
Line 15: Line 12:
  
 
==See Also==
 
==See Also==
[[STR()]]
+
[[STR()]], [[STRZERO()]]
  
  
 
==Description==
 
==Description==
 
This set command affects the behavior of the STR() function.  If SET STRINGLEN is ON and the optional length parameter of the STR() function is not specified, STR() will return a string the same length as the numeric column.  This command allows the optional logical expression <expL> to be evaluated.  If a value of .T. is returned, STRINGLEN is set ON.  If a value of .F. is returned STRINGLEN is set OFF.  By default STRINGLEN is OFF.
 
This set command affects the behavior of the STR() function.  If SET STRINGLEN is ON and the optional length parameter of the STR() function is not specified, STR() will return a string the same length as the numeric column.  This command allows the optional logical expression <expL> to be evaluated.  If a value of .T. is returned, STRINGLEN is set ON.  If a value of .F. is returned STRINGLEN is set OFF.  By default STRINGLEN is OFF.
 +
 
NOTE: this command has no effect on the STRZERO() function.
 
NOTE: this command has no effect on the STRZERO() function.
  
  
 
==Example==
 
==Example==
<pre>
+
<code lang="recital">
 
? len(total)
 
? len(total)
 
         5
 
         5
Line 31: Line 29:
 
set stringlen on
 
set stringlen on
 
? len(str(total))
 
? len(str(total))
         5</pre>
+
         5
 +
</code>
  
  

Revision as of 11:47, 20 April 2009

Class

Expressions and Type Conversion


Purpose

Affects the size of the return value of the STR() function


Syntax

SET STRINGLEN ON | OFF | (<expL>)


See Also

STR(), STRZERO()


Description

This set command affects the behavior of the STR() function. If SET STRINGLEN is ON and the optional length parameter of the STR() function is not specified, STR() will return a string the same length as the numeric column. This command allows the optional logical expression <expL> to be evaluated. If a value of .T. is returned, STRINGLEN is set ON. If a value of .F. is returned STRINGLEN is set OFF. By default STRINGLEN is OFF.

NOTE: this command has no effect on the STRZERO() function.


Example

? len(total)
         5
? len(str(total))
        10
set stringlen on
? len(str(total))
         5


Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer