laag-libczmq 4.1.0.0

data/vendor/github.com/zeromq/czmq/bindings/ruby/lib/czmq/ffi/zhash.rb

@@ -0,0 +1,386 @@
+################################################################################
+#  THIS FILE IS 100% GENERATED BY ZPROJECT; DO NOT EDIT EXCEPT EXPERIMENTALLY  #
+#  Read the zproject/README.md for information about making permanent changes. #
+################################################################################
+
+module CZMQ
+  module FFI
+
+    # generic type-free hash container (simple)
+    # @note This class is 100% generated using zproject.
+    class Zhash
+      # Raised when one tries to use an instance of {Zhash} after
+      # the internal pointer to the native object has been nullified.
+      class DestroyedError < RuntimeError; end
+
+      # Boilerplate for self pointer, initializer, and finalizer
+      class << self
+        alias :__new :new
+      end
+      # Attaches the pointer _ptr_ to this instance and defines a finalizer for
+      # it if necessary.
+      # @param ptr [::FFI::Pointer]
+      # @param finalize [Boolean]
+      def initialize(ptr, finalize = true)
+        @ptr = ptr
+        if @ptr.null?
+          @ptr = nil # Remove null pointers so we don't have to test for them.
+        elsif finalize
+          @finalizer = self.class.create_finalizer_for @ptr
+          ObjectSpace.define_finalizer self, @finalizer
+        end
+      end
+      # @param ptr [::FFI::Pointer]
+      # @return [Proc]
+      def self.create_finalizer_for(ptr)
+        Proc.new do
+          ptr_ptr = ::FFI::MemoryPointer.new :pointer
+          ptr_ptr.write_pointer ptr
+          ::CZMQ::FFI.zhash_destroy ptr_ptr
+        end
+      end
+      # @return [Boolean]
+      def null?
+        !@ptr or @ptr.null?
+      end
+      # Return internal pointer
+      # @return [::FFI::Pointer]
+      def __ptr
+        raise DestroyedError unless @ptr
+        @ptr
+      end
+      # So external Libraries can just pass the Object to a FFI function which expects a :pointer
+      alias_method :to_ptr, :__ptr
+      # Nullify internal pointer and return pointer pointer.
+      # @note This detaches the current instance from the native object
+      #   and thus makes it unusable.
+      # @return [::FFI::MemoryPointer] the pointer pointing to a pointer
+      #   pointing to the native object
+      def __ptr_give_ref
+        raise DestroyedError unless @ptr
+        ptr_ptr = ::FFI::MemoryPointer.new :pointer
+        ptr_ptr.write_pointer @ptr
+        __undef_finalizer if @finalizer
+        @ptr = nil
+        ptr_ptr
+      end
+      # Undefines the finalizer for this object.
+      # @note Only use this if you need to and can guarantee that the native
+      #   object will be freed by other means.
+      # @return [void]
+      def __undef_finalizer
+        ObjectSpace.undefine_finalizer self
+        @finalizer = nil
+      end
+
+      # Create a new callback of the following type:
+      # Callback function for zhash_freefn method
+      #     typedef void (zhash_free_fn) (
+      #         void *data);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.free_fn
+        ::FFI::Function.new :void, [:pointer], blocking: true do |data|
+          result = yield data
+          result
+        end
+      end
+
+      # Create a new, empty hash container
+      # @return [CZMQ::Zhash]
+      def self.new()
+        ptr = ::CZMQ::FFI.zhash_new()
+        __new ptr
+      end
+
+      # Unpack binary frame into a new hash table. Packed data must follow format
+      # defined by zhash_pack. Hash table is set to autofree. An empty frame
+      # unpacks to an empty hash table.
+      # @param frame [Zframe, #__ptr]
+      # @return [CZMQ::Zhash]
+      def self.unpack(frame)
+        frame = frame.__ptr if frame
+        ptr = ::CZMQ::FFI.zhash_unpack(frame)
+        __new ptr
+      end
+
+      # Destroy a hash container and all items in it
+      #
+      # @return [void]
+      def destroy()
+        return unless @ptr
+        self_p = __ptr_give_ref
+        result = ::CZMQ::FFI.zhash_destroy(self_p)
+        result
+      end
+
+      # Insert item into hash table with specified key and item.
+      # If key is already present returns -1 and leaves existing item unchanged
+      # Returns 0 on success.
+      #
+      # @param key [String, #to_s, nil]
+      # @param item [::FFI::Pointer, #to_ptr]
+      # @return [Integer]
+      def insert(key, item)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_insert(self_p, key, item)
+        result
+      end
+
+      # Update item into hash table with specified key and item.
+      # If key is already present, destroys old item and inserts new one.
+      # Use free_fn method to ensure deallocator is properly called on item.
+      #
+      # @param key [String, #to_s, nil]
+      # @param item [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def update(key, item)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_update(self_p, key, item)
+        result
+      end
+
+      # Remove an item specified by key from the hash table. If there was no such
+      # item, this function does nothing.
+      #
+      # @param key [String, #to_s, nil]
+      # @return [void]
+      def delete(key)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_delete(self_p, key)
+        result
+      end
+
+      # Return the item at the specified key, or null
+      #
+      # @param key [String, #to_s, nil]
+      # @return [::FFI::Pointer]
+      def lookup(key)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_lookup(self_p, key)
+        result
+      end
+
+      # Reindexes an item from an old key to a new key. If there was no such
+      # item, does nothing. Returns 0 if successful, else -1.
+      #
+      # @param old_key [String, #to_s, nil]
+      # @param new_key [String, #to_s, nil]
+      # @return [Integer]
+      def rename(old_key, new_key)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_rename(self_p, old_key, new_key)
+        result
+      end
+
+      # Set a free function for the specified hash table item. When the item is
+      # destroyed, the free function, if any, is called on that item.
+      # Use this when hash items are dynamically allocated, to ensure that
+      # you don't have memory leaks. You can pass 'free' or NULL as a free_fn.
+      # Returns the item, or NULL if there is no such item.
+      #
+      # @param key [String, #to_s, nil]
+      # @param free_fn [::FFI::Pointer, #to_ptr]
+      # @return [::FFI::Pointer]
+      def freefn(key, free_fn)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_freefn(self_p, key, free_fn)
+        result
+      end
+
+      # Return the number of keys/items in the hash table
+      #
+      # @return [Integer]
+      def size()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_size(self_p)
+        result
+      end
+
+      # Make copy of hash table; if supplied table is null, returns null.
+      # Does not copy items themselves. Rebuilds new table so may be slow on
+      # very large tables. NOTE: only works with item values that are strings
+      # since there's no other way to know how to duplicate the item value.
+      #
+      # @return [Zhash]
+      def dup()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_dup(self_p)
+        result = Zhash.__new result, true
+        result
+      end
+
+      # Return keys for items in table
+      #
+      # @return [Zlist]
+      def keys()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_keys(self_p)
+        result = Zlist.__new result, true
+        result
+      end
+
+      # Simple iterator; returns first item in hash table, in no given order,
+      # or NULL if the table is empty. This method is simpler to use than the
+      # foreach() method, which is deprecated. To access the key for this item
+      # use zhash_cursor(). NOTE: do NOT modify the table while iterating.
+      #
+      # @return [::FFI::Pointer]
+      def first()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_first(self_p)
+        result
+      end
+
+      # Simple iterator; returns next item in hash table, in no given order,
+      # or NULL if the last item was already returned. Use this together with
+      # zhash_first() to process all items in a hash table. If you need the
+      # items in sorted order, use zhash_keys() and then zlist_sort(). To
+      # access the key for this item use zhash_cursor(). NOTE: do NOT modify
+      # the table while iterating.
+      #
+      # @return [::FFI::Pointer]
+      def next()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_next(self_p)
+        result
+      end
+
+      # After a successful first/next method, returns the key for the item that
+      # was returned. This is a constant string that you may not modify or
+      # deallocate, and which lasts as long as the item in the hash. After an
+      # unsuccessful first/next, returns NULL.
+      #
+      # @return [String]
+      def cursor()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_cursor(self_p)
+        result
+      end
+
+      # Add a comment to hash table before saving to disk. You can add as many
+      # comment lines as you like. These comment lines are discarded when loading
+      # the file. If you use a null format, all comments are deleted.
+      #
+      # @param format [String, #to_s, nil]
+      # @param args [Array<Object>] see https://github.com/ffi/ffi/wiki/examples#using-varargs
+      # @return [void]
+      def comment(format, *args)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_comment(self_p, format, *args)
+        result
+      end
+
+      # Serialize hash table to a binary frame that can be sent in a message.
+      # The packed format is compatible with the 'dictionary' type defined in
+      # http://rfc.zeromq.org/spec:35/FILEMQ, and implemented by zproto:
+      #
+      #    ; A list of name/value pairs
+      #    dictionary      = dict-count *( dict-name dict-value )
+      #    dict-count      = number-4
+      #    dict-value      = longstr
+      #    dict-name       = string
+      #
+      #    ; Strings are always length + text contents
+      #    longstr         = number-4 *VCHAR
+      #    string          = number-1 *VCHAR
+      #
+      #    ; Numbers are unsigned integers in network byte order
+      #    number-1        = 1OCTET
+      #    number-4        = 4OCTET
+      #
+      # Comments are not included in the packed data. Item values MUST be
+      # strings.
+      #
+      # @return [Zframe]
+      def pack()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_pack(self_p)
+        result = Zframe.__new result, true
+        result
+      end
+
+      # Save hash table to a text file in name=value format. Hash values must be
+      # printable strings; keys may not contain '=' character. Returns 0 if OK,
+      # else -1 if a file error occurred.
+      #
+      # @param filename [String, #to_s, nil]
+      # @return [Integer]
+      def save(filename)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_save(self_p, filename)
+        result
+      end
+
+      # Load hash table from a text file in name=value format; hash table must
+      # already exist. Hash values must printable strings; keys may not contain
+      # '=' character. Returns 0 if OK, else -1 if a file was not readable.
+      #
+      # @param filename [String, #to_s, nil]
+      # @return [Integer]
+      def load(filename)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_load(self_p, filename)
+        result
+      end
+
+      # When a hash table was loaded from a file by zhash_load, this method will
+      # reload the file if it has been modified since, and is "stable", i.e. not
+      # still changing. Returns 0 if OK, -1 if there was an error reloading the
+      # file.
+      #
+      # @return [Integer]
+      def refresh()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_refresh(self_p)
+        result
+      end
+
+      # Set hash for automatic value destruction. Note that this assumes that
+      # values are NULL-terminated strings. Do not use with different types.
+      #
+      # @return [void]
+      def autofree()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhash_autofree(self_p)
+        result
+      end
+
+      # Self test of this class.
+      #
+      # @param verbose [Boolean]
+      # @return [void]
+      def self.test(verbose)
+        verbose = !(0==verbose||!verbose) # boolean
+        result = ::CZMQ::FFI.zhash_test(verbose)
+        result
+      end
+    end
+  end
+end
+
+################################################################################
+#  THIS FILE IS 100% GENERATED BY ZPROJECT; DO NOT EDIT EXCEPT EXPERIMENTALLY  #
+#  Read the zproject/README.md for information about making permanent changes. #
+################################################################################

data/vendor/github.com/zeromq/czmq/bindings/ruby/lib/czmq/ffi/zhashx.rb

@@ -0,0 +1,617 @@
+################################################################################
+#  THIS FILE IS 100% GENERATED BY ZPROJECT; DO NOT EDIT EXCEPT EXPERIMENTALLY  #
+#  Read the zproject/README.md for information about making permanent changes. #
+################################################################################
+
+module CZMQ
+  module FFI
+
+    # extended generic type-free hash container
+    # @note This class is 100% generated using zproject.
+    class Zhashx
+      # Raised when one tries to use an instance of {Zhashx} after
+      # the internal pointer to the native object has been nullified.
+      class DestroyedError < RuntimeError; end
+
+      # Boilerplate for self pointer, initializer, and finalizer
+      class << self
+        alias :__new :new
+      end
+      # Attaches the pointer _ptr_ to this instance and defines a finalizer for
+      # it if necessary.
+      # @param ptr [::FFI::Pointer]
+      # @param finalize [Boolean]
+      def initialize(ptr, finalize = true)
+        @ptr = ptr
+        if @ptr.null?
+          @ptr = nil # Remove null pointers so we don't have to test for them.
+        elsif finalize
+          @finalizer = self.class.create_finalizer_for @ptr
+          ObjectSpace.define_finalizer self, @finalizer
+        end
+      end
+      # @param ptr [::FFI::Pointer]
+      # @return [Proc]
+      def self.create_finalizer_for(ptr)
+        Proc.new do
+          ptr_ptr = ::FFI::MemoryPointer.new :pointer
+          ptr_ptr.write_pointer ptr
+          ::CZMQ::FFI.zhashx_destroy ptr_ptr
+        end
+      end
+      # @return [Boolean]
+      def null?
+        !@ptr or @ptr.null?
+      end
+      # Return internal pointer
+      # @return [::FFI::Pointer]
+      def __ptr
+        raise DestroyedError unless @ptr
+        @ptr
+      end
+      # So external Libraries can just pass the Object to a FFI function which expects a :pointer
+      alias_method :to_ptr, :__ptr
+      # Nullify internal pointer and return pointer pointer.
+      # @note This detaches the current instance from the native object
+      #   and thus makes it unusable.
+      # @return [::FFI::MemoryPointer] the pointer pointing to a pointer
+      #   pointing to the native object
+      def __ptr_give_ref
+        raise DestroyedError unless @ptr
+        ptr_ptr = ::FFI::MemoryPointer.new :pointer
+        ptr_ptr.write_pointer @ptr
+        __undef_finalizer if @finalizer
+        @ptr = nil
+        ptr_ptr
+      end
+      # Undefines the finalizer for this object.
+      # @note Only use this if you need to and can guarantee that the native
+      #   object will be freed by other means.
+      # @return [void]
+      def __undef_finalizer
+        ObjectSpace.undefine_finalizer self
+        @finalizer = nil
+      end
+
+      # Create a new callback of the following type:
+      # Destroy an item
+      #     typedef void (zhashx_destructor_fn) (
+      #         void **item);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.destructor_fn
+        ::FFI::Function.new :void, [:pointer], blocking: true do |item|
+          result = yield item
+          result
+        end
+      end
+
+      # Create a new callback of the following type:
+      # Duplicate an item
+      #     typedef void * (zhashx_duplicator_fn) (
+      #         const void *item);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.duplicator_fn
+        ::FFI::Function.new :pointer, [:pointer], blocking: true do |item|
+          result = yield item
+          result
+        end
+      end
+
+      # Create a new callback of the following type:
+      # Compare two items, for sorting
+      #     typedef int (zhashx_comparator_fn) (
+      #         const void *item1, const void *item2);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.comparator_fn
+        ::FFI::Function.new :int, [:pointer, :pointer], blocking: true do |item1, item2|
+          result = yield item1, item2
+          result = Integer(result)
+          result
+        end
+      end
+
+      # Create a new callback of the following type:
+      # Destroy an item.
+      #     typedef void (zhashx_free_fn) (
+      #         void *data);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.free_fn
+        ::FFI::Function.new :void, [:pointer], blocking: true do |data|
+          result = yield data
+          result
+        end
+      end
+
+      # Create a new callback of the following type:
+      # Hash function for keys.
+      #     typedef size_t (zhashx_hash_fn) (
+      #         const void *key);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.hash_fn
+        ::FFI::Function.new :size_t, [:pointer], blocking: true do |key|
+          result = yield key
+          result = Integer(result)
+          result
+        end
+      end
+
+      # Create a new callback of the following type:
+      # Serializes an item to a longstr.
+      # The caller takes ownership of the newly created object.
+      #     typedef char * (zhashx_serializer_fn) (
+      #         const void *item);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.serializer_fn
+        ::FFI::Function.new :pointer, [:pointer], blocking: true do |item|
+          result = yield item
+          result
+        end
+      end
+
+      # Create a new callback of the following type:
+      # Deserializes a longstr into an item.
+      # The caller takes ownership of the newly created object.
+      #     typedef void * (zhashx_deserializer_fn) (
+      #         const char *item_str);
+      #
+      # @note WARNING: If your Ruby code doesn't retain a reference to the
+      #   FFI::Function object after passing it to a C function call,
+      #   it may be garbage collected while C still holds the pointer,
+      #   potentially resulting in a segmentation fault.
+      def self.deserializer_fn
+        ::FFI::Function.new :pointer, [:string], blocking: true do |item_str|
+          result = yield item_str
+          result
+        end
+      end
+
+      # Create a new, empty hash container
+      # @return [CZMQ::Zhashx]
+      def self.new()
+        ptr = ::CZMQ::FFI.zhashx_new()
+        __new ptr
+      end
+
+      # Unpack binary frame into a new hash table. Packed data must follow format
+      # defined by zhashx_pack. Hash table is set to autofree. An empty frame
+      # unpacks to an empty hash table.
+      # @param frame [Zframe, #__ptr]
+      # @return [CZMQ::Zhashx]
+      def self.unpack(frame)
+        frame = frame.__ptr if frame
+        ptr = ::CZMQ::FFI.zhashx_unpack(frame)
+        __new ptr
+      end
+
+      # Same as unpack but uses a user-defined deserializer function to convert
+      # a longstr back into item format.
+      # @param frame [Zframe, #__ptr]
+      # @param deserializer [::FFI::Pointer, #to_ptr]
+      # @return [CZMQ::Zhashx]
+      def self.unpack_own(frame, deserializer)
+        frame = frame.__ptr if frame
+        ptr = ::CZMQ::FFI.zhashx_unpack_own(frame, deserializer)
+        __new ptr
+      end
+
+      # Destroy a hash container and all items in it
+      #
+      # @return [void]
+      def destroy()
+        return unless @ptr
+        self_p = __ptr_give_ref
+        result = ::CZMQ::FFI.zhashx_destroy(self_p)
+        result
+      end
+
+      # Insert item into hash table with specified key and item.
+      # If key is already present returns -1 and leaves existing item unchanged
+      # Returns 0 on success.
+      #
+      # @param key [::FFI::Pointer, #to_ptr]
+      # @param item [::FFI::Pointer, #to_ptr]
+      # @return [Integer]
+      def insert(key, item)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_insert(self_p, key, item)
+        result
+      end
+
+      # Update or insert item into hash table with specified key and item. If the
+      # key is already present, destroys old item and inserts new one. If you set
+      # a container item destructor, this is called on the old value. If the key
+      # was not already present, inserts a new item. Sets the hash cursor to the
+      # new item.
+      #
+      # @param key [::FFI::Pointer, #to_ptr]
+      # @param item [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def update(key, item)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_update(self_p, key, item)
+        result
+      end
+
+      # Remove an item specified by key from the hash table. If there was no such
+      # item, this function does nothing.
+      #
+      # @param key [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def delete(key)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_delete(self_p, key)
+        result
+      end
+
+      # Delete all items from the hash table. If the key destructor is
+      # set, calls it on every key. If the item destructor is set, calls
+      # it on every item.
+      #
+      # @return [void]
+      def purge()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_purge(self_p)
+        result
+      end
+
+      # Return the item at the specified key, or null
+      #
+      # @param key [::FFI::Pointer, #to_ptr]
+      # @return [::FFI::Pointer]
+      def lookup(key)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_lookup(self_p, key)
+        result
+      end
+
+      # Reindexes an item from an old key to a new key. If there was no such
+      # item, does nothing. Returns 0 if successful, else -1.
+      #
+      # @param old_key [::FFI::Pointer, #to_ptr]
+      # @param new_key [::FFI::Pointer, #to_ptr]
+      # @return [Integer]
+      def rename(old_key, new_key)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_rename(self_p, old_key, new_key)
+        result
+      end
+
+      # Set a free function for the specified hash table item. When the item is
+      # destroyed, the free function, if any, is called on that item.
+      # Use this when hash items are dynamically allocated, to ensure that
+      # you don't have memory leaks. You can pass 'free' or NULL as a free_fn.
+      # Returns the item, or NULL if there is no such item.
+      #
+      # @param key [::FFI::Pointer, #to_ptr]
+      # @param free_fn [::FFI::Pointer, #to_ptr]
+      # @return [::FFI::Pointer]
+      def freefn(key, free_fn)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_freefn(self_p, key, free_fn)
+        result
+      end
+
+      # Return the number of keys/items in the hash table
+      #
+      # @return [Integer]
+      def size()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_size(self_p)
+        result
+      end
+
+      # Return a zlistx_t containing the keys for the items in the
+      # table. Uses the key_duplicator to duplicate all keys and sets the
+      # key_destructor as destructor for the list.
+      #
+      # @return [Zlistx]
+      def keys()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_keys(self_p)
+        result = Zlistx.__new result, true
+        result
+      end
+
+      # Return a zlistx_t containing the values for the items in the
+      # table. Uses the duplicator to duplicate all items and sets the
+      # destructor as destructor for the list.
+      #
+      # @return [Zlistx]
+      def values()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_values(self_p)
+        result = Zlistx.__new result, true
+        result
+      end
+
+      # Simple iterator; returns first item in hash table, in no given order,
+      # or NULL if the table is empty. This method is simpler to use than the
+      # foreach() method, which is deprecated. To access the key for this item
+      # use zhashx_cursor(). NOTE: do NOT modify the table while iterating.
+      #
+      # @return [::FFI::Pointer]
+      def first()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_first(self_p)
+        result
+      end
+
+      # Simple iterator; returns next item in hash table, in no given order,
+      # or NULL if the last item was already returned. Use this together with
+      # zhashx_first() to process all items in a hash table. If you need the
+      # items in sorted order, use zhashx_keys() and then zlistx_sort(). To
+      # access the key for this item use zhashx_cursor(). NOTE: do NOT modify
+      # the table while iterating.
+      #
+      # @return [::FFI::Pointer]
+      def next()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_next(self_p)
+        result
+      end
+
+      # After a successful first/next method, returns the key for the item that
+      # was returned. This is a constant string that you may not modify or
+      # deallocate, and which lasts as long as the item in the hash. After an
+      # unsuccessful first/next, returns NULL.
+      #
+      # @return [::FFI::Pointer]
+      def cursor()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_cursor(self_p)
+        result
+      end
+
+      # Add a comment to hash table before saving to disk. You can add as many
+      # comment lines as you like. These comment lines are discarded when loading
+      # the file. If you use a null format, all comments are deleted.
+      #
+      # @param format [String, #to_s, nil]
+      # @param args [Array<Object>] see https://github.com/ffi/ffi/wiki/examples#using-varargs
+      # @return [void]
+      def comment(format, *args)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_comment(self_p, format, *args)
+        result
+      end
+
+      # Save hash table to a text file in name=value format. Hash values must be
+      # printable strings; keys may not contain '=' character. Returns 0 if OK,
+      # else -1 if a file error occurred.
+      #
+      # @param filename [String, #to_s, nil]
+      # @return [Integer]
+      def save(filename)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_save(self_p, filename)
+        result
+      end
+
+      # Load hash table from a text file in name=value format; hash table must
+      # already exist. Hash values must printable strings; keys may not contain
+      # '=' character. Returns 0 if OK, else -1 if a file was not readable.
+      #
+      # @param filename [String, #to_s, nil]
+      # @return [Integer]
+      def load(filename)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_load(self_p, filename)
+        result
+      end
+
+      # When a hash table was loaded from a file by zhashx_load, this method will
+      # reload the file if it has been modified since, and is "stable", i.e. not
+      # still changing. Returns 0 if OK, -1 if there was an error reloading the
+      # file.
+      #
+      # @return [Integer]
+      def refresh()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_refresh(self_p)
+        result
+      end
+
+      # Serialize hash table to a binary frame that can be sent in a message.
+      # The packed format is compatible with the 'dictionary' type defined in
+      # http://rfc.zeromq.org/spec:35/FILEMQ, and implemented by zproto:
+      #
+      #    ; A list of name/value pairs
+      #    dictionary      = dict-count *( dict-name dict-value )
+      #    dict-count      = number-4
+      #    dict-value      = longstr
+      #    dict-name       = string
+      #
+      #    ; Strings are always length + text contents
+      #    longstr         = number-4 *VCHAR
+      #    string          = number-1 *VCHAR
+      #
+      #    ; Numbers are unsigned integers in network byte order
+      #    number-1        = 1OCTET
+      #    number-4        = 4OCTET
+      #
+      # Comments are not included in the packed data. Item values MUST be
+      # strings.
+      #
+      # @return [Zframe]
+      def pack()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_pack(self_p)
+        result = Zframe.__new result, true
+        result
+      end
+
+      # Same as pack but uses a user-defined serializer function to convert items
+      # into longstr.
+      #
+      # @param serializer [::FFI::Pointer, #to_ptr]
+      # @return [Zframe]
+      def pack_own(serializer)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_pack_own(self_p, serializer)
+        result = Zframe.__new result, true
+        result
+      end
+
+      # Make a copy of the list; items are duplicated if you set a duplicator
+      # for the list, otherwise not. Copying a null reference returns a null
+      # reference. Note that this method's behavior changed slightly for CZMQ
+      # v3.x, as it does not set nor respect autofree. It does however let you
+      # duplicate any hash table safely. The old behavior is in zhashx_dup_v2.
+      #
+      # @return [Zhashx]
+      def dup()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_dup(self_p)
+        result = Zhashx.__new result, true
+        result
+      end
+
+      # Set a user-defined deallocator for hash items; by default items are not
+      # freed when the hash is destroyed.
+      #
+      # @param destructor [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def set_destructor(destructor)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_set_destructor(self_p, destructor)
+        result
+      end
+
+      # Set a user-defined duplicator for hash items; by default items are not
+      # copied when the hash is duplicated.
+      #
+      # @param duplicator [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def set_duplicator(duplicator)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_set_duplicator(self_p, duplicator)
+        result
+      end
+
+      # Set a user-defined deallocator for keys; by default keys are freed
+      # when the hash is destroyed using free().
+      #
+      # @param destructor [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def set_key_destructor(destructor)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_set_key_destructor(self_p, destructor)
+        result
+      end
+
+      # Set a user-defined duplicator for keys; by default keys are duplicated
+      # using strdup.
+      #
+      # @param duplicator [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def set_key_duplicator(duplicator)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_set_key_duplicator(self_p, duplicator)
+        result
+      end
+
+      # Set a user-defined comparator for keys; by default keys are
+      # compared using strcmp.
+      # The callback function should return zero (0) on matching
+      # items.
+      #
+      # @param comparator [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def set_key_comparator(comparator)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_set_key_comparator(self_p, comparator)
+        result
+      end
+
+      # Set a user-defined hash function for keys; by default keys are
+      # hashed by a modified Bernstein hashing function.
+      #
+      # @param hasher [::FFI::Pointer, #to_ptr]
+      # @return [void]
+      def set_key_hasher(hasher)
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_set_key_hasher(self_p, hasher)
+        result
+      end
+
+      # Make copy of hash table; if supplied table is null, returns null.
+      # Does not copy items themselves. Rebuilds new table so may be slow on
+      # very large tables. NOTE: only works with item values that are strings
+      # since there's no other way to know how to duplicate the item value.
+      #
+      # @return [Zhashx]
+      def dup_v2()
+        raise DestroyedError unless @ptr
+        self_p = @ptr
+        result = ::CZMQ::FFI.zhashx_dup_v2(self_p)
+        result = Zhashx.__new result, false
+        result
+      end
+
+      # Self test of this class.
+      #
+      # @param verbose [Boolean]
+      # @return [void]
+      def self.test(verbose)
+        verbose = !(0==verbose||!verbose) # boolean
+        result = ::CZMQ::FFI.zhashx_test(verbose)
+        result
+      end
+    end
+  end
+end
+
+################################################################################
+#  THIS FILE IS 100% GENERATED BY ZPROJECT; DO NOT EDIT EXCEPT EXPERIMENTALLY  #
+#  Read the zproject/README.md for information about making permanent changes. #
+################################################################################