returns a modified document

Syntax

Arguments

• Document$ is a string expression containing a source document
• Search% is a string expression containing a search string which is to be replaced or marks a spot in Document$. Can be "NullString" to insert sentences (see remarks and examples).
• InsRepDoc$ is a string expression containing either a string or a document, replacing Search% (Pos% = 0)or to be inserted on a specific location indicated by Pos% and marked bySearch%
• Pos% is the position in Document$:

• Pos% = 0 is a search and replace;
• Pos% = 1 place immediately behind Search%
• Pos% = -1 place immediately before Search%
• Mode% = 0 or no value - case sensitive search operation
• Mode% = 1 - case insensitive search operation

• Mode% is an optional mode:

Remarks

1. REPLINS$ returns a document on which Remove and Insert operations are performed.
2. When Search% = "NullString", sentences will be inserted based on the position defined by Pos% (see examples)
3. Please look at the MARK$() function to replace parameters in a data set.
4. The use of REPLINS$() in combination with other string/text manipulation functions  will provide flexible means to process text data.

Examples

The document we use for all the examples below is: 

Replace lost with loosed:

 Pos% = 0

 Search% = "lost"

 InsRepDoc$ = "lost"

So: 

returns:

Add , and immediately behind loosed:

Pos% = 1

Search% = "loosed"

InsRepDoc$ = ", and"

 So: 

returns:

Add -dimmed immediately before  tide, including the space, so make sure to define " tide":

Pos% = -1

Search% = " tide"

InsRepDoc$ = ", -dimmed"

So: 

returns:

Add Mere anarchy is loosed upon the world after the first sentence:

Pos% = 1

Search% = "NullString"

InsRepDoc$ = "Mere anarchy is loosed upon the world"

So: 

returns:

Add Turning and turning in the widening gyre two lines before the first sentence:

Pos% = -2

Search% = "NullString"

InsRepDoc$ = "Turning and turning in the widening gyre" 

So: 

returns:

Add The falcon cannot hear the falconer; one line after the word widening:

 Pos% = 2: the insert will be done (Pos%-1) lines after the line with Search%

Search% = "widening"

InsRepDoc$ = "The falcon cannot hear the falconer;"

So: 

returns:

Add The Second Coming two lines before the word widening:

Pos% = -2: the insert will be done -2 lines before the line with Search%

Search% = "widening"

InsRepDoc$ = "The Second Coming"  

So: 

returns:

Quick links: Function overview | Attribute overview | Constants overview | Dimensions overview