---
name: "genders_getmaxnodelen"
section: "3"
platform: "linux"
package: "libgenders0-dev"
version: "1.27-3-3.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/genders_getnumnodes"
---

# genders\_getmaxnodelen(3)

genders statistics routines

Part of [genders\_getnumnodes(3)](/genders_getnumnodes/3.md).

## NAME

genders\_getnumnodes, genders\_getnumattrs, genders\_getmaxattrs, genders\_getmaxnodelen, genders\_getmaxattrlen, genders\_getmaxvallen - genders statistics routines

## SYNOPSIS

**#include \<genders.h\>**

**int genders\_getnumnodes(genders\_t handle);**

**int genders\_getnumattrs(genders\_t handle);**

**int genders\_getmaxattrs(genders\_t handle);**

**int genders\_getmaxnodelen(genders\_t handle);**

**int genders\_getmaxattrlen(genders\_t handle);**

**int genders\_getmaxvallen(genders\_t handle);**\

## DESCRIPTION

**genders\_getnumnodes()**, **genders\_getnumattrs()**, **genders\_getmaxattrs()**, **genders\_getmaxnodelen()**, **genders\_getmaxattrlen()**, and **genders\_getmaxvallen()** get statistics about the genders file associated with *handle*.

**genders\_getnumnodes()** returns the number of nodes stored in the genders file.

**genders\_getnumattrs()** returns the number of attributes listed in the genders file.

**genders\_getmaxattrs()** returns the maximum number of attributes listed with a node in the genders file.

**genders\_getmaxnodelen()** returns the maximum length of any node listed in the genders file.

**genders\_getmaxattrlen()** returns the maximum length of any attribute listed in the genders file.

**genders\_getmaxvallen()** returns the maximum length of any attribute value listed in the genders file.

In general, **genders\_getnumnodes()**, **genders\_getnumattrs()**, **genders\_getmaxattrs()**, **genders\_getmaxnodelen()**, **genders\_getmaxattrlen()**, and **genders\_getmaxvallen()** are used so a programmer can dynamically allocate a proper amount of memory to store genders file information in.\

## RETURN VALUES

On success, 0 is returned.  On error, -1 is returned, and an error code is returned in *handle*.  The error code can be retrieved via [**genders\_errnum**(3)](/genders_errnum/3.md) , and a description of the error code can be retrieved via  [**genders\_strerror**(3)](/genders_strerror/3.md). Error codes are defined in genders.h.\

## ERRORS

- **GENDERS\_ERR\_NULLHANDLE**

  The *handle* parameter is NULL.  The genders handle must be created with [**genders\_handle\_create**(3)](/genders_handle_create/3.md).

- **GENDERS\_ERR\_NOTLOADED**

  [**genders\_load\_data**(3)](/genders_load_data/3.md) has not been called to load genders data.

- **GENDERS\_ERR\_MAGIC**

  *handle* has an incorrect magic number.  *handle* does not point to a genders handle or *handle* has been destroyed by [**genders\_handle\_destroy**(3)](/genders_handle_destroy/3.md).\

## FILES

/usr/include/genders.h

## SEE ALSO

[libgenders(3)](/libgenders/3.md), [genders\_handle\_create(3)](/genders_handle_create/3.md), [genders\_load\_data(3)](/genders_load_data/3.md), [genders\_errnum(3)](/genders_errnum/3.md), [genders\_strerror(3)](/genders_strerror/3.md)