| Server IP : 121.121.20.254 / Your IP : 216.73.217.141 Web Server : Microsoft-IIS/10.0 System : Windows NT WEB-SERVER 10.0 build 20348 (Windows Server 2022) AMD64 User : IUSR ( 0) PHP Version : 8.3.28 Disable Function : NONE MySQL : ON | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/Program Files/LibreOffice/help/en-US/text/scalc/01/ |
Upload File : |
<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<base href="../../../../">
<noscript><meta http-equiv="refresh" content="0; URL=../../../../en-US/noscript.html"></noscript>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>REGEX Function</title>
<link rel="shortcut icon" href="media/navigation/favicon.ico">
<link type="text/css" href="normalize.css" rel="Stylesheet">
<link type="text/css" href="prism.css" rel="Stylesheet">
<link type="text/css" href="default.css" rel="Stylesheet">
<script type="text/javascript" src="polyfills.js"></script><script type="text/javascript" src="languages.js"></script><script type="text/javascript" src="en-US/langnames.js"></script><script type="text/javascript" src="flexsearch.debug.js"></script><script type="text/javascript" src="prism.js"></script><script type="text/javascript" src="help2.js" defer></script><script type="text/javascript" src="a11y-toggle.js" defer></script><script type="text/javascript" src="paginathing.js" defer></script><script type="text/javascript" src="en-US/bookmarks.js" defer></script><script type="text/javascript" src="en-US/contents.js" defer></script><script type="text/javascript" src="help.js" defer></script><meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body>
<header id="TopLeftHeader"><a class="symbol" href="en-US/text/shared/05/new_help.html"><div></div></a><a class="logo" href="en-US/text/shared/05/new_help.html"><p dir="auto">LibreOffice 24.2 Help</p></a><div class="dropdowns"><div class="modules">
<button type="button" data-a11y-toggle="modules-nav" id="modules" aria-haspopup="true" aria-expanded="false" aria-controls="modules-nav">Module</button><nav id="modules-nav" hidden=""></nav>
</div></div></header><aside class="leftside"><input id="accordion-1" name="accordion-menu" type="checkbox"><label for="accordion-1" dir="auto">Contents</label><div id="Contents" class="contents-treeview"></div></aside><div id="SearchFrame"><div id="Bookmarks">
<input id="search-bar" type="search" class="search" placeholder="Search in bookmarks for chosen module" dir="auto"><div class="nav-container" tabindex="0"><nav class="index" dir="auto"></nav></div>
</div></div>
<div id="DisplayArea" itemprop="softwareHelp" itemscope="true" itemtype="http://schema.org/SoftwareApplication">
<a name="func_regex"></a>
<a name="bm_id61542230672099"></a>
<a name="bm_id831542233029549"></a>
<meta itemprop="keywords" content="REGEX function">
<meta itemprop="keywords" content="regular expressions,extracting in spreadsheets">
<meta itemprop="keywords" content="regular expressions,REGEX function">
<h1 id="hd_id961542230672100" dir="auto">REGEX</h1>
<p id="par_id541542230672101" class="paragraph" dir="auto"><a name="func_regex_desc"></a><span class="avis">Matches and extracts or optionally replaces text using regular expressions.</span></p>
<div class="embedded">
<a name="func_head_syntax"></a>
<h3 id="hd_id126511265112651" dir="auto">Syntax</h3>
</div>
<p id="par_id701542231253817" class="code" dir="auto">REGEX( Text ; Expression [ ; [ Replacement ] [ ; Flags|Occurrence ] ] )</p>
<p id="par_id621542232197446" class="paragraph" dir="auto"><span class="emph">Text</span>: A text or reference to a cell where the regular expression is to be applied.</p>
<p id="par_id211542232209275" class="paragraph" dir="auto"><span class="emph">Expression</span>: A text representing the regular expression, using <a target="_blank" href="https://unicode-org.github.io/icu/userguide/strings/regexp.html#regular-expression-metacharacters">ICU regular expressions</a>. If there is no match and <span class="emph">Replacement</span> is not given, #N/A is returned.</p>
<p id="par_id581542232755604" class="paragraph" dir="auto"><span class="emph">Replacement</span>: Optional. The replacement text and references to capture groups. If there is no match, <span class="emph">Text</span> is returned unmodified.</p>
<p id="par_id421542232246840" class="paragraph" dir="auto"><span class="emph">Flags</span>: Optional. "g" replaces all matches of <span class="emph">Expression</span> in <span class="emph">Text</span>, not extracted. If there is no match, <span class="emph">Text</span> is returned unmodified.</p>
<p id="par_id421542232246841" class="paragraph" dir="auto"><span class="emph">Occurrence</span>: Optional. Number to indicate which match of <span class="emph">Expression</span> in <span class="emph">Text</span> is to be extracted or replaced. If there is no match and <span class="emph">Replacement</span> is not given, #N/A is returned. If there is no match and <span class="emph">Replacement</span> is given, <span class="emph">Text</span> is returned unmodified. If <span class="emph">Occurrence</span> is 0, <span class="emph">Text</span> is returned unmodified.</p>
<div class="embedded">
<a name="func_head_example"></a>
<h3 id="hd_id980889808898088" dir="auto">Examples</h3>
</div>
<p id="par_id371542291684176" class="paragraph" dir="auto"><span class="input" data-tooltip="Click on text to copy to clipboard">=REGEX("123456ABCDEF";"[:digit:]";"Z")</span> returns "Z23456ABCDEF", where the first match of a digit is replaced by "Z".</p>
<p id="par_id891542291697194" class="paragraph" dir="auto"><span class="input" data-tooltip="Click on text to copy to clipboard">=REGEX("123456ABCDEF";"[:digit:]";"Z";"g")</span> returns "ZZZZZZABCDEF", where all digits were replaced by "Z".</p>
<p id="par_id21542291705695" class="paragraph" dir="auto"><span class="input" data-tooltip="Click on text to copy to clipboard">=REGEX("123456ABCDEF";"[126]";"";"g")</span> returns "345ABCDEF", where any occurrence of "1", "2" or "6" is replaced by the empty string, thus deleted. </p>
<p id="par_id371542291684177" class="paragraph" dir="auto"><span class="input" data-tooltip="Click on text to copy to clipboard">=REGEX("axbxcxd";".x";;2)</span> returns "bx", the second match of ".x".</p>
<p id="par_id371542291684178" class="paragraph" dir="auto"><span class="input" data-tooltip="Click on text to copy to clipboard">=REGEX("axbxcxd";"(.)x";"$1y";2)</span> returns "axbycxd", the second match of "(.)x" (i.e. "bx") replaced with the captured group of one character (i.e. "b") followed by "y".</p>
<div class="embedded">
<a name="sectiontechinfo"></a>
<h4 id="hd_id301640873452726" dir="auto">Technical information</h4>
</div>
<div class="embedded">
<a name="6.2"></a>
<div class="tip">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/tip.svg" alt="tip" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id651551401041662" dir="auto">This function is available since LibreOffice 6.2.</p></div>
</div>
<br>
</div>
<div class="embedded">
<a name="notODFF"></a>
<p id="par_id251640873774457" class="paragraph" dir="auto">This function is not part of the <span class="emph">Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format</span> standard. The name space is</p>
</div>
<p id="par_id311640873986703" class="paragraph" dir="auto"><span class="literal">ORG.LIBREOFFICE.REGEX</span></p>
<a name="relatedtopics"></a><div class="relatedtopics">
<p class="related" itemprop="mentions" dir="auto"><a name="related"></a><span class="emph">Related Topics</span>
</p>
<div class="relatedbody" itemprop="mentions">
<div class="tip">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/tip.svg" alt="tip" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id631677014948784" dir="auto"><a target="_blank" href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/REGEX">REGEX wiki page</a>.</p></div>
</div>
<br>
<p id="par_id711542233602553" class="paragraph" dir="auto"><a target="_top" href="en-US/text/shared/01/02100001.html">List of regular expressions</a></p>
<p id="par_id431542233650614" class="paragraph" dir="auto"><a target="_blank" href="https://unicode-org.github.io/icu/userguide/strings/regexp.html">ICU regular expressions</a></p>
</div>
</div>
</div>
<div id="DonationFrame"></div>
<footer><div id="DEBUG" class="debug">
<h3 class="bug">Help content debug info:</h3>
<p dir="auto">This page is: <a href="https://opengrok.libreoffice.org/xref/help/source/text/scalc/01/func_regex.xhp" target="_blank">/text/scalc/01/func_regex.xhp</a></p>
<p dir="auto">Title is: REGEX Function</p>
<p id="bm_module" dir="auto"></p>
<p id="bm_system" dir="auto"></p>
<p id="bm_HID" dir="auto"></p>
</div></footer>
</body>
</html>