hash

Documentation

Overview

hash パッケージはハッシュ関数のためのインターフェースを提供します。

Example (BinaryMarshaler)

package main

import (
	"github.com/shogo82148/std/bytes"
	"github.com/shogo82148/std/crypto/sha256"
	"github.com/shogo82148/std/encoding"
	"github.com/shogo82148/std/fmt"
	"github.com/shogo82148/std/log"
)

func main() {
	const (
		input1 = "The tunneling gopher digs downwards, "
		input2 = "unaware of what he will find."
	)

	first := sha256.New()
	first.Write([]byte(input1))

	marshaler, ok := first.(encoding.BinaryMarshaler)
	if !ok {
		log.Fatal("first does not implement encoding.BinaryMarshaler")
	}
	state, err := marshaler.MarshalBinary()
	if err != nil {
		log.Fatal("unable to marshal hash:", err)
	}

	second := sha256.New()

	unmarshaler, ok := second.(encoding.BinaryUnmarshaler)
	if !ok {
		log.Fatal("second does not implement encoding.BinaryUnmarshaler")
	}
	if err := unmarshaler.UnmarshalBinary(state); err != nil {
		log.Fatal("unable to unmarshal hash:", err)
	}

	first.Write([]byte(input2))
	second.Write([]byte(input2))

	fmt.Printf("%x\n", first.Sum(nil))
	fmt.Println(bytes.Equal(first.Sum(nil), second.Sum(nil)))
}

Output:

57d51a066f3a39942649cd9a76c77e97ceab246756ff3888659e6aa5a07f4a52
true

Index

• type Hash
• type Hash32
• type Hash64

Examples

• Package (BinaryMarshaler)

Types

type Hash

type Hash interface {
	io.Writer

	Sum(b []byte) []byte

	Reset()

	Size() int

	BlockSize() int
}

Hashはすべてのハッシュ関数で実装される共通のインターフェースです。

標準ライブラリのハッシュ実装（例：hash/crc32 や crypto/sha256）は、 encoding.BinaryMarshaler、encoding.BinaryAppender、および encoding.BinaryUnmarshaler インターフェースを実装しています。 ハッシュ実装をマーシャリングすることで、その内部状態を保存し、 後で追加の処理に使用することができます。これにより、ハッシュに以前に書き込まれたデータを 再度書き込む必要がなくなります。ハッシュ状態には、入力の一部が元の形式で含まれている場合があり、 ユーザーはそのセキュリティ上の影響を考慮する必要があります。

互換性：ハッシュまたは暗号パッケージへの将来の変更は、 以前のバージョンでエンコードされた状態を保持することを目指します。 つまり、パッケージのリリースバージョンは、 以前のリリースバージョンで書かれたデータをデコードすることができるはずです。 ただし、セキュリティ修正などの問題により、異なる結果となる場合があります。 背景については、Goの互換性文書を参照してください：https://golang.org/doc/go1compat

type Hash32

type Hash32 interface {
	Hash
	Sum32() uint32
}

Hash32はすべての32ビットハッシュ関数によって実装される共通インターフェースです。

type Hash64

type Hash64 interface {
	Hash
	Sum64() uint64
}

Hash64は、すべての64ビットハッシュ関数によって実装される共通のインタフェースです。