/usr/share/doc/ne/html/Replace.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>ne&rsquo;s manual: Replace</title>

<meta name="description" content="ne&rsquo;s manual: Replace">
<meta name="keywords" content="ne&rsquo;s manual: Replace">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="Command-Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Search-Commands.html#Search-Commands" rel="up" title="Search Commands">
<link href="ReplaceOnce.html#ReplaceOnce" rel="next" title="ReplaceOnce">
<link href="FindRegExp.html#FindRegExp" rel="prev" title="FindRegExp">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Replace"></a>
<div class="header">
<p>
Next: <a href="ReplaceOnce.html#ReplaceOnce" accesskey="n" rel="next">ReplaceOnce</a>, Previous: <a href="FindRegExp.html#FindRegExp" accesskey="p" rel="prev">FindRegExp</a>, Up: <a href="Search-Commands.html#Search-Commands" accesskey="u" rel="up">Search Commands</a> &nbsp; [<a href="Command-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Replace-1"></a>
<h4 class="subsection">4.5.3 Replace</h4>
<a name="index-Replace"></a>

<p>Syntax: <code>Replace [<var>string</var>]</code><br>
Abbreviation: <code>R</code>
</p>
<p>moves to the first match of the most recent find string or regular
expression and prompts you for which action to perform. You can choose among:
</p>
<ul>
<li> replacing the string found with the given string and moving to the next match
(&lsquo;<samp>Yes</samp>&rsquo;);

</li><li> moving to the next match (&lsquo;<samp>No</samp>&rsquo;);

</li><li> replacing the string found with the given string, and stopping the search (&lsquo;<samp>Last</samp>&rsquo;);

</li><li> stopping the search immediately (&lsquo;<samp>Quit</samp>&rsquo;);

</li><li> replacing <em>all</em> occurrences of the find string with the given string
(&lsquo;<samp>All</samp>&rsquo;);

</li><li> reversing the search direction (&lsquo;<samp>Backward</samp>&rsquo; or &lsquo;<samp>Forward</samp>&rsquo;);
this choice will also modify the value of the back search flag.
See <a href="SearchBack.html#SearchBack">SearchBack</a>.

</li></ul>

<p><code>Replace</code> is mainly useful for interactive editing. <code>ReplaceOnce</code>,
<code>ReplaceAll</code> and <code>RepeatLast</code> are more suited to macros.
</p>
<p>If no find string was ever specified, you can enter it on the input line.
If the optional argument <var>string</var> is not specified, you can enter it on
the input line, the default being the last string used. When the last search
was a regular expression search, there are some special
features you can use in the replace string
(see <a href="Regular-Expressions.html#Regular-Expressions">Regular Expressions</a>)
. See <a href="FindRegExp.html#FindRegExp">FindRegExp</a>.
</p>
<p>Note that normally a search starts just one character after the cursor.
However, when <code>Replace</code> is invoked, the search starts at the character
just <em>under</em> the cursor, so that you can safely <code>Find</code> a pattern
and <code>Replace</code> it without having to move back.
</p>
<p><strong>Warning:</strong> when recording a macro with <a href="Record.html#Record">Record</a>, there
is no trace in the macro of your interaction with <code>ne</code> during the
replacement process. When the macro is played, you will again have to choose
which actions to perform. If you want to apply automatic replacement of
strings for a certain number of times, you should look at <a href="ReplaceOnce.html#ReplaceOnce">ReplaceOnce</a>,
<a href="ReplaceAll.html#ReplaceAll">ReplaceAll</a>, and <a href="RepeatLast.html#RepeatLast">RepeatLast</a>.
</p>


<hr>
<div class="header">
<p>
Next: <a href="ReplaceOnce.html#ReplaceOnce" accesskey="n" rel="next">ReplaceOnce</a>, Previous: <a href="FindRegExp.html#FindRegExp" accesskey="p" rel="prev">FindRegExp</a>, Up: <a href="Search-Commands.html#Search-Commands" accesskey="u" rel="up">Search Commands</a> &nbsp; [<a href="Command-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
ne-doc 3.0.1-2build1 / usr / share / doc / ne / html / Replace.html
