MLCOUNT()
 Conta a quantidade de linhas em uma cadeia de caracteres ou campo memo
------------------------------------------------------------------------------

 Sintaxe

     MLCOUNT(<cString>, [<nTamLinha>],
        [<nTamTab>], [<lTransporte>]) --> nLinhas

 Argumentos

     <cString> é a cadeia de caracteres ou campo memo que será contado.

     <nTamLinha> especifica a quantidade de caracteres por linha, e pode
     variar entre quatro e 254.  Caso nao seja especificado, o tamanho de
     linha padrao é 79.

     <nTamTab> define o tamanho da tabulaçao.  Se nao for especificado,
     o valor padrao é quatro.  Se <nTamTab> for maior ou igual a
     <nTamLinha>, entao o tamanho da tabulaçao é automaticamente convertido
     para <nTamLinha> - 1.

     <lTransporte> comuta transporte.  Especificar verdadeiro (.T.) liga
     transporte; falso (.F.) o desliga.  Se nao for especificado, o valor
     padrao é verdadeiro (.T.).

 Retorno

     MLCOUNT() retorna a quantidade de linhas em <cString>, dependendo do
     <nTamLinha>, do <nTamTab>, e se transporte está ligado ou nao.

 Descriçao

     MLCOUNT() é uma funçao de tratamento de memos utilizada juntamente com
     MEMOLINE() para imprimir cadeias de caracteres e campos memo com base
     na quantidade de caracteres por linha.  O método básico de operaçao é
     usar MLCOUNT() para retornar a quantidade de linhas na cadeia de
     caracteres ou campo memo.  Depois, utilizando MEMOLINE() para extrair
     cada linha, percorrendo o campo memo até que nao reste mais nenhuma
     linha.

     Se <lTransporte> for verdadeiro (.T.) e uma posiçao de final de linha
     quebrar uma palavra, ela é transportada para a próxima linha, que
     começará com esta palavra.  Caso <lTransporte> seja falso (.F.),
     MLCOUNT() conta a quantidade de caracteres especificada por <nTamLinha>
     como a linha corrente.  A próxima linha começa com o caractere seguinte
     ao próximo carriage return soft ou hard (manual ou automático).  Os
     caracteres intermediários sao ignorados.

 Exemplos

     Este exemplo exibe o conteúdo de cada campo memo Notas no arquivo de
     banco de dados Sales, uma linha de cada vez:

     USE Sales NEW
     nLineSize := 65
     //
     WHILE !EOF()
        nLines := MLCOUNT(Sales->Notas, nLineSize)
        FOR nCurrLine := 1 TO nLines
           ? MEMOLINE(Sales->Notas, nCurrLine, nLineSize)
        NEXT
        SKIP
        ?
     ENDDO

 Arquivos:  Biblioteca EXTEND.LIB.
 To download this example - click here.

See Also: MEMOLINE() MEMOTRAN() MLPOS()