---
name: "getdns_dict_set_bindata"
section: "3"
platform: "linux"
package: "getdns"
version: "1.7.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/getdns_dict_set_bindata"
---

# getdns\_dict\_set\_bindata(3)

## NAME

**getdns\_dict\_set,** **getdns\_dict\_set\_bindata,** **getdns\_dict\_set\_dict,** **getdns\_dict\_set\_int,** **getdns\_dict\_set\_list,** -- set a value by name in a getdns dict

## LIBRARY

DNS Resolver library (libgetdns, -lgetdns)

## SYNOPSIS

\#include \<getdns.h\>

getdns\_return\_t \
 **getdns\_dict\_set\_bindata** (getdns\_dict \*this\_dict,

char \*name,\
 getdns\_bindata \*child\_bindata)

getdns\_return\_t\
 **getdns\_dict\_set\_dict** (getdns\_dict \*this\_dict,

char \*name,\
 getdns\_dict \*child\_dict)

getdns\_return\_t \
 **getdns\_dict\_set\_int** (getdns\_dict \*this\_dict,

char \*name,\
 uint32\_t child\_uint32\_t)

getdns\_return\_t \
 **getdns\_dict\_set\_list** (getdns\_dict \*this\_dict,

char \*name,\
 getdns\_list \*child\_list)

## DESCRIPTION

The getdns\_dict type is used to manage name/value pairs in which the names are strings and the data types of the values are heterogeneous and include

getdns\_bindata\
 getdns\_dict\
 getdns\_list\
 uint32\_t

*this\_dict* the dictionary in which to add/update the name/value pair

*name* the name whose associated value is to be set.  If the name exists in the dictionary the value associated with that name is replaced, if the name does not exist in the  dictionary a new item is added to the dictionary.

*child\_bindata* *child\_dict* *child\_list* *child\_uint32* value to assign the name

## RETURN VALUES

Upon successful completion the functions return **GETDNS\_RETURN\_GOOD** , otherwise the following error values are returned:

**GETDNS\_RETURN\_GENERIC\_ERROR** if this\_dict is not a valid dictionary

## EXAMPLES

TBD

## SEE ALSO

[**libgetdns**(3)](/libgetdns/3.md), [**getdns\_address**(3)](/getdns_address/3.md), [**getdns\_dict**(3)](/getdns_dict/3.md), [**getdns\_dict\_get**(3)](/getdns_dict_get/3.md), [**getdns\_general**(3)](/getdns_general/3.md), [**getdns\_hostname**(3)](/getdns_hostname/3.md), [**getdns\_service**(3)](/getdns_service/3.md)