go-hexadeca/README.md

101 lines
2.7 KiB
Markdown
Raw Normal View History

2023-10-26 18:15:51 +00:00
# go-hexadeca
Package **hexadeca** implements hexadecimal encoding and decoding, for the Go programming language.
This is meant to be a better alternative to Go's built-in "hex" package.
2023-10-27 17:57:56 +00:00
Package **hexadeca** has easy functiosn for encoding and decoding to:
* `byte` (i.e., `uint8`),
* `uint16`,
* `uint32`
* `uint64`
* `int64`
2023-10-26 18:15:51 +00:00
## Documention
Online documentation, which includes examples, can be found at: http://godoc.org/sourcecode.social/reiver/go-hexadeca
[![GoDoc](https://godoc.org/sourcecode.social/reiver/go-hexadeca?status.svg)](https://godoc.org/sourcecode.social/reiver/go-hexadeca)
2023-10-27 00:01:40 +00:00
## Example
2023-10-27 05:01:30 +00:00
A couple examples of encoding a `byte` to hexidecimal.
2023-10-27 00:01:40 +00:00
```go
import "sourceccode.social/reiver/go-hexadeca"
// ...
// value==254 -> mostSignificant=='f', leastSignificant=='e'
mostSignificant, leastSignificant := hexadeca.EncodeByteUsingLowerCaseSymbols(value)
// ...
// value==254 -> mostSignificant=='F', leastSignificant=='E'
mostSignificant, leastSignificant := hexadeca.EncodeByteUsingUpperCaseSymbols(value)
```
2023-10-27 17:56:38 +00:00
A couple examples of encoding a `uint16` to hexidecimal.
```go
import "sourceccode.social/reiver/go-hexadeca"
// ...
r3, r2, r1, r0 = hexadeca.EncodeUint16UsingLowerCaseSymbols(value)
// ...
r3, r2, r1, r0 = hexadeca.EncodeUint16UsingLUpperCaseSymbols(value)
```
A couple examples of encoding a `uint32` to hexidecimal.
```go
import "sourceccode.social/reiver/go-hexadeca"
// ...
r7, r6, r5, r4, r3, r2, r1, r0 = hexadeca.EncodeUint32UsingLowerCaseSymbols(value)
// ...
r7, r6, r5, r4, r3, r2, r1, r0 = hexadeca.EncodeUint32UsingLUpperCaseSymbols(value)
```
2023-10-27 05:01:30 +00:00
A couple examples of encoding a `uint64` to hexidecimal.
```go
import "sourceccode.social/reiver/go-hexadeca"
// ...
// value==18364758544493064720 -> r15=='f', r14=='e', r13=='d', r12=='c', r11=='b', r10=='a', r9=='9', r8=='8', r7=='7', r6=='6', r5=='5', r4=='4', r3=='3', r2=='2', r1=='1', r0=='0'
r15, r14, r13, r12, r11, r10, r9, r8, r7, r6, r5, r4, r3, r2, r1, r0 = hexadeca.EncodeUint64UsingLowerCaseSymbols(value)
// ...
// value==18364758544493064720 -> r15=='F', r14=='E', r13=='D', r12=='C', r11=='B', r10=='A', r9=='9', r8=='8', r7=='7', r6=='6', r5=='5', r4=='4', r3=='3', r2=='2', r1=='1', r0=='0'
r15, r14, r13, r12, r11, r10, r9, r8, r7, r6, r5, r4, r3, r2, r1, r0 = hexadeca.EncodeUint64UsingLUpperCaseSymbols(value)
```
2023-10-26 18:15:51 +00:00
## Import
2023-10-27 04:47:35 +00:00
To import package **hexadeca** use `import` code like the following:
2023-10-26 18:15:51 +00:00
```
import "sourcecode.social/reiver/go-hexadeca"
```
## Installation
2023-10-26 23:55:58 +00:00
To install package **hexadeca** do the following:
2023-10-26 18:15:51 +00:00
```
GOPROXY=direct https://sourcecode.social/reiver/go-hexadeca
```
## Author
2023-10-26 23:55:58 +00:00
Package **hexadeca** was written by [Charles Iliya Krempeaux](http://changelog.ca)