git.postgresql.org Git - postgresql.git/commitdiff

git projects / postgresql.git / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 4a6286f)
doc: improve bpchar and character type length details
2023年10月31日 14:13:11 +0000 (10:13 -0400)
2023年10月31日 14:13:11 +0000 (10:13 -0400)
Reported-by: Jeff Davis
Discussion: https://postgr.es/m/32a9b8357e8e29b04f395f92c53b64e015a4caf1.camel@j-davis.com

Author: Jeff Davis, adjustments by me

Backpatch-through: 16


diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 5d237657059322594e4496c4bb0d48c8122e56af..5a6cfbd94d8ab3cbaac01dd0df7ec6faa8be92d8 100644 (file)
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -1174,7 +1174,11 @@ SELECT '52093.89'::money::numeric::float8;
</row>
<row>
<entry><type>character(<replaceable>n</replaceable>)</type>, <type>char(<replaceable>n</replaceable>)</type>, <type>bpchar(<replaceable>n</replaceable>)</type></entry>
- <entry>fixed-length, blank padded</entry>
+ <entry>fixed-length, blank-padded</entry>
+ </row>
+ <row>
+ <entry><type>bpchar</type></entry>
+ <entry>variable unlimited length, blank-trimmed</entry>
</row>
<row>
<entry><type>text</type></entry>
@@ -1230,19 +1234,22 @@ SELECT '52093.89'::money::numeric::float8;
<para>
The type name <type>varchar</type> is an alias for <type>character
- varying</type>, while <type>char</type> and <type>bpchar</type> are
- aliases for <type>character</type>.
- The <type>varchar</type> and <type>char</type> aliases are defined in
- the <acronym>SQL</acronym> standard, but <type>bpchar</type> is
- a <productname>PostgreSQL</productname> extension.
+ varying</type>, while <type>bpchar</type> (with length specifier) and
+ <type>char</type> are aliases for <type>character</type>. The
+ <type>varchar</type> and <type>char</type> aliases are defined in the
+ <acronym>SQL</acronym> standard; <type>bpchar</type> is a
+ <productname>PostgreSQL</productname> extension.
</para>
<para>
If specified, the length <replaceable>n</replaceable> must be greater
- than zero and cannot exceed 10485760.
- <type>character</type> without length specifier is equivalent to
- <type>character(1)</type>. If <type>character varying</type> is used
- without length specifier, the type accepts strings of any size.
+ than zero and cannot exceed 10,485,760. If <type>character
+ varying</type> (or <type>varchar</type>) is used without
+ length specifier, the type accepts strings of any length. If
+ <type>bpchar</type> lacks a length specifier, it also accepts strings
+ of any length, but trailing spaces are semantically insignificant.
+ If <type>character</type> (or <type>char</type>) lacks a specifier,
+ it is equivalent to <type>character(1)</type>.
</para>
<para>
This is the main PostgreSQL git repository.
RSS Atom

AltStyle によって変換されたページ (->オリジナル) /