list_subgp.c

Go to the documentation of this file.

/*!
   \file list_subgp.c
 
   \brief Imagery Library - List subgroup
 
   SPDX-FileCopyrightText: 2001-2008,2013 GRASS Development Team
   SPDX-License-Identifier: GPL-2.0-or-later
 
   \author USA CERL
 */
 
#include <string.h>
#include <grass/imagery.h>
#include <grass/glocale.h>
 
char **list_subgroups(const char *group, const char *mapset, int *subgs_num)
{
    /* Unlike I_list_subgroup and I_list_subgroup_simple this function
       returns array of subgroup names, it does not use fprintf.
       This approach should make the function usable in more cases. */
 
    char **subgs;
    char path[GPATH_MAX];
    char buf[GPATH_MAX];
    struct stat sb;
 
    *subgs_num = 0;
 
    if (I_find_group2(group, mapset) == 0)
        return NULL;
 
    snprintf(buf, sizeof(buf), "group/%s/subgroup", group);
    G_file_name(path, buf, "", mapset);
 
    if (G_lstat(path, &sb) || !S_ISDIR(sb.st_mode))
        return NULL;
 
    subgs = G_ls2(path, subgs_num);
    return subgs;
}
 
/*!
 * \brief Get list of subgroups which a group contains.
 *
 * \param group group name
 * \param[out] subgs_num number of subgroups which the group contains
 * \return array of subgroup names
 */
char **I_list_subgroups(const char *group, int *subgs_num)
{
 
    return list_subgroups(group, G_mapset(), subgs_num);
}
 
/*!
 * \brief Get list of subgroups which a group contains.
 *
 * \param group group name
 * \param mapset mapset name
 * \param[out] subgs_num number of subgroups which the group contains
 * \return array of subgroup names
 */
char **I_list_subgroups2(const char *group, const char *mapset, int *subgs_num)
{
    return list_subgroups(group, mapset, subgs_num);
}
 
/*!
 * \brief Prints maps in a subgroup (fancy version)
 *
 * \param group group name
 * \param subgroup subgroup name
 * \param ref group reference (set with I_get_subgroup_ref())
 * \param fd where to print (typically stdout)
 * \return 0
 */
int I_list_subgroup(const char *group, const char *subgroup,
                    const struct Ref *ref, FILE *fd)
{
    char buf[80];
    int i;
    int len, tot_len;
    int max;
 
    if (ref->nfiles <= 0) {
        fprintf(fd, _("subgroup <%s> of group <%s> is empty\n"), subgroup,
                group);
        return 0;
    }
    max = 0;
    for (i = 0; i < ref->nfiles; i++) {
        I__list_group_name_fit(buf, ref->file[i].name, ref->file[i].mapset);
        len = strlen(buf) + 4;
        if (len > max)
            max = len;
    }
    fprintf(
        fd,
        _("subgroup <%s> of group <%s> references the following raster maps\n"),
        subgroup, group);
    fprintf(fd, "-------------\n");
    tot_len = 0;
    for (i = 0; i < ref->nfiles; i++) {
        I__list_group_name_fit(buf, ref->file[i].name, ref->file[i].mapset);
        tot_len += max;
        if (tot_len > 78) {
            fprintf(fd, "\n");
            tot_len = max;
        }
        fprintf(fd, "%-*s", max, buf);
    }
    if (tot_len)
        fprintf(fd, "\n");
    fprintf(fd, "-------------\n");
 
    return 0;
}
 
/*!
 * \brief Prints maps in a subgroup (simple version)
 *
 * Same as I_list_subgroup(), but without all the fancy stuff.
 * Prints one map per line in map@mapset form.
 *
 * \param ref group reference (set with I_get_subgroup_ref())
 * \param fd where to print (typically stdout)
 * \return 0
 */
/* same as above, but one map per line in map@mapset form */
int I_list_subgroup_simple(const struct Ref *ref, FILE *fd)
{
    return I_list_group_simple(ref, fd);
}