Difference between revisions of "STRLEN()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{YLM to do}}
 
 
==Class==
 
 
 
 
 
==Purpose==
 
==Purpose==
 
+
Function to return length of specified expression
  
  
 
==Syntax==
 
==Syntax==
 
+
STRLEN(<exp>[,<expL>])
  
  
 
==See Also==
 
==See Also==
 
+
[[AT()]], [[LEFT()]], [[LEN()]], [[RAT()]], [[RIGHT()]], [[SET STRESCAPE]], [[STREXTRACT()]], [[STRTRAN()]], [[STUFF()]], [[SUBSTR()]]
  
  
 
==Description==
 
==Description==
 
+
The STRLEN() function returns the output width of the specified expression <exp>.  The expression can be of any data type, including memo fields and arrays.  When checking the length of character expressions, the optional <expL> can be specified.  If <expL> is specified and evaluates to .T. (true), the STRLEN() function will return the length of the character expression after stripping any formatting options such as BOLD().
  
  
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
 
+
open database southwind
 +
use example
 +
? strlen(last_name)
 +
        16
 +
? strlen(notes)
 +
      8851
 +
? strlen("")
 +
        0
 +
? strlen(bold("Hello"))
 +
        9
 +
? strlen(bold("Hello"),.T.)
 +
        5
 
</code>
 
</code>
  
==Products==
 
  
 +
==Products==
 +
Recital Server, Recital
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]

Latest revision as of 14:25, 21 July 2010

Purpose

Function to return length of specified expression


Syntax

STRLEN(<exp>[,<expL>])


See Also

AT(), LEFT(), LEN(), RAT(), RIGHT(), SET STRESCAPE, STREXTRACT(), STRTRAN(), STUFF(), SUBSTR()


Description

The STRLEN() function returns the output width of the specified expression <exp>. The expression can be of any data type, including memo fields and arrays. When checking the length of character expressions, the optional <expL> can be specified. If <expL> is specified and evaluates to .T. (true), the STRLEN() function will return the length of the character expression after stripping any formatting options such as BOLD().


Example

open database southwind
use example
? strlen(last_name)
        16
? strlen(notes)
      8851
? strlen("")
         0
? strlen(bold("Hello"))
         9
? strlen(bold("Hello"),.T.)
         5


Products

Recital Server, Recital