GRASS 8 Programmer's Manual: index.c File Reference

GRASS 8 Programmer's Manual 8.6.0dev(2026)-4bb960b182

Loading...

Searching...

No Matches

DBMI Library (base) - index management. More...

#include <string.h>
#include <stdlib.h>
#include <grass/dbmi.h>
#include <grass/glocale.h>

Include dependency graph for db/dbmi_base/index.c:

Go to the source code of this file.

Functions
void	db_init_index (dbIndex *index)
	Initialize dbIndex.

void	db_free_index (dbIndex *index)
	Free allocated dbIndex.

int	db_alloc_index_columns (dbIndex *index, int ncols)
	Allocate index columns.

dbIndex *	db_alloc_index_array (int count)
	Allocate index array.

void	db_free_index_array (dbIndex *list, int count)
	Free index array.

int	db_set_index_name (dbIndex index, const char name)
	Set index name.

const char *	db_get_index_name (dbIndex *index)
	Get index name.

int	db_set_index_table_name (dbIndex index, const char name)
	Set table name.

const char *	db_get_index_table_name (dbIndex *index)
	Get table name.

int	db_get_index_number_of_columns (dbIndex *index)
	Get number of columns.

int	db_set_index_column_name (dbIndex index, int column_num, const char name)
	Set column name.

const char *	db_get_index_column_name (dbIndex *index, int column_num)
	Get column number.

int	db_set_index_type_unique (dbIndex *index)
	Set index type to unique.

int	db_set_index_type_non_unique (dbIndex *index)
	Set index type to non-unique.

int	db_test_index_type_unique (dbIndex *index)
	Test if type is unique.

void	db_print_index (FILE fd, dbIndex index)
	Report index.

Detailed Description

DBMI Library (base) - index management.

SPDX-FileCopyrightText: 1999-2009, 2011 GRASS Development Team SPDX-License-Identifier: GPL-2.0-or-later

Author: Joel Jones (CERL/UIUC), Radim Blazek; Doxygenized by Martin Landa <landa.martin gmail.com> (2011)

Definition in file db/dbmi_base/index.c.

Function Documentation

◆ db_alloc_index_array()

dbIndex * db_alloc_index_array ( int count )

Allocate index array.

Parameters

count number of items

Returns: pointer to allocated dbIndex array

Definition at line 71 of file db/dbmi_base/index.c.

References count, db_calloc(), and db_init_index().

Referenced by db__recv_index_array().

◆ db_alloc_index_columns()

int db_alloc_index_columns	(	dbIndex *	index,
		int	ncols
	)

Allocate index columns.

Parameters

index	pointer to dbIndex
ncols	number of columns to be allocated

Returns: DB_OK

Definition at line 54 of file db/dbmi_base/index.c.

References _db_index::columnNames, db_alloc_string_array(), db_get_error_code(), DB_OK, NULL, and _db_index::numColumns.

Referenced by db__recv_index(), and db_create_index2().

◆ db_free_index()

void db_free_index ( dbIndex * index )

Free allocated dbIndex.

Parameters

index pointer to dbIndex to be freed

Definition at line 37 of file db/dbmi_base/index.c.

References _db_index::columnNames, db_free_string(), db_free_string_array(), db_init_index(), _db_index::indexName, _db_index::numColumns, and _db_index::tableName.

Referenced by db_create_index2(), db_d_create_index(), and db_free_index_array().

◆ db_free_index_array()

void db_free_index_array	(	dbIndex *	list,
		int	count
	)

Free index array.

Parameters

list	dbIndex array
count	number of items in the array

Definition at line 90 of file db/dbmi_base/index.c.

References count, db_free(), and db_free_index().

Referenced by db_d_list_indexes().

◆ db_get_index_column_name()

const char * db_get_index_column_name	(	dbIndex *	index,
		int	column_num
	)

Get column number.

Parameters

index	pointer to dbIndex
column_num	column number

Returns: string buffer with name

Definition at line 192 of file db/dbmi_base/index.c.

References _, _db_index::columnNames, db_error(), db_get_string(), NULL, and _db_index::numColumns.

Referenced by db_print_index().

◆ db_get_index_name()

const char * db_get_index_name ( dbIndex * index )

Get index name.

Parameters

index pointer to dbIndex

Returns: string buffer with name

Definition at line 122 of file db/dbmi_base/index.c.

References db_get_string(), and _db_index::indexName.

Referenced by db_print_index().

◆ db_get_index_number_of_columns()

int db_get_index_number_of_columns ( dbIndex * index )

Get number of columns.

Parameters

index pointer to dbIndex

Returns: number of columns

Definition at line 160 of file db/dbmi_base/index.c.

References _db_index::numColumns.

Referenced by db_print_index().

◆ db_get_index_table_name()

const char * db_get_index_table_name ( dbIndex * index )

Get table name.

Parameters

index pointer to dbIndex

Returns: string buffer with name

Definition at line 148 of file db/dbmi_base/index.c.

References db_get_string(), and _db_index::tableName.

Referenced by db_print_index().

◆ db_init_index()

void db_init_index ( dbIndex * index )

Initialize dbIndex.

Parameters

index pointer to dbIndex to be initialized

Definition at line 23 of file db/dbmi_base/index.c.

References _db_index::columnNames, db_init_string(), _db_index::indexName, NULL, _db_index::numColumns, _db_index::tableName, and _db_index::unique.

Referenced by db__recv_index(), db_alloc_index_array(), db_create_index2(), db_d_create_index(), and db_free_index().

◆ db_print_index()

void db_print_index	(	FILE *	fd,
		dbIndex *	index
	)

Report index.

Parameters

fd	file where to print index info
index	pointer to dbIndex

Definition at line 252 of file db/dbmi_base/index.c.

References db_get_index_column_name(), db_get_index_name(), db_get_index_number_of_columns(), db_get_index_table_name(), and db_test_index_type_unique().

◆ db_set_index_column_name()

int db_set_index_column_name	(	dbIndex *	index,
		int	column_num,
		const char *	name
	)

Set column name.

Parameters

index	pointer to dbIndex
column_num	column number
name	name to be set

Returns: DB_OK on success; DB_FAILED on error

Definition at line 175 of file db/dbmi_base/index.c.

References _, _db_index::columnNames, db_error(), db_get_error_code(), db_set_string(), name, and _db_index::numColumns.

Referenced by db_create_index2().

◆ db_set_index_name()

int db_set_index_name	(	dbIndex *	index,
		const char *	name
	)

Set index name.

Parameters

index	pointer to dbIndex
name	name to be set

Returns: DB_OK on success; DB_FAILED on error

Definition at line 110 of file db/dbmi_base/index.c.

References db_set_string(), _db_index::indexName, and name.

Referenced by db_create_index2().

◆ db_set_index_table_name()

int db_set_index_table_name	(	dbIndex *	index,
		const char *	name
	)

Set table name.

Parameters

index	pointer to dbIndex
name	name to be set

Returns: DB_OK on success; DB_FAILED on error

Definition at line 136 of file db/dbmi_base/index.c.

References db_set_string(), name, and _db_index::tableName.

Referenced by db_create_index2().

◆ db_set_index_type_non_unique()

int db_set_index_type_non_unique ( dbIndex * index )

Set index type to non-unique.

Todo:: return type void?

Parameters

index pointer to dbIndex

Returns: 0

Definition at line 226 of file db/dbmi_base/index.c.

References _db_index::unique.

◆ db_set_index_type_unique()

int db_set_index_type_unique ( dbIndex * index )

Set index type to unique.

Todo:: return type void?

Parameters

index pointer to dbIndex

Returns: 0

Definition at line 210 of file db/dbmi_base/index.c.

References _db_index::unique.

Referenced by db_create_index2().

◆ db_test_index_type_unique()

int db_test_index_type_unique ( dbIndex * index )

Test if type is unique.

Parameters

index pointer to dbIndex

Returns: non-zero if True; zero if False

Definition at line 241 of file db/dbmi_base/index.c.

References _db_index::unique.

Referenced by db_print_index().

lib
db
dbmi_base
index.c
Generated on Mon Sep 14 2026 06:57:50 for GRASS 8 Programmer's Manual by 1.9.8