[][src]Function spatialite_sys::gaiaGetVectorLayersList

pub unsafe extern "C" fn gaiaGetVectorLayersList(
    handle: *mut sqlite3,
    table: *const c_char,
    geometry: *const c_char,
    mode: c_int
) -> gaiaVectorLayersListPtr

Queries the Metadata tables supporting Vector Layers

\param handle SQLite handle to current DB connection. \param table VectorLayer Table (or View, or VirtualShape). \param geometry Geometry Column name. \param mode one of GAIA_VECTORS_LIST_OPTIMISTIC or GAIA_VECTORS_LIST_PESSIMISTIC.

\return the pointer to the newly created VectorLayersList object: NULL on failure

\sa gaiaFreeVectorLayersList, update_layer_statistics, gaiaStatisticsInvalidate, gaiaGetLayerExtent, gaiaGetVectorLayersList

\note you are responsible to destroy (before or after) any allocated VectorLayersList returned by gaiaGetVectorLayersList(). \n If the table arg is NULL all VectorLayers defined within the DB will be reported; otherwise only a single Layer will be reported (if existing). \n By defining the geometry arg (not NULL) you can further restrict the returned report. \n When the mode arg is set to GAIA_VECTORS_LIST_OPTIMISTIC (default) then the returned infos will be simply retrieved from the staticized statistic tables (faster, but could be inaccurate). \n If the mode arg is set to GAIA_VECTORS_LIST_PESSIMISTIC a preliminary attempt to update the statistic tables will be always performed (probably slower, but surely accurate).