.\"  Automatically generated man page, do not edit
.TH QB_MAP_NOTIFY_ADD 3 2023-07-21 "LIBQB" "libqb Programmer's Manual"
.SH NAME
qb_map_notify_add \- Add a notifier to the map. 

.SH SYNOPSIS
.nf
.B #include <qb/qbmap.h>
.sp
\fBint32_t qb_map_notify_add\fP(
    \fBqb_map_t         *\fP\fIm\fP,\fR          /* the map instance */
\fP    /*
     * the key (or prefix) to attach the notification to.
     */
    \fBconst char       *\fP\fIkey\fP,
    \fBqb_map_notify_fn  \fP\fIfn\fP,\fR         /* the callback */
    \fBint32_t           \fP\fIevents\fP,\fR     /* the type of events to register for. */
    \fBvoid             *\fP\fIuser_data\fP\fR   /* a pointer to be passed into the callback*/
);
.fi
.SH PARAMS
\fBm         \fP\fIthe map instance \fP
.PP
\fBkey       \fP\fIthe key (or prefix) to attach the notification to. \fP
.PP
\fBfn        \fP\fIthe callback \fP
.PP
\fBevents    \fP\fIthe type of events to register for. \fP
.PP
\fBuser_data \fP\fIa pointer to be passed into the callback\fP
.PP
.SH DESCRIPTION
.RE
.SH RETURN VALUE
.PP
\fB0          \fPsuccess 
.PP
\fB-errno     \fPfailure 
.PP
.SH NOTE
.PP
you can use key prefixes with trie maps.
.SH SEE ALSO
.PP
.nh
.ad l
\fIqb_trie_dump\fR(3), \fIqb_map_iter_create\fR(3), \fIqb_skiplist_create\fR(3), \fIqb_map_notify_del\fR(3), \fIqb_map_put\fR(3), \fIqb_map_count_get\fR(3), \fIqb_map_foreach\fR(3), \fIqb_map_pref_iter_create\fR(3), \fIqb_map_iter_next\fR(3), \fIqb_map_get\fR(3), \fIqb_map_destroy\fR(3), \fIqb_hashtable_create\fR(3), \fIqb_map_iter_free\fR(3), \fIqb_trie_create\fR(3), \fIqb_map_notify_del_2\fR(3), \fIqb_map_rm\fR(3)
.ad
.hy
.SH "COPYRIGHT"
.PP
Copyright (C) 2010-2020 Red Hat, Inc.