GRASS GIS 8 Programmer's Manual  8.5.0dev(2024)-d6dec75dd4
dirent.c File Reference

DBMI Library (base) - directory entities management. More...

#include <string.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/types.h>
#include <dirent.h>
#include <grass/dbmi.h>
Include dependency graph for dirent.c:

Go to the source code of this file.

Macros

#define R_OK   4
 
#define W_OK   2
 
#define X_OK   1
 

Functions

dbDirentdb_dirent (const char *dirname, int *n)
 Read directory and build an array of dbDirent's. More...
 
void db_free_dirent_array (dbDirent *db_dirent, int count)
 Free dbDirent. More...
 
dbDirentdb_alloc_dirent_array (int count)
 Allocate dirent array. More...
 

Detailed Description

DBMI Library (base) - directory entities management.

(C) 1999-2010 by the GRASS Development Team

This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.

Author
Joel Jones (CERL/UIUC)
Upgraded to GRASS 5.7 by Radim Blazek

Definition in file dirent.c.

Macro Definition Documentation

◆ R_OK

#define R_OK   4

Definition at line 25 of file dirent.c.

◆ W_OK

#define W_OK   2

Definition at line 28 of file dirent.c.

◆ X_OK

#define X_OK   1

Definition at line 31 of file dirent.c.

Function Documentation

◆ db_alloc_dirent_array()

dbDirent* db_alloc_dirent_array ( int  count)

Allocate dirent array.

Parameters
countnumber of entities in the array
Returns
pointer to dbDirent array
NULL on failure

Definition at line 163 of file dirent.c.

References count, db_calloc(), db_dirent(), db_init_string(), name, and NULL.

◆ db_dirent()

dbDirent* db_dirent ( const char *  dirname,
int *  n 
)

Read directory and build an array of dbDirent's.

Append one entry with name = NULL to mark end of array

Parameters
dirnamedirectory name
[out]nnumber of entities
Returns
pointer to dbDirent
NULL on error

Definition at line 49 of file dirent.c.

References count, and db_dirent().

Referenced by db_alloc_dirent_array(), db_dirent(), and db_free_dirent_array().

◆ db_free_dirent_array()

void db_free_dirent_array ( dbDirent db_dirent,
int  count 
)

Free dbDirent.

Parameters
db_direntpointer to dbDirent
countnumber of entities in the array

Definition at line 114 of file dirent.c.

References count, db_dirent(), db_free(), db_free_string(), and name.