README
¶
SID
The main purpose of SID is to seamlessly convert between a JSON-formatted string representation of an ID and its int64 counterpart when interacting with a database.
Installation
You can install SID using go get:
go get -u -v github.com/deloz/sid
Usage
Here's a basic example of how to use SID:
package main
import (
"encoding/json"
"fmt"
"github.com/deloz/sid"
)
func main() {
// Create a new ID
id := sid.New(18283195028008204)
// Print the ID as a string
fmt.Println("ID:", id.String())
// Check if the ID is zero
fmt.Println("IsZero:", id.IsZero())
// Marshal the ID to JSON
jsonData, _ := json.Marshal(id)
fmt.Println("JSON:", string(jsonData))
// Unmarshal the ID from JSON
var newID sid.ID
_ = json.Unmarshal(jsonData, &newID)
fmt.Println("Unmarshaled ID:", newID)
}
[play]
Features
- Support creation of IDs from
uint64(up tomath.MaxInt64),int64, and numeric string representations. - Implement JSON (de)serialization, comparison, and sorting for custom ID types in Go.
Contributing
Contributions are welcome! If you find a bug or want to propose a new feature, feel free to open an issue or submit a pull request.
License
SID is licensed under the MIT License. See LICENSE for details.
Documentation
¶
Index ¶
- Variables
- type ID
- func (id ID) Cmp(v ID) int
- func (id ID) Compare(v ID) int
- func (id ID) Equal(v ID) bool
- func (id ID) GreaterThan(v ID) bool
- func (id ID) GreaterThanOrEqual(v ID) bool
- func (id ID) Int64() int64
- func (id ID) IsZero() bool
- func (id ID) LessThan(v ID) bool
- func (id ID) LessThanOrEqual(v ID) bool
- func (id ID) MarshalJSON() ([]byte, error)
- func (id ID) MarshalText() ([]byte, error)
- func (id *ID) Scan(value any) error
- func (id ID) String() string
- func (id *ID) UnmarshalJSON(b []byte) error
- func (id *ID) UnmarshalText(b []byte) error
- func (id ID) Value() (driver.Value, error)
- type IDs
Constants ¶
This section is empty.
Variables ¶
var ( // Zero is the zero value of the ID type. Zero = New(zero) )
Functions ¶
This section is empty.
Types ¶
type ID ¶
type ID int64
ID represents a unique identifier. It is a wrapper around an int64.
func NewFromString ¶
NewFromString creates a new ID from a string.
func NewFromUint64 ¶
NewFromUint64 creates a new ID from a uint64.
func (ID) Cmp ¶
Cmp compares the numbers represented by id and v and returns: -1 if id < v 0 if id == v +1 if id > v
func (ID) Compare ¶
Compare compares the numbers represented by id and v and returns: -1 if id < v 0 if id == v +1 if id > v
func (ID) GreaterThan ¶
GreaterThan returns true if id is greater than v.
func (ID) GreaterThanOrEqual ¶
GreaterThanOrEqual returns true if id is greater than or equal to v.
func (ID) LessThanOrEqual ¶
LessThanOrEqual returns true if id is less than or equal to v.
func (ID) MarshalJSON ¶
MarshalJSON implements the json.Marshaler interface.
func (ID) MarshalText ¶
MarshalText implements the encoding.TextMarshaler interface.
func (*ID) UnmarshalJSON ¶
UnmarshalJSON implements the json.Unmarshaler interface.
func (*ID) UnmarshalText ¶
UnmarshalText implements the encoding.TextUnmarshaler interface.
Source Files