/// <summary>
/// This will never return null, it will raise an exception if unable to satisfy the request (this includes the case of a null expression reference)
/// </summary>
public static TranslatedStatementContentDetails Translate(
this ITranslateIndividualStatements statementTranslator,
Expression expression,
ScopeAccessInformation scopeAccessInformation,
ExpressionReturnTypeOptions returnRequirements,
Action <string> warningLogger)
{
if (statementTranslator == null)
{
throw new ArgumentNullException("statementTranslator");
}
if (expression == null)
{
throw new ArgumentNullException("expression");
}
if (scopeAccessInformation == null)
{
throw new ArgumentNullException("scopeAccessInformation");
}
if (!Enum.IsDefined(typeof(ExpressionReturnTypeOptions), returnRequirements))
{
throw new ArgumentOutOfRangeException("returnRequirements");
}
if (warningLogger == null)
{
throw new ArgumentNullException("warningLogger");
}
return(Translate(statementTranslator, (Statement)expression, scopeAccessInformation, returnRequirements, warningLogger));
}
private static TranslatedStatementContentDetails Translate(
ITranslateIndividualStatements statementTranslator,
Statement statement,
ScopeAccessInformation scopeAccessInformation,
ExpressionReturnTypeOptions returnRequirements,
Action <string> warningLogger)
{
if (statementTranslator == null)
{
throw new ArgumentNullException("statementTranslator");
}
if (statement == null)
{
throw new ArgumentNullException("statement");
}
if (scopeAccessInformation == null)
{
throw new ArgumentNullException("scopeAccessInformation");
}
if (!Enum.IsDefined(typeof(ExpressionReturnTypeOptions), returnRequirements))
{
throw new ArgumentOutOfRangeException("returnRequirements");
}
if (warningLogger == null)
{
throw new ArgumentNullException("warningLogger");
}
return(statementTranslator.Translate(
statement.ToStageTwoParserExpression(scopeAccessInformation, returnRequirements, warningLogger),
scopeAccessInformation,
returnRequirements
));
}
/// <summary>
/// This will never return null, it will raise an exception if unable to satisfy the request (this includes the case of a null statement reference)
/// </summary>
public static VBScriptTranslator.StageTwoParser.ExpressionParsing.Expression ToStageTwoParserExpression(
this VBScriptTranslator.LegacyParser.CodeBlocks.Basic.Statement statement,
ScopeAccessInformation scopeAccessInformation,
ExpressionReturnTypeOptions returnRequirements,
Action <string> warningLogger)
{
if (statement == null)
{
throw new ArgumentNullException("statement");
}
if (scopeAccessInformation == null)
{
throw new ArgumentNullException("scopeAccessInformation");
}
if (!Enum.IsDefined(typeof(ExpressionReturnTypeOptions), returnRequirements))
{
throw new ArgumentOutOfRangeException("returnRequirements");
}
if (warningLogger == null)
{
throw new ArgumentNullException("warningLogger");
}
// The BracketStandardisedTokens property should only be used if this is a non-value-returning statement (eg. "Test" or "Test 1"
// or "Test(a)", which would be translated into "Test()", "Test(1)" or "Test((a))", respectively) since that is the only time
// that brackets appear "optional". When this statement's return value is considered (eg. the "Test(1)" in "a = Test(1)"), the
// brackets will already be in a format in valid VBScript that matches what would be expected in C#.
var expressions =
VBScriptTranslator.StageTwoParser.ExpressionParsing.ExpressionGenerator.Generate(
(returnRequirements == ExpressionReturnTypeOptions.None) ? statement.GetBracketStandardisedTokens(scopeAccessInformation.DirectedWithReferenceIfAny?.AsToken()) : statement.Tokens,
(scopeAccessInformation.DirectedWithReferenceIfAny == null) ? null : scopeAccessInformation.DirectedWithReferenceIfAny.AsToken(),
warningLogger
).ToArray();
if (expressions.Length != 1)
{
throw new ArgumentException("Statement translation should always result in a single expression being generated");
}
return(expressions[0]);
}
