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:

So: 

returns:

Add , and immediately behind loosed:

So: 

returns:

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

So: 

returns:

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

So: 

returns:

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

So: 

returns:

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

So: 

returns:

Add The Second Coming two lines before the word widening:

So: 

returns:

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