//
// This method attempts reading quoted-string formatted data when the bounding quotes were omitted.
// This is common for e-mail display-names.
//
// Precondition: The index must be within the bounds of the data string.
//
// Return value:
// - The index of the special delimiter provided.
// e.g. In ([email protected], billy box [email protected]), starting at index=19 (x) returns index=9 (,).
// - -1 if the terminating character was not found.
// e.g. In (my name username@domain), starting at index=5 (e) returns index=-1.
//
// A FormatException will be thrown or false is returned if:
// - A non-escaped character is encountered that is not valid in a quoted string. This includes double quotes.
// - A Unicode character is encountered and Unicode has not been allowed.
//
/// <summary>
/// Tries the read reverse un quoted.
/// </summary>
/// <param name="data">The data.</param>
/// <param name="index">The index.</param>
/// <param name="permitUnicode">if set to <c>true</c> [permit unicode].</param>
/// <param name="expectCommaDelimiter">if set to <c>true</c> [expect comma delimiter].</param>
/// <param name="outIndex">Index of the out.</param>
/// <param name="throwExceptionIfFail">if set to <c>true</c> [throw exception if fail].</param>
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise.</returns>
/// <exception cref="FormatException">Invalid character: {data[index]}.</exception>
internal static bool TryReadReverseUnQuoted(string data, int index, bool permitUnicode, bool expectCommaDelimiter, out int outIndex, bool throwExceptionIfFail)
{
Debug.Assert(index >= 0 && index < data.Length, "Index out of range: " + index + ", " + data.Length);
do
{
// Check for valid whitespace
if (!WhitespaceReader.TryReadFwsReverse(data, index, out index, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
if (index < 0)
{
break;
}
// Check for escaped characters
if (!QuotedPairReader.TryCountQuotedChars(data, index, permitUnicode, out var quotedCharCount, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
if (quotedCharCount > 0)
{
index -= quotedCharCount;
}
// Check for the terminating char
else if (expectCommaDelimiter && data[index] == ControlChars.Comma)
{
break;
}
// Check invalid characters
else if (!IsValidQtext(permitUnicode, data[index]))
{
if (throwExceptionIfFail)
{
throw new FormatException($"Invalid character: {data[index]}.");
}
else
{
outIndex = default;
return(false);
}
}
// Valid char
else
{
index--;
}
}while (index >= 0);
outIndex = index;
return(true);
}
//
// This method reads a standard quoted string. Departing from the RFC, Unicode is permitted for display-name.
//
// Preconditions:
// - Index must be within the bounds of the data string.
// - The char at the given index is the initial quote. (data[index] == Quote)
//
// Return value: The next index past the terminating-quote (data[index + 1] == Quote).
// e.g. In (bob "user name"@domain), starting at index=14 (") returns index=3 (space).
//
// A FormatException will be thrown or false is returned if:
// - A non-escaped character is encountered that is not valid in a quoted string.
// - A Unicode character is encountered and Unicode has not been allowed.
// - The final double quote is not found.
//
/// <summary>
/// Tries the read reverse quoted.
/// </summary>
/// <param name="data">The data.</param>
/// <param name="index">The index.</param>
/// <param name="permitUnicode">if set to <c>true</c> [permit unicode].</param>
/// <param name="outIndex">Index of the out.</param>
/// <param name="throwExceptionIfFail">if set to <c>true</c> [throw exception if fail].</param>
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise.</returns>
/// <exception cref="FormatException">Invalid character: {data[index]}.
/// or
/// Invalid character: {ControlChars.Quote}.</exception>
internal static bool TryReadReverseQuoted(string data, int index, bool permitUnicode, out int outIndex, bool throwExceptionIfFail)
{
Debug.Assert(0 <= index && index < data.Length, "Index out of range: " + index + ", " + data.Length);
// Check for the first bounding quote
Debug.Assert(data[index] == ControlChars.Quote, "Initial char at index " + index + " was not a quote.");
// Skip the bounding quote
index--;
do
{
// Check for valid whitespace
if (!WhitespaceReader.TryReadFwsReverse(data, index, out index, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
if (index < 0)
{
break;
}
// Check for escaped characters
if (!QuotedPairReader.TryCountQuotedChars(data, index, permitUnicode, out int quotedCharCount, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
if (quotedCharCount > 0)
{
// Skip quoted pairs
index -= quotedCharCount;
}
// Check for the terminating quote
else if (data[index] == ControlChars.Quote)
{
// Skip the final bounding quote
outIndex = index - 1;
return(true);
}
// Check invalid characters
else if (!IsValidQtext(permitUnicode, data[index]))
{
if (throwExceptionIfFail)
{
throw new FormatException($"Invalid character: {data[index]}.");
}
else
{
outIndex = default;
return(false);
}
}
// Valid char
else
{
index--;
}
}while (index >= 0);
if (throwExceptionIfFail)
{
// We started with a quote, but did not end with one
throw new FormatException($"Invalid character: {ControlChars.Quote}.");
}
else
{
outIndex = default;
return(false);
}
}
// Reads a domain literal in reverse
// Preconditions:
// - Index must be within the bounds of the data string.
// - The char at the given index is the initial bracket. (data[index] == EndSquareBracket)
// Return value:
// - The next index past the terminating bracket (data[index + 1] == StartSquareBracket).
// e.g. In (user@[domain]), starting at index=12 (]) returns index=4 (@).
// A FormatException will be thrown or false is returned if:
// - A non-escaped character is encountered that is not valid in a domain literal, including Unicode.
// - The final bracket is not found.
//
/// <summary>
/// Tries the read reverse.
/// </summary>
/// <param name="data">The data.</param>
/// <param name="index">The index.</param>
/// <param name="outIndex">Index of the out.</param>
/// <param name="throwExceptionIfFail">if set to <c>true</c> [throw exception if fail].</param>
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise.</returns>
/// <exception cref="FormatException">Invalid character: { data[index]}.
/// or
/// Invalid character: { MailBnfHelper.EndSquareBracket}.</exception>
internal static bool TryReadReverse(string data, int index, out int outIndex, bool throwExceptionIfFail)
{
Debug.Assert(0 <= index && index < data.Length, "index was outside the bounds of the string: " + index);
Debug.Assert(data[index] == dotNetTips.Utility.Standard.Common.ControlChars.EndSquareBracket, "data did not end with a square bracket");
// Skip the end bracket
index--;
do
{
// Check for valid whitespace
if (!WhitespaceReader.TryReadFwsReverse(data, index, out index, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
if (index < 0)
{
break;
}
// Check for escaped characters
if (!QuotedPairReader.TryCountQuotedChars(data, index, false, out int quotedCharCount, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
if (quotedCharCount > 0)
{
// Skip quoted pairs
index -= quotedCharCount;
}
// Check for the terminating bracket
else if (data[index] == dotNetTips.Utility.Standard.Common.ControlChars.StartSquareBracket)
{
// We're done parsing
outIndex = index - 1;
return(true);
}
// Check for invalid characters
else if (data[index] > MailBnfHelper.Ascii7bitMaxValue || !MailBnfHelper.Dtext[data[index]])
{
if (throwExceptionIfFail)
{
throw new FormatException($"Invalid character: { data[index]}.");
}
else
{
outIndex = default;
return(false);
}
}
// Valid char
else
{
index--;
}
}while (index >= 0);
if (throwExceptionIfFail)
{
// We didn't find a matching '[', throw.
throw new FormatException($"Invalid character: { dotNetTips.Utility.Standard.Common.ControlChars.EndSquareBracket}.");
}
else
{
outIndex = default;
return(false);
}
}
// This method functions similarly to ReadFwsReverse but will also skip any comments.
//
// Comments are text within '(' and ')' and may be nested. There may also be consecutive comments. Unicode is
// allowed, as the comments are not transmitted.
//
// This method was explicitly written in a non-recursive fashion to avoid malicious or accidental
// stack-overflows from user input.
//
// Preconditions:
// - The data string must not be null or empty
// - The index must be within the upper bounds of the data string.
//
// Return value:
// - The given index if it data[index] was not a ')' or whitespace
// - The index of the next non comment or whitespace character
// e.g. " d ( ( c o mment) )" returns index 1
// - -1 if skipping the comments and/or whitespace moves you to the beginning of the data string.
// e.g. " (comment) " returns -1
//
// Throws a FormatException or false is returned for mismatched '(' and ')', or for unescaped characters not allowed in comments.
/// <summary>
/// Tries the read CFWS reverse.
/// </summary>
/// <param name="data">The data.</param>
/// <param name="index">The index.</param>
/// <param name="outIndex">Index of the out.</param>
/// <param name="throwExceptionIfFail">if set to <c>true</c> [throw exception if fail].</param>
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise.</returns>
/// <exception cref="FormatException">Invalid character: {ControlChars.StartComment}.
/// or
/// Invalid character: {data[index]}.
/// or
/// Invalid character.</exception>
internal static bool TryReadCfwsReverse(string data, int index, out int outIndex, bool throwExceptionIfFail)
{
Debug.Assert(!string.IsNullOrEmpty(data), "data was null or empty");
Debug.Assert(index < data.Length, "index was outside the bounds of the string");
var commentDepth = 0;
// Check for valid whitespace
if (!TryReadFwsReverse(data, index, out index, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
while (index >= 0)
{
// Check for escaped characters. They must be within comments.
if (!QuotedPairReader.TryCountQuotedChars(data, index, true, out var quotedCharCount, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
if (commentDepth > 0 && quotedCharCount > 0)
{
index -= quotedCharCount;
}
// Start a new comment
else if (data[index] == dotNetTips.Utility.Standard.Common.ControlChars.EndComment)
{
commentDepth++;
index--;
}
// Finish a comment
else if (data[index] == dotNetTips.Utility.Standard.Common.ControlChars.StartComment)
{
commentDepth--;
if (commentDepth < 0)
{
if (throwExceptionIfFail)
{
// Mismatched '('
throw new FormatException($"Invalid character: {dotNetTips.Utility.Standard.Common.ControlChars.StartComment}.");
}
else
{
outIndex = default;
return(false);
}
}
index--;
}
// Check for valid characters within comments. Allow Unicode, as we won't transmit any comments.
else if (commentDepth > 0 &&
(data[index] > MailBnfHelper.Ascii7bitMaxValue || MailBnfHelper.Ctext[data[index]]))
{
index--;
}
// If we're still in a comment, this must be an invalid char
else if (commentDepth > 0)
{
if (throwExceptionIfFail)
{
throw new FormatException($"Invalid character: {data[index]}.");
}
else
{
outIndex = default;
return(false);
}
}
// We must no longer be in a comment, and this is not a whitespace char, return
else
{
break;
}
// Check for valid whitespace
if (!TryReadFwsReverse(data, index, out index, throwExceptionIfFail))
{
outIndex = default;
return(false);
}
}
if (commentDepth > 0)
{
if (throwExceptionIfFail)
{
// Mismatched ')', throw
throw new FormatException("Invalid character.");
}
else
{
outIndex = default;
return(false);
}
}
outIndex = index;
return(true);
}
