Deprecation Notice: This library is deprecated and will no longer be maintained or updated. Instead, it is recommended to use the ballerina/lang.regexp library for continued support and updates. For more information, see the new RegExp type example, RegExp operations example, and Regular expressions feature guide.

This module provides APIs for searching, splitting, and replacing the set of characters of a string. These APIs are using a regular expression as a String to perform these operations by finding the string matches.

Regular expressions, are notations for describing sets of character strings. If a particular string is in the set described by a regular expression, the regular expression matches that string.

For a quick sample on demonstrating the usage, see Ballerina By Examples.

The Issues and Projects tabs are disabled for this repository as this is part of the Ballerina Standard Library. To report bugs, request new features, start new discussions, view project boards, etc., go to the Ballerina Standard Library parent repository.

This repository contains only the source code of the package.

• Download and install Java SE Development Kit (JDK) version 21 (from one of the following locations).

  • Oracle

  • OpenJDK

    Note: Set the JAVA_HOME environment variable to the path name of the directory into which you installed JDK.

Execute the commands below to build from the source.

1. To build the library:

    ./gradlew clean build
   

2. To run the integration tests:

    ./gradlew clean test
   

3. To build the package without the tests:

    ./gradlew clean build -x test
   

4. To debug the tests:

    ./gradlew clean build -Pdebug=<port>
   

5. To debug the package with Ballerina language:

    ./gradlew clean build -PbalJavaDebug=<port>
   

6. Publish ZIP artifact to the local .m2 repository:

    ./gradlew clean build publishToMavenLocal
   

7. Publish the generated artifacts to the local Ballerina central repository:

    ./gradlew clean build -PpublishToLocalCentral=true
   

8. Publish the generated artifacts to the Ballerina central repository:

    ./gradlew clean build -PpublishToCentral=true
   

As an open source project, Ballerina welcomes contributions from the community.

For more information, go to the contribution guidelines.

All contributors are encouraged to read the Ballerina Code of Conduct.

• For more information go to the regex library.
• For example demonstrations of the usage, go to Ballerina By Examples.
• Chat live with us on our Discord server.
• Technical questions should be posted on Stack Overflow with the #ballerina tag.