mc/source
0
0
Fork 0
mirror of https://github.com/MidnightCommander/source.git synced 2026-02-02 11:11:55 -08:00
Code Issues Packages Projects Releases Wiki Activity
Files
gh-pages
source/S/lib--strutil--replace.c.html
github-actions[bot] 08571174ab Deploy to GitHub Pages
2026-02-01 17:32:02 +00:00

145 lines
18 KiB
HTML
Raw Permalink Blame History

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>lib/strutil/replace.c</title>
<meta name='robots' content='noindex,nofollow' />
<meta name='generator' content='GLOBAL-6.6.11' />
<meta http-equiv='Content-Style-Type' content='text/css' />
<link rel='stylesheet' type='text/css' href='../style.css' />
</head>
<body>
<!-- beginning of fixed guide -->
<div id='guide'><ul>
<li><a href='#L60'><img class='icon' src='../icons/first.png' alt='[^]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/last.png' alt='[v]' /></a></li>
<li><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a></li>
<li><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a></li>
<li><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a></li>
<li class='standout'><span><a href='../files/lib.html'>lib</a>/<a href='../files/lib--strutil.html'>strutil</a>/replace.c</span></li>
</ul></div>
<!-- end of fixed guide -->
<div align='right'>Manual pages:
<a href=man/mc.html>mc</a> &bullet; <a href=man/mcdiff.html>mcdiff</a> &bullet; <a href=man/mcedit.html>mcedit</a> &bullet; <a href=man/mcview.html>mcview</a>
</div>
<a id='TOP' name='TOP'></a><h2 class='header'><a href='../mains.html'>root</a>/<a href='../files/lib.html'>lib</a>/<a href='../files/lib--strutil.html'>strutil</a>/replace.c</h2>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><a href='#L60'><img class='icon' src='../icons/first.png' alt='[first]' /></a><img class='icon' src='../icons/n_last.png' alt='[last]' /><img class='icon' src='../icons/n_top.png' alt='[top]' /><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+1 lib/strutil/replace.c' /> */</em>
<hr />
<h2 class='header'>DEFINITIONS</h2>
This source file includes following definitions.
<ol>
<li><a href='#L60' title='Defined at 60.'>str_replace_all</a></li>
</ol>
<hr />
<pre>
<a id='L1' name='L1'></a> 1 <em class='comment'>/*</em>
<a id='L2' name='L2'></a> 2 <em class='comment'> Functions for replacing substrings in strings.</em>
<a id='L3' name='L3'></a> 3 <em class='comment'></em>
<a id='L4' name='L4'></a> 4 <em class='comment'> Copyright (C) 2013-2025</em>
<a id='L5' name='L5'></a> 5 <em class='comment'> Free Software Foundation, Inc.</em>
<a id='L6' name='L6'></a> 6 <em class='comment'></em>
<a id='L7' name='L7'></a> 7 <em class='comment'> Written by:</em>
<a id='L8' name='L8'></a> 8 <em class='comment'> Slava Zanko &lt;slavazanko@gmail.com&gt;, 2013;</em>
<a id='L9' name='L9'></a> 9 <em class='comment'></em>
<a id='L10' name='L10'></a> 10 <em class='comment'> This file is part of the Midnight Commander.</em>
<a id='L11' name='L11'></a> 11 <em class='comment'></em>
<a id='L12' name='L12'></a> 12 <em class='comment'> The Midnight Commander is free software: you can redistribute it</em>
<a id='L13' name='L13'></a> 13 <em class='comment'> and/or modify it under the terms of the GNU General Public License as</em>
<a id='L14' name='L14'></a> 14 <em class='comment'> published by the Free Software Foundation, either version 3 of the License,</em>
<a id='L15' name='L15'></a> 15 <em class='comment'> or (at your option) any later version.</em>
<a id='L16' name='L16'></a> 16 <em class='comment'></em>
<a id='L17' name='L17'></a> 17 <em class='comment'> The Midnight Commander is distributed in the hope that it will be useful,</em>
<a id='L18' name='L18'></a> 18 <em class='comment'> but WITHOUT ANY WARRANTY; without even the implied warranty of</em>
<a id='L19' name='L19'></a> 19 <em class='comment'> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</em>
<a id='L20' name='L20'></a> 20 <em class='comment'> GNU General Public License for more details.</em>
<a id='L21' name='L21'></a> 21 <em class='comment'></em>
<a id='L22' name='L22'></a> 22 <em class='comment'> You should have received a copy of the GNU General Public License</em>
<a id='L23' name='L23'></a> 23 <em class='comment'> along with this program. If not, see &lt;https://www.gnu.org/licenses/&gt;.</em>
<a id='L24' name='L24'></a> 24 <em class='comment'> */</em>
<a id='L25' name='L25'></a> 25
<a id='L26' name='L26'></a> 26 <em class='sharp'>#include</em> &lt;config.h&gt;
<a id='L27' name='L27'></a> 27
<a id='L28' name='L28'></a> 28 <em class='sharp'>#include</em> "<a href='lib--global.h.html'>lib/global.h</a>"
<a id='L29' name='L29'></a> 29 <em class='sharp'>#include</em> "<a href='lib--strutil.h.html'>lib/strutil.h</a>"
<a id='L30' name='L30'></a> 30
<a id='L31' name='L31'></a> 31 <em class='comment'>/*** global variables ****************************************************************************/</em>
<a id='L32' name='L32'></a> 32
<a id='L33' name='L33'></a> 33 <em class='comment'>/*** file scope macro definitions ****************************************************************/</em>
<a id='L34' name='L34'></a> 34
<a id='L35' name='L35'></a> 35 <em class='comment'>/*** file scope type declarations ****************************************************************/</em>
<a id='L36' name='L36'></a> 36
<a id='L37' name='L37'></a> 37 <em class='comment'>/*** forward declarations (file scope functions) *************************************************/</em>
<a id='L38' name='L38'></a> 38
<a id='L39' name='L39'></a> 39 <em class='comment'>/*** file scope variables ************************************************************************/</em>
<a id='L40' name='L40'></a> 40
<a id='L41' name='L41'></a> 41 <em class='comment'>/* --------------------------------------------------------------------------------------------- */</em>
<a id='L42' name='L42'></a> 42 <em class='comment'>/*** file scope functions ************************************************************************/</em>
<a id='L43' name='L43'></a> 43 <em class='comment'>/* --------------------------------------------------------------------------------------------- */</em>
<a id='L44' name='L44'></a> 44
<a id='L45' name='L45'></a> 45 <em class='comment'>/* --------------------------------------------------------------------------------------------- */</em>
<a id='L46' name='L46'></a> 46 <em class='comment'>/*** public functions ****************************************************************************/</em>
<a id='L47' name='L47'></a> 47 <em class='comment'>/* --------------------------------------------------------------------------------------------- */</em>
<a id='L48' name='L48'></a> 48 <em class='comment'>/**</em>
<a id='L49' name='L49'></a> 49 <em class='comment'> * Replace all substrings 'needle' in string 'haystack' by 'replacement'.</em>
<a id='L50' name='L50'></a> 50 <em class='comment'> * If the 'needle' in the 'haystack' is escaped by backslash,</em>
<a id='L51' name='L51'></a> 51 <em class='comment'> * then this occurrence isn't be replaced.</em>
<a id='L52' name='L52'></a> 52 <em class='comment'> *</em>
<a id='L53' name='L53'></a> 53 <em class='comment'> * @param haystack string contains substrings for replacement. Cannot be NULL.</em>
<a id='L54' name='L54'></a> 54 <em class='comment'> * @param needle string for search. Cannot be NULL.</em>
<a id='L55' name='L55'></a> 55 <em class='comment'> * @param replacement string for replace. Cannot be NULL.</em>
<a id='L56' name='L56'></a> 56 <em class='comment'> * @return newly allocated string with replaced substrings or NULL if @haystack is empty.</em>
<a id='L57' name='L57'></a> 57 <em class='comment'> */</em>
<a id='L58' name='L58'></a> 58
<a id='L59' name='L59'></a> 59 <strong class='reserved'>char</strong> *
<a id='L60' name='L60'></a> 60 <a href='../R/str_replace_all.html' title='Multiple referred from 8 places.'>str_replace_all</a> (<strong class='reserved'>const</strong> <strong class='reserved'>char</strong> *<a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>, <strong class='reserved'>const</strong> <strong class='reserved'>char</strong> *<a href='../Y/needle.html' title='Multiple used in 38 places.'>needle</a>, <strong class='reserved'>const</strong> <strong class='reserved'>char</strong> *<a href='../Y/replacement.html' title='Multiple used in 6 places.'>replacement</a>)
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+60 lib/strutil/replace.c' /> */</em>
<a id='L61' name='L61'></a> 61 <em class='brace'>{</em>
<a id='L62' name='L62'></a> 62 <a href='../Y/size_t.html' title='Multiple used in 711 places.'>size_t</a> <a href='../Y/needle_len.html' title='Multiple used in 3 places.'>needle_len</a>, <a href='../Y/replacement_len.html' title='Multiple used in 3 places.'>replacement_len</a>;
<a id='L63' name='L63'></a> 63 <a href='../Y/GString.html' title='Multiple used in 317 places.'>GString</a> *<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a> = <a href='../Y/NULL.html' title='Multiple used in 5498 places.'>NULL</a>;
<a id='L64' name='L64'></a> 64 <strong class='reserved'>char</strong> *<a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a>;
<a id='L65' name='L65'></a> 65
<a id='L66' name='L66'></a> 66 <a href='../Y/needle_len.html' title='Multiple used in 3 places.'>needle_len</a> = <a href='../Y/strlen.html' title='Multiple used in 193 places.'>strlen</a> (<a href='../Y/needle.html' title='Multiple used in 38 places.'>needle</a>);
<a id='L67' name='L67'></a> 67 <a href='../Y/replacement_len.html' title='Multiple used in 3 places.'>replacement_len</a> = <a href='../Y/strlen.html' title='Multiple used in 193 places.'>strlen</a> (<a href='../Y/replacement.html' title='Multiple used in 6 places.'>replacement</a>);
<a id='L68' name='L68'></a> 68
<a id='L69' name='L69'></a> 69 <strong class='reserved'>while</strong> ((<a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a> = <a href='../Y/strstr.html' title='Multiple used in 49 places.'>strstr</a> (<a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>, <a href='../Y/needle.html' title='Multiple used in 38 places.'>needle</a>)) != <a href='../Y/NULL.html' title='Multiple used in 5498 places.'>NULL</a>)
<a id='L70' name='L70'></a> 70 <em class='brace'>{</em>
<a id='L71' name='L71'></a> 71 <strong class='reserved'>if</strong> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a> == <a href='../Y/NULL.html' title='Multiple used in 5498 places.'>NULL</a>)
<a id='L72' name='L72'></a> 72 <a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a> = <a href='../Y/g_string_sized_new.html' title='Multiple used in 62 places.'>g_string_sized_new</a> (32);
<a id='L73' name='L73'></a> 73
<a id='L74' name='L74'></a> 74 <strong class='reserved'>if</strong> (<a href='../S/lib--strutil--strescape.c.html#L247' title='Defined at 247 in lib/strutil/strescape.c.'>str_is_char_escaped</a> (<a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>, <a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a>))
<a id='L75' name='L75'></a> 75 <em class='brace'>{</em>
<a id='L76' name='L76'></a> 76 <strong class='reserved'>char</strong> *<a href='../Y/backslash.html' title='Multiple used in 4 places.'>backslash</a> = <a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a> - 1;
<a id='L77' name='L77'></a> 77
<a id='L78' name='L78'></a> 78 <strong class='reserved'>if</strong> (<a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a> != <a href='../Y/backslash.html' title='Multiple used in 4 places.'>backslash</a>)
<a id='L79' name='L79'></a> 79 <a href='../Y/g_string_append_len.html' title='Multiple used in 41 places.'>g_string_append_len</a> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a>, <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>, <a href='../Y/backslash.html' title='Multiple used in 4 places.'>backslash</a> - <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>);
<a id='L80' name='L80'></a> 80 <a href='../Y/g_string_append_len.html' title='Multiple used in 41 places.'>g_string_append_len</a> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a>, <a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a>, <a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a> - <a href='../Y/backslash.html' title='Multiple used in 4 places.'>backslash</a>);
<a id='L81' name='L81'></a> 81 <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a> = <a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a> + 1;
<a id='L82' name='L82'></a> 82 <em class='brace'>}</em>
<a id='L83' name='L83'></a> 83 <strong class='reserved'>else</strong>
<a id='L84' name='L84'></a> 84 <em class='brace'>{</em>
<a id='L85' name='L85'></a> 85 <strong class='reserved'>if</strong> (<a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a> != <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>)
<a id='L86' name='L86'></a> 86 <a href='../Y/g_string_append_len.html' title='Multiple used in 41 places.'>g_string_append_len</a> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a>, <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>, <a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a> - <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>);
<a id='L87' name='L87'></a> 87 <a href='../Y/g_string_append_len.html' title='Multiple used in 41 places.'>g_string_append_len</a> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a>, <a href='../Y/replacement.html' title='Multiple used in 6 places.'>replacement</a>, <a href='../Y/replacement_len.html' title='Multiple used in 3 places.'>replacement_len</a>);
<a id='L88' name='L88'></a> 88 <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a> = <a href='../Y/needle_in_str.html' title='Multiple used in 9 places.'>needle_in_str</a> + <a href='../Y/needle_len.html' title='Multiple used in 3 places.'>needle_len</a>;
<a id='L89' name='L89'></a> 89 <em class='brace'>}</em>
<a id='L90' name='L90'></a> 90 <em class='brace'>}</em>
<a id='L91' name='L91'></a> 91
<a id='L92' name='L92'></a> 92 <strong class='reserved'>if</strong> (*<a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a> != '\0')
<a id='L93' name='L93'></a> 93 <em class='brace'>{</em>
<a id='L94' name='L94'></a> 94 <strong class='reserved'>if</strong> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a> == <a href='../Y/NULL.html' title='Multiple used in 5498 places.'>NULL</a>)
<a id='L95' name='L95'></a> 95 <strong class='reserved'>return</strong> <a href='../Y/g_strdup.html' title='Multiple used in 402 places.'>g_strdup</a> (<a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>);
<a id='L96' name='L96'></a> 96
<a id='L97' name='L97'></a> 97 <a href='../Y/g_string_append.html' title='Multiple used in 100 places.'>g_string_append</a> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a>, <a href='../Y/haystack.html' title='Multiple used in 27 places.'>haystack</a>);
<a id='L98' name='L98'></a> 98 <em class='brace'>}</em>
<a id='L99' name='L99'></a> 99
<a id='L100' name='L100'></a> 100 <strong class='reserved'>return</strong> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a> != <a href='../Y/NULL.html' title='Multiple used in 5498 places.'>NULL</a> ? <a href='../Y/g_string_free.html' title='Multiple used in 189 places.'>g_string_free</a> (<a href='../Y/return_str.html' title='Multiple used in 15 places.'>return_str</a>, <a href='../Y/FALSE.html' title='Multiple used in 1723 places.'>FALSE</a>) : <a href='../Y/NULL.html' title='Multiple used in 5498 places.'>NULL</a>);
<a id='L101' name='L101'></a> 101 <em class='brace'>}</em>
<a id='L102' name='L102'></a> 102
<a id='L103' name='L103'></a> 103 <em class='comment'>/* --------------------------------------------------------------------------------------------- */</em>
</pre>
<hr />
<a id='BOTTOM' name='BOTTOM'></a>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><a href='#L60'><img class='icon' src='../icons/last.png' alt='[last]' /></a><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a><img class='icon' src='../icons/n_bottom.png' alt='[bottom]' /><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+103 lib/strutil/replace.c' /> */</em>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink