MEMOREAD()
 Retorna o conteúdo de um arquivo em disco na forma de uma cadeia de
 caracteres
------------------------------------------------------------------------------

 Sintaxe

     MEMOREAD(<cArq>) --> cString

 Argumentos

     <cArq> é o nome do arquivo a ser lido do disco.  Ele deve incluir
     uma extensao no caso de haver uma, e pode opcionalmente incluir path.

 Retorno

     MEMOREAD() retorna o conteúdo de um arquivo texto na forma de uma
     cadeia de caracteres.  O arquivo pode ter um tamanho de no máximo
     65.535 caracteres (64K)--ou seja, o tamanho máximo de uma cadeia de
     caracteres.  Se <cArq> nao puder ser encontrado, MEMOREAD() retorna uma
     cadeia de caracteres nula ("").

 Descriçao

     MEMOREAD() é uma funçao de tratamento de memos que lê um arquivo em
     disco para a memória, onde ele pode ser manipulado como uma cadeia de
     caracteres ou atribuido a um campo memo.  MEMOREAD() é utilizado
     juntamento com MEMOEDIT() e MEMOWRIT() para editar um arquivo de disco
     importado e depois escrevê-lo novamente no disco.  MEMOREAD() procura o
     <cArq> a partir do diretório DOS corrente.  Se o arquivo nao for
     encontrado, MEMOREAD() pesquisa o path DOS .  MEMOREAD() nao utiliza as
     configuraçoes DEFAULT ou PATH do Clipper para procurar o <cArq>.

     Em ambientes de rede, MEMOREAD() tenta abrir o arquivo especificado de
     modo compartilhado e somente para leitura.  Se o arquivo for aberto de
     modo exclusivo através de outro processo, MEMOREAD() retorna uma cadeia
     de caracteres nula ("").

 Exemplos

       O exemplo a seguir utiliza MEMOREAD() para atribuir o
        conteúdo de um arquivo texto ao campo memo Notas e a uma variável
        caractere:

        REPLACE Notas WITH MEMOREAD("Temp.txt")
        cString = MEMOREAD("Temp.txt")

       Este exemplo define uma funçao que edita um arquivo em disco:

        FUNCTION Editor( cArq )
           LOCAL cString
           IF (cString := MEMOREAD(cArq)) == ""
              ? "Erro de leitura em " + cArq
              RETURN .F.
           ELSE
              MEMOWRIT(cArq, MEMOEDIT(cString))
              RETURN .T.
           ENDIF

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

See Also: MEMOEDIT() MEMOWRIT() REPLACE