---
name: "pcre2_set_newline"
section: "3"
platform: "linux"
package: "pcre2"
version: "10.49-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pcre2_set_newline"
---

# pcre2\_set\_newline(3)

Perl-compatible regular expressions (revised API)

## NAME

PCRE2 - Perl-compatible regular expressions (revised API)

## SYNOPSIS

**#include \<pcre2.h\>**

```
int pcre2_set_newline(pcre2_compile_context *ccontext,
  uint32_t value);
```

## DESCRIPTION

This function sets the newline convention within a compile context. This specifies which character(s) are recognized as newlines when compiling and matching patterns. The second argument must be one of:

  PCRE2\_NEWLINE\_CR        Carriage return only\
   PCRE2\_NEWLINE\_LF        Linefeed only\
   PCRE2\_NEWLINE\_CRLF      CR followed by LF only\
   PCRE2\_NEWLINE\_ANYCRLF   Any of the above\
   PCRE2\_NEWLINE\_ANY       Any Unicode newline sequence\
   PCRE2\_NEWLINE\_NUL       The NUL character (binary zero)

The result is zero for success or PCRE2\_ERROR\_BADDATA if the second argument is invalid.

There is a complete description of the PCRE2 native API in the **pcre2api** page and a description of the POSIX API in the **pcre2posix** page.