Add BBE for Regex replace operations

examples/index.json

@@ -1218,8 +1218,15 @@
         "isLearnByExample": true
       },
       {
-        "name": "RegExp operations",
-        "url": "regexp-operations",
+        "name": "RegExp operations overview",
+        "url": "regexp_operations_overview",
+        "verifyBuild": true,
+        "verifyOutput": true,
+        "isLearnByExample": true
+      },
+      {
+        "name": "RegExp replace operations",
+        "url": "regexp-replace-operations",
         "verifyBuild": true,
         "verifyOutput": true,
         "isLearnByExample": true

examples/regexp-replace-operations/regexp_replace_operations.bal

@@ -0,0 +1,18 @@
+import ballerina/io;
+
+public function main() {
+    string creditCardNumber = "1234-5678-9876-5432";
+    string:RegExp pattern = re `\d{4}-\d{4}-\d{4}`;
+    // Replace the first occurrence of the credit card pattern with a masked representation.
+    string maskedCardNumber = pattern.replace(creditCardNumber, "****-****-****");
+    io:println(maskedCardNumber);
+
+    xml xmlString = 
+            xml `<root><!--comment 1 --><e1>value1</e1><e2>value2</e2><!--comment 2-->></root>`;
+
+    // Regular expression to match XML comments.
+    string:RegExp commentPattern = re `<!--.*?-->`;
+    // Replace all occurrences of XML comments with an empty string, effectively removing them.
+    string commentsRemovedXml = commentPattern.replaceAll(xmlString.toString(), "");
+    io:println("XML string with comments removed: ", commentsRemovedXml);
+}

examples/regexp-replace-operations/regexp_replace_operations.md

@@ -0,0 +1,12 @@
+# RegExp operations
+
+The `RegExp` type supports a set of langlib functions to replace parts of strings that match specific patterns.
+
+::: code regexp_replace_operations.bal :::
+
+::: out regexp_replace_operations.out :::
+
+## Related links
+- [RegExp type](/learn/by-example/regexp-type)
+- [RegExp API Docs](https://lib.ballerina.io/ballerina/lang.regexp)
+- [string API Docs](https://lib.ballerina.io/ballerina/lang.string)

examples/regexp-replace-operations/regexp_replace_operations.metatags

@@ -0,0 +1,2 @@
+description: This BBE demonstrates how to use the regexp langlib functions relevant to regex replace operations.
+keywords: ballerina, ballerina by example, bbe, regexp, RegExp, regex, regular expressions, ballerina regex functions, regexp langlib functions, replace, replaceAll

examples/regexp-replace-operations/regexp_replace_operations.out

@@ -0,0 +1,3 @@
+$ bal run regexp_replace_operations.bal
+****-****-****-5432
+XML string with comments removed: <root><e1>value1</e1><e2>value2</e2>&gt;</root>

examples/regexp-type/regexp_type.md

@@ -12,7 +12,6 @@ A `RegExp` value can be created by using the regexp template expression or calli
 
 ## Related links
 - [Ballerina regular expression grammar](https://ballerina.io/spec/lang/master/#section_10.1)
-- [RegExp langlib functions](/learn/by-example/regexp-operations)
-- [`regexp` langlib API Docs](https://lib.ballerina.io/ballerina/lang.regexp)
-- [`string` langlib API Docs](https://lib.ballerina.io/ballerina/lang.string)
-- [The `ensureType` function](/learn/by-example/ensureType-function/)
+- [RegExp langlib functions overview](/learn/by-example/regexp_operations_overview)
+- [RegExp API Docs](https://lib.ballerina.io/ballerina/lang.regexp)
+- [string API Docs](https://lib.ballerina.io/ballerina/lang.string)

examples/regexp-operations/regexp_operations.md → examples/regexp_operations_overview/regexp_operations_overview.md

@@ -2,9 +2,9 @@
 
 The ``RegExp`` type supports a set of langlib functions to search and manipulate string values.
 
-::: code regexp_operations.bal :::
+::: code regexp_operations_overview.bal :::
 
-::: out regexp_operations.out :::
+::: out regexp_operations_overview.out :::
 
 ## Related links
 - [RegExp type](/learn/by-example/regexp-type)

examples/regexp-operations/regexp_operations.out → examples/regexp_operations_overview/regexp_operations_overview.out

@@ -1,4 +1,4 @@
-$ bal run regexp_operations.bal
+$ bal run regexp_operations_overview.bal
 ["bob@example.net","alice@example.com","charlie@example.org","david@example.xyz","invalid#@example.n%t"]
 ["bob","alice","charlie","david"]
 ["example.net","example.com","example.org","example.xyz"]