Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commitcf92226

Browse files
committed
Doc: improve description of regexp character classes.
Define the meanings of the POSIX-spec character classes in line,rather than referring to the ctype(3) man page. That man pagedoesn't even exist on many modern systems, and if it does existit probably says the wrong things about non-ASCII characters.Also document our non-POSIX-spec "ascii" character class.Also, point out here that this behavior is controlled by collation orLC_CTYPE, since the existing text explaining that is pretty far away.Per gripe from Geert Lobbestael. Given the lack of prior complaints,I'm not excited about back-patching this.Discussion:https://postgr.es/m/155837022049.1359.2948065118562813468@wrigleys.postgresql.org
1 parenta240570 commitcf92226

File tree

1 file changed

+32
-14
lines changed

1 file changed

+32
-14
lines changed

‎doc/src/sgml/func.sgml

Lines changed: 32 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5104,18 +5104,37 @@ SELECT foo FROM regexp_split_to_table('the quick brown fox', '\s*') AS foo;
51045104
<para>
51055105
Within a bracket expression, the name of a character class
51065106
enclosed in <literal>[:</literal> and <literal>:]</literal> stands
5107-
for the list of all characters belonging to that class. Standard
5108-
character class names are: <literal>alnum</literal>,
5109-
<literal>alpha</literal>, <literal>blank</literal>,
5110-
<literal>cntrl</literal>, <literal>digit</literal>,
5111-
<literal>graph</literal>, <literal>lower</literal>,
5112-
<literal>print</literal>, <literal>punct</literal>,
5113-
<literal>space</literal>, <literal>upper</literal>,
5114-
<literal>xdigit</literal>. These stand for the character classes
5115-
defined in
5116-
<citerefentry><refentrytitle>ctype</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
5117-
A locale can provide others. A character class cannot be used as
5118-
an endpoint of a range.
5107+
for the list of all characters belonging to that class. A character
5108+
class cannot be used as an endpoint of a range.
5109+
The <acronym>POSIX</acronym> standard defines these character class
5110+
names:
5111+
<literal>alnum</literal> (letters and numeric digits),
5112+
<literal>alpha</literal> (letters),
5113+
<literal>blank</literal> (space and tab),
5114+
<literal>cntrl</literal> (control characters),
5115+
<literal>digit</literal> (numeric digits),
5116+
<literal>graph</literal> (printable characters except space),
5117+
<literal>lower</literal> (lower-case letters),
5118+
<literal>print</literal> (printable characters including space),
5119+
<literal>punct</literal> (punctuation),
5120+
<literal>space</literal> (any white space),
5121+
<literal>upper</literal> (upper-case letters),
5122+
and <literal>xdigit</literal> (hexadecimal digits).
5123+
The behavior of these standard character classes is generally
5124+
consistent across platforms for characters in the 7-bit ASCII set.
5125+
Whether a given non-ASCII character is considered to belong to one
5126+
of these classes depends on the <firstterm>collation</firstterm>
5127+
that is used for the regular-expression function or operator
5128+
(see <xref linkend="collation"/>), or by default on the
5129+
database's <envar>LC_CTYPE</envar> locale setting (see
5130+
<xref linkend="locale"/>). The classification of non-ASCII
5131+
characters can vary across platforms even in similarly-named
5132+
locales. (But the <literal>C</literal> locale never considers any
5133+
non-ASCII characters to belong to any of these classes.)
5134+
In addition to these standard character
5135+
classes, <productname>PostgreSQL</productname> defines
5136+
the <literal>ascii</literal> character class, which contains exactly
5137+
the 7-bit ASCII set.
51195138
</para>
51205139

51215140
<para>
@@ -5126,8 +5145,7 @@ SELECT foo FROM regexp_split_to_table('the quick brown fox', '\s*') AS foo;
51265145
and end of a word respectively. A word is defined as a sequence
51275146
of word characters that is neither preceded nor followed by word
51285147
characters. A word character is an <literal>alnum</literal> character (as
5129-
defined by
5130-
<citerefentry><refentrytitle>ctype</refentrytitle><manvolnum>3</manvolnum></citerefentry>)
5148+
defined by the <acronym>POSIX</acronym> character class described above)
51315149
or an underscore. This is an extension, compatible with but not
51325150
specified by <acronym>POSIX</acronym> 1003.2, and should be used with
51335151
caution in software intended to be portable to other systems.

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp