Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/bobg/basexx

Convert digit strings between arbitrary bases.
https://github.com/bobg/basexx

Last synced: about 1 month ago
JSON representation

Convert digit strings between arbitrary bases.

Lists

README 

        
# Basexx - Convert between digit strings and various number bases



[![Go Reference](https://pkg.go.dev/badge/github.com/bobg/v2/basexx.svg)](https://pkg.go.dev/github.com/bobg/basexx/v2)

[![Go Report Card](https://goreportcard.com/badge/github.com/bobg/basexx/v2)](https://goreportcard.com/report/github.com/bobg/basexx/v2)

[![Tests](https://github.com/bobg/basexx/actions/workflows/go.yml/badge.svg)](https://github.com/bobg/basexx/actions/workflows/go.yml)

[![Coverage Status](https://coveralls.io/repos/github/bobg/basexx/badge.svg?branch=master)](https://coveralls.io/github/bobg/basexx?branch=master)



This is basexx,

a package for converting numbers to digit strings in various bases

and vice versa.



## Usage



To get the Base30 encoding of the number 412:



```go

var sb strings.Builder

if err := basexx.EncodeInt64(&sb, 412, basexx.Base30); err != nil { ... }

result := sb.String()

```



To decode the Base30 digit string `"fr"`:



```go

result, err := basexx.DecodeString("fr", basexx.Base30)

```



To convert a digit string `x` in base `from` to a new digit string in base `to`:



```go

result, err := basexx.Convert(x, from, to)

```



To define your own new number base:



```go

// ReverseBase10 uses digits '9' through '0' just to mess with you.

type ReverseBase10 struct{}



func (ReverseBase10) N() int64 { return 10 }



func (ReverseBase10) Digit(val int64) (byte, error) {

  if val < 0 || val > 9 {

    return 0, errors.New("digit value out of range")

  }

  return byte('9' - val), nil

}



func (ReverseBase10) Val(digit byte) (int64, error) {

  if digit < '0’ || digit > '9' {

    return 0, errors.New("invalid encoded digit")

  }

  return int64(9 - (digit - '0’))

}

```