elf
/
postgres-basename-dirname
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
README.rst
View File

@ -1,13 +1,30 @@
Synopsis
--------
`basename.sql` contains functions which provide the POSIX-equivalent
functions `basename` and `dirname` of PostgreSQL. The functions are
written in fairly standard PL/pgSQL, and should work with any version of
PostgreSQL after version 6.
``basename.sql`` contains functions which provide equivalents to the
POSIX functions ``basename`` and ``dirname`` for PostgreSQL, and can be
used in any Postgres SQL command. The functions are written in fairly
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.
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
------------------------------------------------------------