PeerId struct
A peer's 16-byte UUID. Compared by content; default(PeerId) equals
PeerId.Default.
Namespace: Quaternar.Qaros · Assembly: Quaternar.Qaros.dll
public readonly struct PeerId : IEquatable<PeerId>
Implements: IEquatable<PeerId>
Properties
Default
The all-zero id, meaning "no peer".
public static PeerId Default { get; }
Value: PeerId
Methods
| Member | Description |
|---|---|
| Unique() | A fresh id that identifies no peer in any session. Never use it as a render target (RenderSenderOptions.PeerId): a stream created with one never produces a frame. |
| Parse(string) | Parses the UUID text PeerId.ToString produces. |
| TryParse(string, out PeerId) | Parses the UUID text PeerId.ToString produces; false, with a default id, when it is not one. |
| ToByteArray() | A copy of the 16 bytes. |
| AsSpan() | |
| TryCopyTo(Span<byte>) | Copies the 16 bytes; false, copying nothing, when destination is shorter. |
| ToString() | The 36-character UUID text, which PeerId.Parse accepts back. |
| Equals(PeerId) | Indicates whether the current object is equal to another object of the same type. |
| Equals(object?) | Indicates whether this instance and a specified object are equal. |
| GetHashCode() | Returns the hash code for this instance. |
Unique
A fresh id that identifies no peer in any session. Never use it as a render target
(RenderSenderOptions.PeerId): a stream created with one never produces
a frame.
public static PeerId Unique()
Returns: PeerId
Parse
Parses the UUID text PeerId.ToString produces.
public static PeerId Parse(string text)
Parameters
| Name | Type | Description |
|---|---|---|
text | string |
Returns: PeerId
Exceptions
| Exception | Condition |
|---|---|
| FormatException | text is not a UUID string. |
TryParse
Parses the UUID text PeerId.ToString produces; false, with a default id, when it is not one.
public static bool TryParse(string text, out PeerId id)
Parameters
| Name | Type | Description |
|---|---|---|
text | string | |
id | PeerId |
Returns: bool
ToByteArray
A copy of the 16 bytes.
public byte[] ToByteArray()
Returns: byte[]
AsSpan
public ReadOnlySpan<byte> AsSpan()
Returns: ReadOnlySpan<byte>
TryCopyTo
Copies the 16 bytes; false, copying nothing, when destination is shorter.
public bool TryCopyTo(Span<byte> destination)
Parameters
| Name | Type | Description |
|---|---|---|
destination | Span<byte> |
Returns: bool
ToString
The 36-character UUID text, which PeerId.Parse accepts back.
public override string ToString()
Returns: string
Equals(PeerId)
Indicates whether the current object is equal to another object of the same type.
public bool Equals(PeerId other)
Parameters
| Name | Type | Description |
|---|---|---|
other | PeerId | An object to compare with this object. |
Returns: bool — true if the current object is equal to the other parameter; otherwise, false.
Equals(object?)
Indicates whether this instance and a specified object are equal.
public override bool Equals(object? obj)
Parameters
| Name | Type | Description |
|---|---|---|
obj | object | The object to compare with the current instance. |
Returns: bool — true if obj and this instance are the same type and represent the same value; otherwise, false.
GetHashCode
Returns the hash code for this instance.
public override int GetHashCode()
Returns: int — A 32-bit signed integer that is the hash code for this instance.
Operators
operator ==
public static bool operator ==(PeerId left, PeerId right)
Parameters
| Name | Type | Description |
|---|---|---|
left | PeerId | |
right | PeerId |
Returns: bool
operator !=
public static bool operator !=(PeerId left, PeerId right)
Parameters
| Name | Type | Description |
|---|---|---|
left | PeerId | |
right | PeerId |
Returns: bool