1. Home
2. Reference documentation
3. VCL Reference
4. Functions
5. Strings

regsub

Available inall subroutines.

Replaces the first occurrence of pattern, which is a Perl-compatible regular expression, in input with replacement. If no match is found, no replacement is made. Calls to regsub do not set re.group.*.

This function may fail to make a replacement if the regular expression recurses too heavily. Such a situation may occur with lookahead and lookbehind assertions, or other recursing non-regular expressions. In this case, fastly.error is set to EREGRECUR.

This function is not prefixed with the std. namespace.

Errors

This function may fail to make a replacement if the regular expression recurses too heavily. Such a situation may occur with lookahead and lookbehind assertions, or other recursing non-regular expressions. In this case, fastly.error is set to EREGRECUR.

Example

The following example deletes any query string parameters.

set req.url = regsub(req.url, "\?.*$", "");

Try it out

regsub is used in the following code examples. Examples apply VCL to real-world use cases and can be deployed as they are, or adapted for your own service. See the full list of code examples for more inspiration.

Click RUN on a sample below to provision a Fastly service, execute the code on Fastly, and see how the function behaves.