Fixing typos, adding examples.

This commit is contained in:
Elf M. Sternberg 2016-07-12 15:32:18 -07:00
parent 6961710f75
commit 1704887cb1
1 changed files with 21 additions and 4 deletions

View File

@ -1,13 +1,30 @@
Synopsis Synopsis
-------- --------
`basename.sql` contains functions which provide the POSIX-equivalent ``basename.sql`` contains functions which provide equivalents to the
functions `basename` and `dirname` of PostgreSQL. The functions are POSIX functions ``basename`` and ``dirname`` for PostgreSQL, and can be
written in fairly standard PL/pgSQL, and should work with any version of used in any Postgres SQL command. The functions are written in fairly
PostgreSQL after version 6. standard PL/pgSQL, and should work with any version of PostgreSQL after
version 6.
I make no claim that these functions are SQL/PSM-compliant. I make no claim that these functions are SQL/PSM-compliant.
Example
-------
I created these handlers to help with finding nested folders in my music
catalog program, `Catalogia<http://github.com/elfsternberg/catalogia>_`.
``SELECT dirname(mp3a.path) AS parent,
dirname(mp3b.path) AS child
FROM catalog_mp3 AS mp3a,
catalog_mp3 AS mp3b
WHERE dirname(mp3a.path) != dirname(mp3b.path)
AND ('^' || dirname(mp3b.path)) ~ dirname(mp3a.path);
``
By the way, that's *hideously* inefficient, but it worked as a demo!
LICENSE AND COPYRIGHT NOTICE: NO WARRANTY GRANTED OR IMPLIED LICENSE AND COPYRIGHT NOTICE: NO WARRANTY GRANTED OR IMPLIED
------------------------------------------------------------ ------------------------------------------------------------