Geografic-Information-System/lib/vector/vectorlib_pg.dox

/*! \page vlibPg GRASS-PostGIS data provider

by GRASS Development Team (http://grass.osgeo.org)

\tableofcontents

\section vlibPgInro Introduction

<b>GRASS-PostGIS data provider</b> allows GRASS vector library to read and
write PostGIS data directly without any external library (like in the
case of \ref vlibOgr). GRASS-PostGIS data provider is implemented
using <a
href="http://www.postgresql.org/docs/9.2/static/libpq.html">libpq
library</a>.

Note that GRASS-PostGIS data provider is compiled only when GRASS is
configured with <tt>--with-postgres</tt> switch.

See the <a
href="http://trac.osgeo.org/grass/wiki/Grass7/VectorLib/PostGISInterface">trac
page</a> for more info.

\section vlibFn List of functions

Note that the functions listed bellow are lower level subroutines, in
other word these functions are not consider for usage. They are
internally used by the vector library when accessing PostGIS data. The
programmer should use higher level functions instead. 

- Vect_open_old() to open exising vector map (ie. PostGIS table when using GRASS-PostGIS data provider)
- Vect_open_new() to create new vector map
- Vect_close() to close vector map

- Vect_rewind() to rewind the map for sequential access
- Vect_read_next_line() for sequential access
- Vect_read_line() for random access

- Vect_write_line() to write a new feature
- Vect_delete_line() to delete existing feature
- Vect_rewrite_line() to modify exising feature

- Vect_build() to build (pseudo-)topology

Note that functions with <tt>V1_</tt> prefix access vector data
without topology. Topological (pseudo-topological for simple features)
access is provided by functions starting with <tt>V2_</tt> prefix.

\par Open/Create PostGIS table as GRASS vector map

- V1_open_old_pg()
- V2_open_old_pg()

- V1_open_new_pg()
- V2_open_new_pg()

- V1_close_pg()
- V2_close_pg()

\par Read feature from PostGIS table

- V1_rewind_pg()
- V2_rewind_pg()

- V1_read_next_line_pg()
- V2_read_next_line_pg()

- V1_read_line_pg()
- V2_read_line_sfa()
- V2_read_line_pg()

\par Write new feature to PostGIS table

- V1_write_line_pg()
- V2_write_line_sfa()
- V2_write_line_pg()

\par Delete exising feature from PostGIS table

- V1_delete_line_pg()
- V2_delete_line_sfa()

\par Modify existing feature from PostGIS table

- V1_rewrite_line_pg()
- V2_rewrite_line_sfa()

\par Build topology

- Vect_open_topo_pg()
- Vect__build_sfa()
- Vect_build_pg()
 
\section vlibPgSeeAlso See Also

 - \ref vlibOgr

\section vlibPgAuthors Authors

Martin Landa <landa.martin gmail.com>

*/