# 22. Virtuoso Functions Guide - dict_put

Chapter Contents | Prev | Next
Keyword Search:
www.openlinksw.com
docs.openlinksw.com
Book Home
Contents
Preface
Virtuoso Functions Guide
Administration
Aggregate Functions
Array Manipulation
BPEL APIs
Backup
Compression
Cursor
Date & Time Manipulation
Debug
Dictionary Manipulation
dict_duplicate
dict_get
dict_list_keys
dict_new
dict_put
dict_remove
dict_to_vector
Encoding & Decoding
File Manipulation
Free Text
Hashing / Cryptographic
LDAP
Locale
Mail
Miscellaneous
Number
Remote SQL Data Source
Replication
SOAP
SQL
String
Transaction
Type Mapping
UDDI
User Defined Types & The CLR
Virtuoso Java PL API
Virtuoso Server Extension Interface (VSEI)
Web Server & Internet
XML
XPATH & XQUERY
Functions Index

## dict_put

Adds a key-value pair to a dictionary
int dict_put (inout dict dictionary, in key any, in value any);
Description

The function adds or updates a key-value pair in the given dictionary. If the dictionary contains a pair with the key part equivalent to the given one then old value is replaced with a new one. Otherwise, a new pair is added to the dictionary.

Parameters
dict – The dictionary to be updated or extended.
key – The key part of the dictionary pair to be added or updated.
value – The dependent part of the pair.
Return Types

The function returns the total number of pairs stored in the dictionary as counted after the modification.

See Also

dict_new

dict_get

dict_remove

dict_duplicate

dict_to_vector

dict_list_keys