/// <summary>
/// Parses the current JSON token value from the source as a <see cref="Guid"/>.
/// Returns <see langword="true"/> if the entire UTF-8 encoded token value can be successfully
/// parsed to a <see cref="Guid"/> value. Only supports <see cref="Guid"/> values with hyphens
/// and without any surrounding decorations.
/// Returns <see langword="false"/> otherwise.
/// </summary>
/// <exception cref="InvalidOperationException">
/// Thrown if trying to get the value of a JSON token that is not a <see cref="JsonTokenType.String"/>.
/// <seealso cref="TokenType" />
/// </exception>
public bool TryGetGuid(out Guid value)
{
if (TokenType != JsonTokenType.String)
{
ThrowHelper.ThrowInvalidOperationException_ExpectedString(TokenType);
}
return(TryGetGuidCore(out value));
}
/// <summary>
/// Parses the current JSON token value from the source as a <see cref="DateTimeOffset"/>.
/// Returns <see langword="true"/> if the entire UTF-8 encoded token value can be successfully
/// parsed to a <see cref="DateTimeOffset"/> value.
/// Returns <see langword="false"/> otherwise.
/// </summary>
/// <exception cref="InvalidOperationException">
/// Thrown if trying to get the value of a JSON token that is not a <see cref="JsonTokenType.String"/>.
/// <seealso cref="TokenType" />
/// </exception>
public bool TryGetDateTimeOffset(out DateTimeOffset value)
{
if (TokenType != JsonTokenType.String)
{
ThrowHelper.ThrowInvalidOperationException_ExpectedString(TokenType);
}
return(TryGetDateTimeOffsetCore(out value));
}
/// <summary>
/// Parses the current JSON token value from the source and decodes the Base64 encoded JSON string as bytes.
/// Returns <see langword="true"/> if the entire token value is encoded as valid Base64 text and can be successfully
/// decoded to bytes.
/// Returns <see langword="false"/> otherwise.
/// </summary>
/// <exception cref="InvalidOperationException">
/// Thrown if trying to get the value of a JSON token that is not a <see cref="JsonTokenType.String"/>.
/// <seealso cref="TokenType" />
/// </exception>
public bool TryGetBytesFromBase64([NotNullWhen(true)] out byte[]?value)
{
if (TokenType != JsonTokenType.String)
{
ThrowHelper.ThrowInvalidOperationException_ExpectedString(TokenType);
}
ReadOnlySpan <byte> span = HasValueSequence ? ValueSequence.ToArray() : ValueSpan;
if (_stringHasEscaping)
{
int idx = span.IndexOf(JsonConstants.BackSlash);
Debug.Assert(idx != -1);
return(JsonReaderHelper.TryGetUnescapedBase64Bytes(span, idx, out value));
}
Debug.Assert(span.IndexOf(JsonConstants.BackSlash) == -1);
return(JsonReaderHelper.TryDecodeBase64(span, out value));
}
/// <summary>
/// Parses the current JSON token value from the source, unescaped, and transcoded as a <see cref="string"/>.
/// </summary>
/// <remarks>
/// Returns <see langword="null" /> when <see cref="TokenType"/> is <see cref="JsonTokenType.Null"/>.
/// </remarks>
/// <exception cref="InvalidOperationException">
/// Thrown if trying to get the value of the JSON token that is not a string
/// (i.e. other than <see cref="JsonTokenType.String"/>, <see cref="JsonTokenType.PropertyName"/> or
/// <see cref="JsonTokenType.Null"/>).
/// <seealso cref="TokenType" />
/// It will also throw when the JSON string contains invalid UTF-8 bytes, or invalid UTF-16 surrogates.
/// </exception>
public string?GetString()
{
if (TokenType == JsonTokenType.Null)
{
return(null);
}
if (TokenType != JsonTokenType.String && TokenType != JsonTokenType.PropertyName)
{
ThrowHelper.ThrowInvalidOperationException_ExpectedString(TokenType);
}
ReadOnlySpan <byte> span = HasValueSequence ? ValueSequence.ToArray() : ValueSpan;
if (_stringHasEscaping)
{
int idx = span.IndexOf(JsonConstants.BackSlash);
Debug.Assert(idx != -1);
return(JsonReaderHelper.GetUnescapedString(span, idx));
}
Debug.Assert(span.IndexOf(JsonConstants.BackSlash) == -1);
return(JsonReaderHelper.TranscodeHelper(span));
}
