# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2024-06-01 06:15+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "regex" msgstr "" #. type: TH #: archlinux debian-unstable opensuse-tumbleweed #, no-wrap msgid "2024-05-02" msgstr "" #. type: TH #: archlinux debian-unstable #, no-wrap msgid "Linux man-pages 6.8" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "regcomp, regexec, regerror, regfree - POSIX regex functions" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "LIBRARY" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Standard C library (I, I<-lc>)" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B<#include Eregex.hE>\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "BIB<, const char *restrict >IB<,>\n" "B< int >IB<);>\n" "BIB<, const char *restrict >IB<,>\n" "B< size_t >IB<, regmatch_t >IB<[_Nullable restrict .>IB<],>\n" "B< int >IB<);>\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "BIB<, const regex_t *_Nullable restrict >IB<,>\n" "B< char >IB<[_Nullable restrict .>IB<],>\n" "B< size_t >IB<);>\n" "BIB<);>\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "B\n" "B\n" "B<} regex_t;>\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "B\n" "B\n" "B\n" "B<} regmatch_t;>\n" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "B /* ... */ B\n" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "Compilation" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B() is used to compile a regular expression into a form that is " "suitable for subsequent B() searches." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "On success, the pattern buffer at I<*preg> is initialized. I is a " "null-terminated string. The locale must be the same when running " "B()." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "After B() succeeds, Ire_nsub> holds the number of " "subexpressions in I. Thus, a value of Ire_nsub> + 1 " "passed as I to B() is sufficient to capture all matches." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "I is the bitwise OR of zero or more of the following:" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Use POSIX Extended Regular Expression syntax when interpreting I. If " "not set, POSIX Basic Regular Expression syntax is used." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Do not differentiate case. Subsequent B() searches using this " "pattern buffer will be case insensitive." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Report only overall success. B() will use only I for " "B, ignoring I." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Match-any-character operators don't match a newline." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "A nonmatching list (B<[\\[ha]...\\&]>) not containing a newline does not " "match a newline." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Match-beginning-of-line operator (B<\\[ha]>) matches the empty string " "immediately after a newline, regardless of whether I, the execution " "flags of B(), contains B." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Match-end-of-line operator (B<$>) matches the empty string immediately " "before a newline, regardless of whether I contains B." msgstr "" #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "Matching" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "B() is used to match a null-terminated string against the compiled " "pattern buffer in I<*preg>, which must have been initialised with " "B(). I is the bitwise OR of zero or more of the following " "flags:" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The match-beginning-of-line operator always fails to match (but see the " "compilation flag B above). This flag may be used when " "different portions of a string are passed to B() and the beginning " "of the string should not be interpreted as the beginning of the line." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The match-end-of-line operator always fails to match (but see the " "compilation flag B above)." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Match [I,I< string + pmatch[0].rm_eo>) instead of " "[I,I< string + strlen(string)>). This allows matching embedded NUL " "bytes and avoids a B(3) on known-length strings. If any matches " "are returned (B wasn't passed to B(), the match " "succeeded, and I E 0), they overwrite I as usual, and " "the match offsets remain relative to I (not I). This flag is a BSD extension, not present in POSIX." msgstr "" #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "Match offsets" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Unless B was passed to B(), it is possible to obtain the " "locations of matches within I: B() fills I " "elements of I with results: I corresponds to the entire " "match, I to the first subexpression, etc. If there were more " "matches than I, they are discarded; if fewer, unused elements of " "I are filled with B<-1>s." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Each returned valid (non-B<-1>) match corresponds to the range [I,I< string + rm_eo>)." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "I is a signed integer type capable of storing the largest value " "that can be stored in either an I type or a I type." msgstr "" #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "Error reporting" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B() is used to turn the error codes that can be returned by both " "B() and B() into error message strings." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "If I isn't a null pointer, I must be the latest error " "returned from an operation on I." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "If I isn't 0, up to I bytes are copied to " "I; the error string is always null-terminated, and truncated to fit." msgstr "" #. type: SS #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "Freeing" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "B() deinitializes the pattern buffer at I<*preg>, freeing any " "associated memory; I<*preg> must have been initialized via B()." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B() returns zero for a successful compilation or an error code for " "failure." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B() returns zero for a successful match or B for " "failure." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "B() returns the size of the buffer required to hold the string." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "ERRORS" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The following errors can be returned by B():" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Invalid use of back reference operator." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Invalid use of pattern operators such as group or list." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Invalid use of repetition operators such as using \\[aq]*\\[aq] as the first " "character." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Un-matched brace interval operators." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Un-matched bracket list operators." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Invalid collating element." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Unknown character class name." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "Nonspecific error. This is not defined by POSIX." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Trailing backslash." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Un-matched parenthesis group operators." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "Invalid use of the range operator; for example, the ending point of the " "range occurs prior to the starting point." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Compiled regular expression requires a pattern buffer larger than 64\\ kB. " "This is not defined by POSIX." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The regex routines ran out of memory." msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Invalid back reference to a subexpression." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "ATTRIBUTES" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "For an explanation of the terms used in this section, see B(7)." msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Interface" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Attribute" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Value" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid ".na\n" msgstr "" #. type: tbl table #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid ".nh\n" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "" "B(),\n" "B()" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Thread safety" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Safe locale" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B()" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Safe env" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "B()" msgstr "" #. type: tbl table #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "MT-Safe" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "STANDARDS" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "POSIX.1-2008." msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "HISTORY" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "POSIX.1-2001." msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Prior to POSIX.1-2008, I was required to be capable of storing the " "largest value that can be stored in either an I type or a I " "type." msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "CAVEATS" msgstr "" #. glibc, musl, 4.4BSD, illumos #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "I is only required to be initialized if B wasn't " "specified, but all known implementations initialize it regardless." msgstr "" #. illumos has two more start/end pairs and the first one is of pointers #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed msgid "" "Both I and I may (and do) have more members, in any " "order. Always reference them by name." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-tumbleweed #, no-wrap msgid "" "#include Estdint.hE\n" "#include Estdio.hE\n" "#include Estdlib.hE\n" "#include Eregex.hE\n" "\\&\n" "#define ARRAY_SIZE(arr) (sizeof((arr)) / sizeof((arr)[0]))\n" "\\&\n" "static const char *const str =\n" " \"1) John Driverhacker;\\en2) John Doe;\\en3) John Foo;\\en\";\n" "static const char *const re = \"John.*o\";\n" "\\&\n" "int main(void)\n" "{\n" " static const char *s = str;\n" " regex_t regex;\n" " regmatch_t pmatch[1];\n" " regoff_t off, len;\n" "\\&\n" " if (regcomp(®ex, re, REG_NEWLINE))\n" " exit(EXIT_FAILURE);\n" "\\&\n" " printf(\"String = \\e\"%s\\e\"\\en\", str);\n" " printf(\"Matches:\\en\");\n" "\\&\n" " for (unsigned int i = 0; ; i++) {\n" " if (regexec(®ex, s, ARRAY_SIZE(pmatch), pmatch, 0))\n" " break;\n" "\\&\n" " off = pmatch[0].rm_so + (s - str);\n" " len = pmatch[0].rm_eo - pmatch[0].rm_so;\n" " printf(\"#%zu:\\en\", i);\n" " printf(\"offset = %jd; length = %jd\\en\", (intmax_t) off,\n" " (intmax_t) len);\n" " printf(\"substring = \\e\"%.*s\\e\"\\en\", len, s + pmatch[0].rm_so);\n" "\\&\n" " s += pmatch[0].rm_eo;\n" " }\n" "\\&\n" " exit(EXIT_SUCCESS);\n" "}\n" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "B(1), B(7)" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The glibc manual section, I" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "2023-02-05" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "Linux man-pages 6.03" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "BIB<, const char *restrict >IB<,>\n" "B< int >IB<);>\n" "BIB<, const char *restrict >IB<,>\n" "B< size_t >IB<, regmatch_t >IB<[restrict .>IB<],>\n" "B< int >IB<);>\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "BIB<, const regex_t *restrict >IB<,>\n" "B< char >IB<[restrict .>IB<], size_t >IB<);>\n" "BIB<);>\n" msgstr "" #. type: SS #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "POSIX regex compiling" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "B() is supplied with I, a pointer to a pattern buffer " "storage area; I, a pointer to the null-terminated string and " "I, flags used to determine the type of compilation." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "All regular expression searching must be done via a compiled pattern buffer, " "thus B() must always be supplied with the address of a " "B()-initialized pattern buffer." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "I is the bitwise-B of zero or more of the following:" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "Use B Extended Regular Expression syntax when interpreting I. " "If not set, B Basic Regular Expression syntax is used." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "Do not report position of matches. The I and I arguments to " "B() are ignored if the pattern buffer supplied was compiled with " "this flag set." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "A nonmatching list (B<[\\[ha]...]>) not containing a newline does not match " "a newline." msgstr "" #. type: SS #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "POSIX regex matching" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "B() is used to match a null-terminated string against the " "precompiled pattern buffer, I. I and I are used to " "provide information regarding the location of any matches. I is the " "bitwise-B of zero or more of the following flags:" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "Use I on the input string, starting at byte I " "and ending before byte I. This allows matching embedded " "NUL bytes and avoids a B(3) on large strings. It does not use " "I on input, and does not change B or B " "processing. This flag is a BSD extension, not present in POSIX." msgstr "" #. type: SS #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "Byte offsets" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "Unless B was set for the compilation of the pattern buffer, it is " "possible to obtain match addressing information. I must be " "dimensioned to have at least I elements. These are filled in by " "B() with substring match addresses. The offsets of the " "subexpression starting at the Ith open parenthesis are stored in " "I. The entire regular expression's match addresses are stored in " "I. (Note that to return the offsets of I subexpression " "matches, I must be at least I.) Any unused structure elements " "will contain the value -1." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "The I structure which is the type of I is defined in " "Iregex.hE>." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "typedef struct {\n" " regoff_t rm_so;\n" " regoff_t rm_eo;\n" "} regmatch_t;\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "Each I element that is not -1 indicates the start offset of the next " "largest substring match within the string. The relative I element " "indicates the end offset of the match, which is the offset of the first " "character after the matching text." msgstr "" #. type: SS #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "POSIX error reporting" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "B() is passed the error code, I, the pattern buffer, " "I, a pointer to a character string buffer, I, and the size of " "the string buffer, I. It returns the size of the I " "required to contain the null-terminated error message string. If both " "I and I are nonzero, I is filled in with the " "first I characters of the error message and a terminating " "null byte (\\[aq]\\e0\\[aq])." msgstr "" #. type: SS #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "POSIX pattern buffer freeing" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "Supplying B() with a precompiled pattern buffer, I, will " "free the memory allocated to the pattern buffer by the compiling process, " "B()." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "Nonspecific error. This is not defined by POSIX.2." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "Compiled regular expression requires a pattern buffer larger than 64\\ kB. " "This is not defined by POSIX.2." msgstr "" #. type: Plain text #: debian-bookworm msgid "POSIX.1-2001, POSIX.1-2008." msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "#include Estdint.hE\n" "#include Estdio.hE\n" "#include Estdlib.hE\n" "#include Eregex.hE\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "#define ARRAY_SIZE(arr) (sizeof((arr)) / sizeof((arr)[0]))\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "static const char *const str =\n" " \"1) John Driverhacker;\\en2) John Doe;\\en3) John Foo;\\en\";\n" "static const char *const re = \"John.*o\";\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" "int main(void)\n" "{\n" " static const char *s = str;\n" " regex_t regex;\n" " regmatch_t pmatch[1];\n" " regoff_t off, len;\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " if (regcomp(®ex, re, REG_NEWLINE))\n" " exit(EXIT_FAILURE);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " printf(\"String = \\e\"%s\\e\"\\en\", str);\n" " printf(\"Matches:\\en\");\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " for (unsigned int i = 0; ; i++) {\n" " if (regexec(®ex, s, ARRAY_SIZE(pmatch), pmatch, 0))\n" " break;\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " off = pmatch[0].rm_so + (s - str);\n" " len = pmatch[0].rm_eo - pmatch[0].rm_so;\n" " printf(\"#%zu:\\en\", i);\n" " printf(\"offset = %jd; length = %jd\\en\", (intmax_t) off,\n" " (intmax_t) len);\n" " printf(\"substring = \\e\"%.*s\\e\"\\en\", len, s + pmatch[0].rm_so);\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " s += pmatch[0].rm_eo;\n" " }\n" msgstr "" #. type: Plain text #: debian-bookworm opensuse-leap-15-6 #, no-wrap msgid "" " exit(EXIT_SUCCESS);\n" "}\n" msgstr "" #. type: TH #: fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "2023-10-31" msgstr "" #. type: TH #: fedora-40 mageia-cauldron #, no-wrap msgid "Linux man-pages 6.06" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "Linux man-pages 6.7" msgstr "" #. type: TH #: opensuse-leap-15-6 #, no-wrap msgid "2023-03-30" msgstr "" #. type: TH #: opensuse-leap-15-6 #, no-wrap msgid "Linux man-pages 6.04" msgstr "" #. type: TH #: opensuse-tumbleweed #, no-wrap msgid "Linux man-pages (unreleased)" msgstr ""