Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NAME
       ck_hs_put -- store unique key into a hash set

LIBRARY
       Concurrency Kit (libck, -lck)

SYNOPSIS
       #include	<ck_hs.h>

       bool
       ck_hs_put(ck_hs_t *hs, unsigned long hash, const	void *key);

DESCRIPTION
       The ck_hs_put(3)	function will store the	key specified by the key argu-
       ment  in	 the hash set pointed to by the	hs argument. The key specified
       by key is expected to have the hash value specified by the  hash	 argu-
       ment (which was previously generated using the CK_HS_HASH(3) macro).

       If  the	call  to ck_hs_put(3) was successful then the key specified by
       key was successfully stored in the hash set  pointed  to	 by  hs.   The
       function	 will fail if a	key with an equivalent value to	key is already
       present in the hash set.	For  replacement  semantics,  please  see  the
       ck_hs_set(3) function.

RETURN VALUES
       Upon successful completion, ck_hs_put(3)	returns	true and otherwise re-
       turns false on failure.

ERRORS
       Behavior	is undefined if	key or hs are uninitialized. The function will
       also  return  false if the hash set could not be	enlarged to accomodate
       key insertion.

SEE ALSO
       ck_hs_init(3),	 ck_hs_move(3),	   ck_hs_destroy(3),	CK_HS_HASH(3),
       ck_hs_iterator_init(3),	     ck_hs_next(3),	  ck_hs_put_unique(3),
       ck_hs_get(3),	 ck_hs_set(3),	   ck_hs_fas(3),      ck_hs_remove(3),
       ck_hs_grow(3),	  ck_hs_rebuild(3),    ck_hs_gc(3),    ck_hs_count(3),
       ck_hs_reset(3), ck_hs_reset_size(3), ck_hs_stat(3)

       Additional information available	at http://concurrencykit.org/

			      September	17, 2012		  CK_HS_PUT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ck_hs_put&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help