Documentation
¶
Overview ¶
Package cid provides primitives to work with container identification in FrostFS.
Using package types in an application is recommended to potentially work with different protocol versions with which these types are compatible.
Index ¶
- type ID
- func (id *ID) Decode(src []byte) error
- func (id *ID) DecodeString(s string) error
- func (id ID) Encode(dst []byte)
- func (id ID) EncodeToString() string
- func (id ID) Equals(id2 ID) bool
- func (id *ID) ReadFromV2(m refs.ContainerID) error
- func (id *ID) SetSHA256(v [sha256.Size]byte)
- func (id ID) String() string
- func (id ID) WriteToV2(m *refs.ContainerID)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ID ¶
ID represents FrostFS container identifier.
ID is mutually compatible with github.com/TrueCloudLab/frostfs-api-go/v2/refs.ContainerID message. See ReadFromV2 / WriteToV2 methods.
Instances can be created using built-in var declaration.
Note that direct typecast is not safe and may result in loss of compatibility:
_ = ID([32]byte) // not recommended
func (*ID) Decode ¶
Decode decodes src bytes into ID.
Decode expects that src has 32 bytes length. If the input is malformed, Decode returns an error describing format violation. In this case ID remains unchanged.
Decode doesn't mutate src.
See also Encode.
func (*ID) DecodeString ¶
DecodeString decodes string into ID according to FrostFS API protocol. Returns an error if s is malformed.
See also DecodeString.
func (ID) Encode ¶
Encode encodes ID into 32 bytes of dst. Panics if dst length is less than 32.
Zero ID is all zeros.
See also Decode.
func (ID) EncodeToString ¶
EncodeToString encodes ID into FrostFS API protocol string.
Zero ID is base58 encoding of 32 zeros.
See also DecodeString.
func (ID) Equals ¶
Equals defines a comparison relation between two ID instances.
Note that comparison using '==' operator is not recommended since it MAY result in loss of compatibility.
func (*ID) ReadFromV2 ¶
func (id *ID) ReadFromV2(m refs.ContainerID) error
ReadFromV2 reads ID from the refs.ContainerID message. Returns an error if the message is malformed according to the FrostFS API V2 protocol.
See also WriteToV2.
func (*ID) SetSHA256 ¶
SetSHA256 sets container identifier value to SHA256 checksum of container structure.
func (ID) String ¶
String implements fmt.Stringer.
String is designed to be human-readable, and its format MAY differ between SDK versions. String MAY return same result as EncodeToString. String MUST NOT be used to encode ID into FrostFS protocol string.
func (ID) WriteToV2 ¶
func (id ID) WriteToV2(m *refs.ContainerID)
WriteToV2 writes ID to the refs.ContainerID message. The message must not be nil.
See also ReadFromV2.
Source Files
Directories