PatchLines (Stringlist function): Difference between revisions
m (1 revision) |
mNo edit summary |
||
| Line 13: | Line 13: | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th> | <tr><th>%updList</th> | ||
<td>A Stringlist object that reproduces the original updated file, that is, | <td>A <var>Stringlist</var> object that reproduces the original updated file, that is, <var class="term">baseList</var> updated by the <var class="term">sl</var> updates.</td></tr> | ||
<tr><th> | <tr><th>sl</th> | ||
<td>A Stringlist object that contains the patch file (one line per | <td>A <var>Stringlist</var> object that contains the patch file (one line per <var class="term">sl</var> item). </td></tr> | ||
<tr><th> | <tr><th>baseList</th> | ||
<td>A Stringlist object that contains the original base file, each line stored as a | <td>A <var>Stringlist</var> object that contains the original base file, each line stored as a <var class="term">baseList</var> item. </td></tr> | ||
<tr><th>Options | <tr><th>Options</th> | ||
<td> | <td>This optional argument (name required) is the string value <var>ErrRet</var>, which may be specified in uppercase or lowercase. If you specify <code>Options='ErrRet'</code>, Patch method errors return a null <var class="term">%updList</var> <var>Stringlist</var> and no error message instead of canceling the request. If you do not specify <code>Options='ErrRet'</code> and a method error occurs, you receive an error message and the run is cancelled.</td></tr> | ||
</table> | </table> | ||
[[Category:Stringlist methods|PatchLines function]] | [[Category:Stringlist methods|PatchLines function]] | ||
Revision as of 21:15, 16 January 2011
Apply patch Stringlist to a base Stringlist (Stringlist class)
This method uses Unix-style .diff output to update text lines that are stored in a Stringlist.
PatchLines applies a given patch file (converted to a Stringlist) to a base file (also a Stringlist), and it returns a Stringlist that is the base file updated by the differences contained in the patch file. PatchLines has the same functionality as the Patch (Stringlist function), but its syntax is slightly different: it reverses the method object and principal argument of Patch. In PatchLines, the patch file Stringlist is the method object and the base file Stringlist is the principal method argument; in Patch the base file Stringlist is the method object and the patch file Stringlist is a method argument. Both PatchLines and Patch support only a line-oriented patch. For usage notes and an example, see the Patch (Stringlist function) description. For working with character-oriented .diff output, use the PatchString (Stringlist function).
The PatchLines method is available as of Sirius Mods Version 7.2.
PatchLines is a member of the Stringlist class.
Syntax
%updList = sl:PatchLines( baseList, [Options= string])
Syntax terms
| %updList | A Stringlist object that reproduces the original updated file, that is, baseList updated by the sl updates. |
|---|---|
| sl | A Stringlist object that contains the patch file (one line per sl item). |
| baseList | A Stringlist object that contains the original base file, each line stored as a baseList item. |
| Options | This optional argument (name required) is the string value ErrRet, which may be specified in uppercase or lowercase. If you specify Options='ErrRet', Patch method errors return a null %updList Stringlist and no error message instead of canceling the request. If you do not specify Options='ErrRet' and a method error occurs, you receive an error message and the run is cancelled. |