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

FreeBSD Manual Pages

  
 
  

home | help
NAME
       ck_rhs_fas -- fetch and store key in hash set

LIBRARY
       Concurrency Kit (libck, -lck)

SYNOPSIS
       #include	<ck_rhs.h>

       bool
       ck_rhs_fas(ck_rhs_t   *hs,   unsigned   long  hash,  const  void	 *key,
	   void	**previous);

DESCRIPTION
       The ck_rhs_fas(3) function will fetch and store the  key	 specified  by
       the key argument	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 argument (which was	previously generated using the	CK_RHS_HASH(3)
       macro).

       If  the	call to	ck_rhs_fas(3) was successful then the key specified by
       key was successfully stored in the hash set pointed to by hs.  The  key
       must already exist in the hash set, and is replaced by key and the pre-
       vious  value is stored into the void pointer pointed to by the previous
       argument. If the	key does not exist in the hash set then	 the  function
       will return false and the hash set is unchanged.	This function is guar-
       anteed to be stable with	respect	to memory usage.

RETURN VALUES
       Upon  successful	 completion,  ck_rhs_fas(3) returns true and otherwise
       returns false on	failure.

ERRORS
       Behavior	is undefined if	key or hs are uninitialized.

SEE ALSO
       ck_rhs_init(3),	ck_rhs_move(3),	  ck_rhs_destroy(3),   CK_RHS_HASH(3),
       ck_rhs_iterator_init(3),	 ck_rhs_next(3), ck_rhs_get(3),	ck_rhs_put(3),
       ck_rhs_put_unique(3),	     ck_rhs_remove(3),	       ck_rhs_grow(3),
       ck_rhs_rebuild(3),   ck_rhs_gc(3),   ck_rhs_count(3),  ck_rhs_reset(3),
       ck_rhs_reset_size(3), ck_rhs_stat(3)

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

				 June 20, 2013			 CK_RHS_FAS(3)

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

home | help