go-safecast is a utility function package for safe casting between primitive data types of Go. The following shows an unsafe cast example that causes cast overflow problems, but the unsafe casting is not detected at runtime and compile time.

package main

import (
    "fmt"
    "math"
)

func main() {
    from := math.MaxInt8 + 1
    to := int8(from)
    fmt.Printf("%v != %v", to, from)

    // Output:
    // -128 != 128
}

go-safecast provides utility functions for safe casting, and raises an error if the casting is unsafe as the following.

package main

import (
    "github.com/cybergarage/go-safecast/safecast"
)

func main() {
    from := math.MaxInt8 + 1
    var to int8
    err := safecast.FromInt(from, &to)
    if err := nil {
        fmt.Println(err.Error())
    }

    // Output:
    // cast error : out of range 128 > *int8
}

Currently, go-safecast provides the following safe casting functions.Please see to know the functions and examples in more detail.

The To functions allow you to convert from various types to a specific type, ensuring that the conversion is safe and within the bounds of the target type.

The From functions allow you to convert from various types to a specific type, ensuring that the conversion is safe and within the bounds of the target type. If the conversion is not safe, an error is returned.

The conversion functions allow you to convert between different types safely and efficiently. The Equal function checks if two values are equal, while the Compare function compares two values and returns an integer indicating their relative order.