PCRE2_SET_NEWLINE(3)

🌸 NAME 🌸

PCRE2 — Perl-compatible regular expressions (revised API). This page is PCRE2_SET_NEWLINE(3) from the Library Functions Manual, and it's your little guide to telling PCRE2 what counts as a newline. Periodt. 💅

✨ SYNOPSIS ✨

Okay bestie, here's the exact spell:

#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. Lowkey important: it tells PCRE2 which character(s) count as newlines when it compiles and matches patterns. It's giving “choose your newline destiny,” and honestly? Obsessed. 🌈

The second argument value must be one of these iconic options, no cap:

• 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. So yeah, bad value = instant vibe check fail, but at least the error code tells you what's up. 🫶

There's a complete description of the PCRE2 native API in the pcre2api page, and a description of the POSIX API in the pcre2posix page. Go read those if you want the full lore, iykyk. 📚

---

Signed, sealed, and sent with sparkles by PCRE2 10.47, dated 19 July 2017. That's the PCRE2_SET_NEWLINE(3) page, bestie — now go set some newlines! 🧚💖