[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 MLCOUNT()
 Count the number of lines in a character string or memo field
------------------------------------------------------------------------------
 Syntax

     MLCOUNT(<cString>, [<nLineLength>],
        [<nTabSize>], [<lWrap>]) --> nLines

 Arguments

     <cString> is the character string or memo field to be counted.

     <nLineLength> specifies the number of characters per line and can
     range from four to 254.  If not specified, the default line length is
     79.

     <nTabSize> defines the tab size.  If not specified, the default
     value is four.  If <nTabSize> is greater than or equal to <nLineLength>,
     then the tab size is automatically converted to <nLineLength> - 1.

     <lWrap> toggles word wrap on and off.  Specifying true (.T.) toggles
     word wrap on; false (.F.) toggles it off.  If not specified, the default
     value is true (.T.).

 Returns

     MLCOUNT() returns the number of lines in <cString> depending on the
     <nLineLength>, the <nTabSize>, and whether word wrapping is on or off.

 Description

     MLCOUNT() is a memo function used with MEMOLINE() to print character
     strings and memo fields based on the number of characters per line.  In
     the basic operation, use MLCOUNT() to return the number of lines in the
     character string or memo field.  Then, using MEMOLINE() to extract each
     line, loop through the memo field until there are no lines left.

     If <lWrap> is true (.T.) and an end of line position breaks a word, it
     is word wrapped to the next line and the next line begins with that
     word.  If <lWrap> is false (.F.), MLCOUNT() counts the number of
     characters specified by <nLineLength> as the current line.  The next
     line begins with the character following the next hard or soft carriage
     return.  Intervening characters are ignored.

 Examples

     .  This example displays the contents of each Notes memo field in
        the Sales database file, one line at a time:

        USE Sales NEW
        nLineLength = 65
        //
        DO WHILE !EOF()
           nLines = MLCOUNT(Sales->Notes, nLineLength)
           FOR nCurrLine = 1 TO nLines

              ? MEMOLINE(Sales->Notes, nLineLength, nCurrLine)
           NEXT
           SKIP
           ?
        ENDDO

 Files   Library is EXTEND.LIB.


See Also: MEMOLINE() MEMOTRAN() MLPOS()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson