open-dsi
/
postgres
mirror of https://github.com/postgres/postgres
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Doc: fix examples for pg_input_error_info().

Browse Source 
These were causing "contents ... exceed the available area"
warnings in PDF builds, and also didn't quite follow our markup
conventions for function examples.  To fix the overwidth
problem, reduce the number of fields shown in one example,
and also insert &zwsp; to let the header line be broken in
a reasonable place.

Discussion: https://postgr.es/m/20230324194701.dqkzcdtlcikseo22@awork3.anarazel.de
pull/137/head
Tom Lane 3 years ago
parent 642d877976
commit 7023207cfd
1 changed files with 14 additions and 9 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 23
      doc/src/sgml/func.sgml

23
doc/src/sgml/func.sgml
Unescape View File

@ -24902,7 +24902,7 @@ SELECT collation for ('foo' COLLATE "de_DE");
<para> <para>
Tests whether the given <parameter>string</parameter> is valid Tests whether the given <parameter>string</parameter> is valid
input for the specified data type; if not, return the details of input for the specified data type; if not, return the details of
the error would have been thrown. If the input is valid, the the error that would have been thrown. If the input is valid, the
results are NULL. The inputs are the same as results are NULL. The inputs are the same as
for <function>pg_input_is_valid</function>. for <function>pg_input_is_valid</function>.
</para> </para>
@ -24912,18 +24912,23 @@ SELECT collation for ('foo' COLLATE "de_DE");
a <quote>soft</quote> error. Otherwise, invalid input will abort a <quote>soft</quote> error. Otherwise, invalid input will abort
the transaction, just as if the string had been cast to the type the transaction, just as if the string had been cast to the type
directly. directly.
</para> </para>
<para> <para>
<literal>select * from pg_input_error_info('42000000000', 'integer')</literal>
<returnvalue></returnvalue>
<programlisting> <programlisting>
SELECT * FROM pg_input_error_info('42000000000', 'integer');
message | detail | hint | sql_error_code message | detail | hint | sql_error_code
------------------------------------------------------+--------+------+---------------- ------------------------------------------------------+--------+------+----------------
value "42000000000" is out of range for type integer | | | 22003 value "42000000000" is out of range for type integer | | | 22003
</programlisting>
SELECT * FROM pg_input_error_info('1234.567', 'numeric(7,4)'); </para>
message | detail | hint | sql_error_code <para>
------------------------+-----------------------------------------------------------------------------------+------+---------------- <literal>select message, detail from pg_input_error_info('1234.567', 'numeric(7,4)')</literal>
numeric field overflow | A field with precision 7, scale 4 must round to an absolute value less than 10^3. | | 22003 <returnvalue></returnvalue>
<programlisting>
message | detail
------------------------+----------------------------------&zwsp;-------------------------------------------------
numeric field overflow | A field with precision 7, scale 4 must round to an absolute value less than 10^3.
</programlisting> </programlisting>
</para></entry> </para></entry>
</row> </row>

Write Preview
Loading…
Cancel
Save