path: root/netaddr.go

package salticidae

// #include <stdlib.h>
// #include "salticidae/netaddr.h"
import "C"
import "runtime"

// The C pointer type for a NetAddr object
type CNetAddr = *C.netaddr_t
type netAddr struct {
    inner CNetAddr
    autoFree bool
}
// Network address object.
type NetAddr = *netAddr

// Convert an existing C pointer into a go object. Notice that when the go
// object does *not* own the resource of the C pointer, so it is only valid to
// the extent in which the given C pointer is valid. The C memory will not be
// deallocated when the go object is finalized by GC. This applies to all other
// "FromC" functions.
func NetAddrFromC(ptr CNetAddr) NetAddr {
    return &netAddr{ inner: ptr }
}

func netAddrSetFinalizer(res NetAddr, autoFree bool) {
    res.autoFree = autoFree
    if res != nil && autoFree {
        runtime.SetFinalizer(res, func(self NetAddr) { self.Free() })
    }
}

// Create NetAddr from a TCP socket format string (e.g. 127.0.0.1:8888).
func NewNetAddrFromIPPortString(addr string, autoFree bool, err *Error) (res NetAddr) {
    c_str := C.CString(addr)
    res = &netAddr{ inner: C.netaddr_new_from_sipport(c_str, err) }
    C.free(rawptr_t(c_str))
    netAddrSetFinalizer(res, autoFree)
    return
}

func (self NetAddr) Free() {
    C.netaddr_free(self.inner)
    if self.autoFree {
        runtime.SetFinalizer(self, nil)
    }
}

// Check if two addresses are the same.
func (self NetAddr) IsEq(other NetAddr) bool { return bool(C.netaddr_is_eq(self.inner, other.inner)) }

func (self NetAddr) IsNull() bool { return bool(C.netaddr_is_null(self.inner)) }

// Get the 32-bit IP representation.
func (self NetAddr) GetIP() uint32 { return uint32(C.netaddr_get_ip(self.inner)) }

// Get the 16-bit port number (in UNIX network byte order, so need to apply
// ntohs(), for example, to convert the returned integer to the local endianness).
func (self NetAddr) GetPort() uint16 { return uint16(C.netaddr_get_port(self.inner)) }

// Make a copy of the object. This is required if you want to keep the NetAddr
// returned (or passed as a callback parameter) by other salticidae methods
// (such like MsgNetwork/PeerNetwork), unless those method return a moved object.
func (self NetAddr) Copy(autoFree bool) NetAddr {
    res := &netAddr{ inner: C.netaddr_copy(self.inner) }
    netAddrSetFinalizer(res, autoFree)
    return res
}

// The C pointer type for a NetAddrArray object.
type CNetAddrArray = *C.netaddr_array_t
type netAddrArray struct {
    inner CNetAddrArray
    autoFree bool
}
// An array of network address.
type NetAddrArray = *netAddrArray

func NetAddrArrayFromC(ptr CNetAddrArray) NetAddrArray {
    return &netAddrArray{ inner: ptr }
}

func netAddrArraySetFinalizer(res NetAddrArray, autoFree bool) {
    res.autoFree = autoFree
    if res != nil && autoFree {
        runtime.SetFinalizer(res, func(self NetAddrArray) { self.Free() })
    }
}

// Convert a Go slice of net addresses to NetAddrArray.
func NewNetAddrArrayFromAddrs(arr []NetAddr, autoFree bool) (res NetAddrArray) {
    size := len(arr)
    _arr := make([]CNetAddr, size)
    for i, v := range arr {
        _arr[i] = v.inner
    }
    if size > 0 {
        // FIXME: here we assume struct of a single pointer has the same memory
        // footprint the pointer
        base := (**C.netaddr_t)(rawptr_t(&_arr[0]))
        res = NetAddrArrayFromC(C.netaddr_array_new_from_addrs(base, C.size_t(size)))
    } else {
        res = NetAddrArrayFromC(C.netaddr_array_new())
    }
    runtime.KeepAlive(_arr)
    netAddrArraySetFinalizer(res, autoFree)
    return
}

func (self NetAddrArray) Free() {
    C.netaddr_array_free(self.inner)
    if self.autoFree {
        runtime.SetFinalizer(self, nil)
    }
}