/// <summary>
/// Blocks the thread while waiting for a result.
/// </summary>
/// <param name="tcs">
/// The <see cref="TaskCompletionSource{TResult}"/> in use for signalling result is available.
/// </param>
/// <param name="timeout">
/// (optional)<br/>
/// Specifies a timeout. If operation times our a default result will be sent back.
/// </param>
/// <param name="cts">
/// (optional)<br/>
/// A cancellation token source, allowing operation cancellation (from a different thread).
/// </param>
/// <typeparam name="T">
/// The type of result being requested.
/// </typeparam>
/// <returns>
/// An <see cref="Outcome{T}"/> value, signalling success/failure while also carrying the requested
/// result on success; otherwise an <see cref="Exception"/>.
/// </returns>
public static Outcome <T> AwaitResult <T>(
this TaskCompletionSource <T> tcs,
TimeSpan?timeout = null,
CancellationTokenSource cts = null)
{
if (tcs.Task.Status >= TaskStatus.RanToCompletion)
{
return(Outcome <T> .Success(tcs.Task.Result));
}
var awaiter = tcs.Task.ConfigureAwait(false).GetAwaiter();
var useTimeout = timeout.HasValue ? DateTime.Now.Add(timeout.Value) : DateTime.MaxValue;
var isTimedOut = false;
var isCancelled = false;
while (!awaiter.IsCompleted && !isTimedOut && !isCancelled)
{
Task.Delay(10);
isTimedOut = DateTime.Now >= useTimeout;
isCancelled = cts?.IsCancellationRequested ?? false;
}
return(tcs.Task.Status >= TaskStatus.RanToCompletion
? Outcome <T> .Success(tcs.Task.Result)
: Outcome <T> .Fail(
isTimedOut
?new Exception("Result could not be created before operation timed out")
: new Exception("Result could not be created. Operation was cancelled")));
}
Outcome <string[]> tryParse(string value, StringComparison comparison = StringComparison.Ordinal)
{
if (string.IsNullOrEmpty(value))
{
return(Outcome <string[]> .Fail(new FormatException($"Invalid {typeof(MultiStringValue)} format: \"{value}\"")));
}
var split = value.Split(new[] { Separator }, StringSplitOptions.RemoveEmptyEntries);
if (split.Length == 0)
{
return(Outcome <string[]> .Fail(new FormatException($"Invalid {typeof(MultiStringValue)} format: \"{value}\"")));
}
var roles = new List <string>();
foreach (var s in split)
{
var trimmed = s.Trim();
var isValidItem = OnValidateItem(trimmed, comparison);
if (!isValidItem)
{
return(Outcome <string[]> .Fail(isValidItem.Exception));
}
roles.Add(trimmed);
}
return(Outcome <string[]> .Success(roles.ToArray()));
}
Outcome <string> getValueForIndex(int index)
{
if (index + 1 >= _args.Length)
{
return(Outcome <string> .Success(_args[index]));
}
return(isKey(index + 1)
? Outcome <string> .Success(_args[index])
: Outcome <string> .Success(_args[index + 1]));
}
protected virtual Outcome <string> OnValidateItem(string item, StringComparison comparison = StringComparison.Ordinal) => Outcome <string> .Success(item);