/// <summary>
/// Prompts the user for a QP type.
/// </summary>
/// <param name="qpType">Output parameter for the QP type.</param>
/// <returns><see langword="true"/> if the user specified a QP type.
/// <see langword="false"/> if the user specified the cancel option.</returns>
private bool TryGetQPType(out QPType qpType)
{
var qpTypes = Utility.GetEnumValues <QPType>().ToArray();
while (true)
{
PrintQPTypes(qpTypes);
Console.Write("QP type: ");
string qpTypeString = Console.ReadLine();
if (!int.TryParse(qpTypeString, out int oneBasedQPTypeIndex))
{
Console.WriteLine($"Failed to parse '{qpTypeString}' as an integer.");
continue;
}
if (oneBasedQPTypeIndex < 0 || oneBasedQPTypeIndex > qpTypes.Length)
{
Console.WriteLine($"{oneBasedQPTypeIndex} is not a valid QP type.");
continue;
}
if (oneBasedQPTypeIndex == 0)
{
qpType = default;
return(false);
}
qpType = (QPType)(oneBasedQPTypeIndex - 1);
return(true);
}
}
/// <summary>
/// Gets a string representation of the specified value of the <see cref="QPType"/> enum.
/// </summary>
/// <param name="qpType">The QP type for which to get a string representation.</param>
/// <returns>A string representation of <paramref name="qpType"/>.</returns>
private string GetQPTypeString(QPType qpType)
{
switch (qpType)
{
case QPType.OddFlower: return("Odd flower");
case QPType.EvenFlowerType1: return("Even flower, type 1");
case QPType.EvenFlowerType2: return("Even flower, type 2");
case QPType.PointedFlower: return("Pointed flower");
}
Debug.Fail($"Invalid QP type ({qpType}) specified.");
return(null);
}
/// <summary>
/// Indicates whether the specified number of periods is valid for the specified QP type.
/// </summary>
/// <param name="qpType">The QP type.</param>
/// <param name="numPeriods">The number of periods.</param>
/// <returns><see langword="true"/> if <paramref name="numPeriods"/> is valid for QPs of
/// type <paramref name="qpType"/>; <see langword="false"/> otherwise.</returns>
private bool NumPeriodsIsValid(QPType qpType, int numPeriods)
{
switch (qpType)
{
case QPType.OddFlower: return(UsefulQPs.OddFlowerParameterIsValid(numPeriods));
case QPType.EvenFlowerType1: return(UsefulQPs.EvenFlowerType1ParameterIsValid(numPeriods));
case QPType.EvenFlowerType2: return(UsefulQPs.EvenFlowerType2ParameterIsValid(numPeriods));
case QPType.PointedFlower: return(UsefulQPs.PointedFlowerParameterIsValid(numPeriods));
}
Debug.Fail($"Invalid QP type ({qpType}) specified.");
return(false);
}
/// <summary>
/// Prints the conditions that the number of periods needs to satisfy for the specified QP
/// type.
/// </summary>
/// <param name="qpType">The type of the QP.</param>
private void PrintNumPeriodsDescription(QPType qpType)
{
string numPeriodsDescription;
switch (qpType)
{
case QPType.OddFlower: numPeriodsDescription = UsefulQPs.OddFlowerParameterValidityDescription; break;
case QPType.EvenFlowerType1: numPeriodsDescription = UsefulQPs.EvenFlowerType1ParameterValidityDescription; break;
case QPType.EvenFlowerType2: numPeriodsDescription = UsefulQPs.EvenFlowerType2ParameterValidityDescription; break;
case QPType.PointedFlower: numPeriodsDescription = UsefulQPs.PointedFlowerParameterValidityDescription; break;
default:
Debug.Fail($"Invalid QP type ({qpType}) specified.");
numPeriodsDescription = null;
break;
}
Console.WriteLine(numPeriodsDescription);
}
/// <summary>
/// Prompts the user for the number of periods.
/// </summary>
/// <param name="qpType">The QP type.</param>
/// <param name="numPeriods">The number of periods for the QP.</param>
/// <returns><see langword="true"/> if the user specified a number of periods (which is
/// currently the only option); <see langword="false"/> otherwise.</returns>
private bool TryGetNumPeriods(QPType qpType, out int numPeriods)
{
while (true)
{
Console.Write("Number of periods: ");
string numPeriodsString = Console.ReadLine();
if (!int.TryParse(numPeriodsString, out numPeriods))
{
Console.WriteLine($"Failed to parse '{numPeriodsString}' as an integer.");
continue;
}
if (!NumPeriodsIsValid(qpType, numPeriods))
{
PrintNumPeriodsDescription(qpType);
continue;
}
return(true);
}
}
