</span>
</div>
<div id="navbar" class="navbar-collapse collapse">
<ul class="nav navbar-nav"><li>
<a href="../reference/index.html">Reference</a>
</li>
<li>
<a href="../news/index.html">Changelog</a>
</li>
</ul><ul class="nav navbar-nav navbar-right"></ul></div><!--/.nav-collapse -->
</div><!--/.container -->
</div><!--/.navbar -->
</header><div class="row">
<div class="col-md-9 contents">
<div class="page-header">
<h1>Replace first or last line in strings</h1>
<div class="hidden name"><code>str_line_replace.Rd</code></div>
</div>
<div class="ref-description">
<p>These functions serve to change the first or last line of strings which match a specific pattern (regex).
`str_firstLine_replace()` replaces the first line that matches the pattern.
`str_lastLine_replace()` replaces the last line that matches the pattern
They are useful, for example, when reading a text file with many lines and you want to preserve the lines of that text file.
When `which='all'`, it is a wrapper for `stringr::str_replace()`.</p>
<p>These functions serve to change the first or last line of strings which match a specific pattern (regex).
`str_firstLine_replace()` replaces the first line that matches the pattern.
`str_lastLine_replace()` replaces the last line that matches the pattern
They are useful, for example, when reading a text file with many lines and you want to preserve the lines of that text file.
When `which='all'`, it is a wrapper for `stringr::str_replace()`.</p>
</div>
<div id="ref-usage">
<div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">str_line_replace</span><span class="op">(</span></span>
<span> <span class="va">str</span>,</span>
<span> <span class="va">pattern</span>,</span>
<span> <span class="va">replacement</span>,</span>
<span> which <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">"first"</span>, <span class="st">"last"</span>, <span class="st">"poles"</span>, <span class="st">"all"</span><span class="op">)</span></span>
<span><span class="op">)</span></span>
<span></span>
<span><span class="fu">str_firstLine_replace</span><span class="op">(</span><span class="va">str</span>, <span class="va">pattern</span>, <span class="va">replacement</span><span class="op">)</span></span>
<span></span>
<span><span class="fu">str_lastLine_replace</span><span class="op">(</span><span class="va">str</span>, <span class="va">pattern</span>, <span class="va">replacement</span><span class="op">)</span></span>
<span></span>
<span><span class="fu">str_line_replace</span><span class="op">(</span></span>
<span> <span class="va">str</span>,</span>
<span> <span class="va">pattern</span>,</span>
<span> <span class="va">replacement</span>,</span>
<span> which <span class="op">=</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">"first"</span>, <span class="st">"last"</span>, <span class="st">"poles"</span>, <span class="st">"all"</span><span class="op">)</span></span>
<span><span class="op">)</span></span>
<span></span>
<span><span class="fu">str_firstLine_replace</span><span class="op">(</span><span class="va">str</span>, <span class="va">pattern</span>, <span class="va">replacement</span><span class="op">)</span></span>
<span></span>
<span><span class="fu">str_lastLine_replace</span><span class="op">(</span><span class="va">str</span>, <span class="va">pattern</span>, <span class="va">replacement</span><span class="op">)</span></span></code></pre></div>
</div>
<div id="arguments">
<h2>Arguments</h2>
<dl><dt>str</dt>
<dd><p>String with pattern to make replacement</p></dd>
<dt>pattern</dt>
<dd><p>Regular expression to replace</p></dd>
<dt>replacement</dt>
<dd><p>What to replace the pattern with</p></dd>
<dt>which</dt>
<dd><p>which one? first, last, all or the poles (first AND last)</p></dd>
</dl></div>
<div id="value">
<h2>Value</h2>
<p>string</p>
<p>string</p>
</div>
<div id="see-also">
<h2>See also</h2>
<div class="dont-index"><p>[stringr::str_replace()]</p>
<p>[stringr::str_replace()]</p></div>
</div>
<div id="ref-examples">
<h2>Examples</h2>
<div class="sourceCode"><pre class="sourceCode r"><code><span class="r-in"><span></span></span>
<span class="r-in"><span><span class="va">somelines</span> <span class="op"><-</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">'AAAAA'</span>, <span class="st">'textytext'</span>, <span class="st">'BBBBB'</span>, <span class="st">'AAAAA'</span>, <span class="st">'writingwriting'</span>, <span class="st">'AAAAA'</span>, <span class="st">'etc'</span>, <span class="st">'etc'</span>, <span class="st">'BBBBB'</span><span class="op">)</span></span></span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_firstLine_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedfirstline'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "changedfirstline" "textytext" "BBBBB" "AAAAA" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "AAAAA" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_lastLine_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedlastline'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "AAAAA" "textytext" "BBBBB" "AAAAA" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "changedlastline" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_line_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedpoles'</span>, which<span class="op">=</span><span class="st">'poles'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "changedpoles" "textytext" "BBBBB" "AAAAA" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "changedpoles" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_line_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedall'</span>, which<span class="op">=</span><span class="st">'all'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "changedall" "textytext" "BBBBB" "changedall" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "changedall" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="va">somelines</span> <span class="op"><-</span> <span class="fu"><a href="https://rdrr.io/r/base/c.html" class="external-link">c</a></span><span class="op">(</span><span class="st">'AAAAA'</span>, <span class="st">'textytext'</span>, <span class="st">'BBBBB'</span>, <span class="st">'AAAAA'</span>, <span class="st">'writingwriting'</span>, <span class="st">'AAAAA'</span>, <span class="st">'etc'</span>, <span class="st">'etc'</span>, <span class="st">'BBBBB'</span><span class="op">)</span></span></span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_firstLine_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedfirstline'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "changedfirstline" "textytext" "BBBBB" "AAAAA" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "AAAAA" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_lastLine_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedlastline'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "AAAAA" "textytext" "BBBBB" "AAAAA" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "changedlastline" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_line_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedpoles'</span>, which<span class="op">=</span><span class="st">'poles'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "changedpoles" "textytext" "BBBBB" "AAAAA" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "changedpoles" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
<span class="r-in"><span><span class="fu">str_line_replace</span><span class="op">(</span><span class="va">somelines</span>, <span class="st">'AAAAA'</span>, <span class="st">'changedall'</span>, which<span class="op">=</span><span class="st">'all'</span><span class="op">)</span></span></span>
<span class="r-out co"><span class="r-pr">#></span> [1] "changedall" "textytext" "BBBBB" "changedall" </span>
<span class="r-out co"><span class="r-pr">#></span> [5] "writingwriting" "changedall" "etc" "etc" </span>
<span class="r-out co"><span class="r-pr">#></span> [9] "BBBBB" </span>
<span class="r-in"><span></span></span>
</code></pre></div>
</div>
</div>
<div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
<nav id="toc" data-toggle="toc" class="sticky-top"><h2 data-toc-skip>Contents</h2>
</nav></div>
</div>
<footer><div class="copyright">
<p></p><p>Developed by Hugo Scherer.</p>
</div>
<div class="pkgdown">
<p></p><p>Site built with <a href="https://pkgdown.r-lib.org/" class="external-link">pkgdown</a> 2.0.7.</p>
</div>
</footer></div>
</body></html>