[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 MEMOTRAN()
 Replace carriage return/linefeeds in character strings
------------------------------------------------------------------------------
 Syntax

     MEMOTRAN(<cString>,
        [<cReplaceHardCR>],
        [<cReplaceSoftCR>]) --> cNewString

 Arguments

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

     <cReplaceHardCR> is the character to replace a hard carriage
     return/linefeed pair with.  If not specified, the default value is a
     semicolon (;).

     <cReplaceSoftCR> is the character to replace a soft carriage
     return/linefeed pair with.  If not specified, the default value is a
     space.

 Returns

     MEMOTRAN() returns a copy of <cString> with the specified carriage
     return/linefeed pairs replaced.

 Description

     MEMOTRAN() is a memo function that converts a memo field or long
     character string containing hard and soft carriage return/linefeed
     characters into a form that can be displayed.  These two character
     combinations are end of line formatting indicators placed in the string
     by MEMOEDIT().  Soft carriage returns (CHR(141)) are inserted when a
     line longer than the width of the MEMOEDIT() window wraps.  Hard
     carriage returns (CHR(13)) are inserted when the user explicitly presses
     Return.

     MEMOTRAN() is particularly useful when displaying a memo field in a
     REPORT FORM which does not wrap when a soft carriage return is
     encountered.  MEMOTRAN() resolves this by converting soft carriage
     returns to spaces.  Note, however, that you must declare MEMOTRAN() as
     external using the REQUEST statement if it is used in a REPORT FORM and
     not specified anywhere else in the current program.

 Examples

     .  This example strips all end of line characters from a memo
        field:

        REPLACE Notes WITH MEMOTRAN(Notes)

 Files:  Library is EXTEND.LIB.

See Also: EXTERNAL* HARDCR() REPORT FORM REQUEST STRTRAN()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson