$SubIns: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
(Automatically generated page update)
 
(33 intermediate revisions by 4 users not shown)
Line 2: Line 2:
<span class="pageSubtitle">Insert string inside another string</span>
<span class="pageSubtitle">Insert string inside another string</span>


<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $SubIns function is the [[Insert (String function)]].</p>
<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $SubIns function is <var>[[Insert (String function)|Insert]]</var>.</p>


This function inserts a string inside another.  
This function inserts a string inside another.  
Line 8: Line 8:
The <var>$SubIns</var> function accepts three arguments and returns a string result.  
The <var>$SubIns</var> function accepts three arguments and returns a string result.  


The first argument is an arbitrary string.  
==Syntax==
<p class="syntax"><span class="term">%string</span> = <span class="literal">$SubIns</span>(<span class="term">string</span>, <span class="term">ins_string</span>, <span class="term">insert_pos</span>)
</p>
 
===Syntax terms===
<table>
<tr><th>%string</th>
<td>The string result that is a combination of <var class="term">string</var> and <var class="term">ins_string</var>.</td></tr>


The second argument is another arbitrary string.  
<tr><th>string</th>
<td>An arbitrary string. </td></tr>


The third argument is an insertion position in the first argument string.
<tr><th>ins_string</th>
<td>A string to be inserted in the <var class="term">string</var> value. </td></tr>


==Syntax==
<tr><th>insert_pos</th>
<p class="syntax"><section begin="syntax" /> %STRING = $SubIns(string, ins_string, insert_pos)
<td>The insertion position in the <var class="term">string</var> argument string.</td></tr>
<section end="syntax" /></p>
</table>
<p class="caption">$SubIns Function
</p>
<p class="caption">%STRING is a string made up of '''string''' and '''ins_string'''.</p>


If no insertion position is provided, the insertion string is appended to the end of the first input string. If the insertion point is past the first input string, the first input string is left unmodified.  
==Usage notes==
<ul>
<li>If no insertion position is provided, the insertion string is appended to the end of the first input string. If the insertion point is past the first input string, the first input string is left unmodified.  
</ul>


For example, this statement sets %JUNK to <tt>PAT STAMPER, TRADER HORSE</tt>:
==Examples==
<ol>
<li>This statement sets %JUNK to <code>PAT STAMPER, TRADER HORSE</code>:


<p class="code"> %JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE')
<p class="code">%JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE')
</p>
</p></li>


This statement sets %JUNK to <tt>PAT STAMPER, HORSE TRADER</tt>:
<li>This statement sets %JUNK to <code>PAT STAMPER, HORSE TRADER</code>:


<p class="code"> %JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE', 12)
<p class="code">%JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE', 12)
</p>
</p></li>


This statement sets %JUNK to <tt>PAT STAMPER, TRADER</tt>:
<li>This statement sets %JUNK to <code>PAT STAMPER, TRADER</code>:


<p class="code"> %JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE', 92)
<p class="code">%JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE', 92)
</p>
</p></li>
</ol>


==Products authorizing {{PAGENAMEE}}==
<ul class="smallAndTightList">
<ul class="smallAndTightList">
<li>[[Sirius functions]]</li>
<li>[[List of $functions|Sirius functions]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[[Fast/Unload User Language Interface]]</li>
<li>[[Janus Open Client]]</li>
<li>[[Media:JoclrNew.pdf|Janus Open Client]]</li>
<li>[[Janus Open Server]]</li>
<li>[[Media:JosrvrNew.pdf|Janus Open Server]]</li>
<li>[[Janus Sockets]]</li>
<li>[[Janus Sockets]]</li>
<li>[[Janus Web Server]]</li>
<li>[[Janus Web Server]]</li>
<li>[[Japanese functions]]</li>
<li>Japanese functions</li>
<li>[[Sir2000 Field Migration Facility]]</li>
<li>[[Media:SirfieldNew.pdf|Sir2000 Field Migration Facility]]</li>
</ul>
</ul>
<p class="caption">Products authorizing $SubIns
 
</p>


[[Category:$Functions|$SubIns]]
[[Category:$Functions|$SubIns]]

Latest revision as of 23:29, 20 September 2018

Insert string inside another string

Note: Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the $SubIns function is Insert.

This function inserts a string inside another.

The $SubIns function accepts three arguments and returns a string result.

Syntax

%string = $SubIns(string, ins_string, insert_pos)

Syntax terms

%string The string result that is a combination of string and ins_string.
string An arbitrary string.
ins_string A string to be inserted in the string value.
insert_pos The insertion position in the string argument string.

Usage notes

  • If no insertion position is provided, the insertion string is appended to the end of the first input string. If the insertion point is past the first input string, the first input string is left unmodified.

Examples

  1. This statement sets %JUNK to PAT STAMPER, TRADER HORSE:

    %JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE')

  2. This statement sets %JUNK to PAT STAMPER, HORSE TRADER:

    %JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE', 12)

  3. This statement sets %JUNK to PAT STAMPER, TRADER:

    %JUNK = $SubIns('PAT STAMPER, TRADER', ' HORSE', 92)

Products authorizing $SubIns