Thread: Minor mistake in string functions docs - overlay

Minor mistake in string functions docs - overlay

From
Roy Tate
Date:
I found a minor mistake in the documentation of string functions.

http://www.postgresql.org/docs/9.4/static/functions-string.html

In table 9-6 examples and results columns, look at the overlay function, which has 4 x characters, but overlays 3 characters.  Please remove an x.

overlay('Txxxxas' placing 'hom' from 2 for 4)     Thomas

Please change the call to { overlay('Txxxas' ... }

Have a good day, and thanks for creating such amazing documentation.

Roy Tate

Re: Minor mistake in string functions docs - overlay

From
Tom Lane
Date:
Roy Tate <roy.l.tate@gmail.com> writes:
> I found a minor mistake in the documentation of string functions.
> http://www.postgresql.org/docs/9.4/static/functions-string.html

> In table 9-6 examples and results columns, look at the overlay function,
> which has 4 x characters, but overlays 3 characters.  Please remove an x.

Really?  The example works as stated for me:

regression=# select overlay('Txxxxas' placing 'hom' from 2 for 4);
 overlay
---------
 Thomas
(1 row)

Removing an 'x' would give

regression=# select overlay('Txxxas' placing 'hom' from 2 for 4);
 overlay
---------
 Thoms
(1 row)

I think the example is trying to point out that the replacement string
need not be the same length as what is replaced.

            regards, tom lane