/// <summary>
/// Assembles the specified assembly code <paramref name="assembly"/> and returns the result.
/// </summary>
/// <returns>The resulting hex code from the assembled assembly code.</returns>
/// <example>
/// <code>
/// string hex = Assembler.Assemble ("mov w0, #0");
/// Console.WriteLine (hex);
/// </code>
/// </example>
/// <exception cref="System.FormatException">
/// Thrown when an error occurs after attempting to assemble the assembly code.
/// </exception>
/// See <see cref="Assembler.MultiAssemble(string[], ArchSelection, int?)"/> to assemble an array of lines of assemble code.
/// <param name="assembly">The assembly code string to assemble.</param>
/// <param name="archSelection">The architecture that the assembly code <paramref name="assembly"/> corresponds to.</param>
/// <param name="offset">The offset integer that the resulting hex code should be shifted by.</param>
public static string Assemble(string assembly, ArchSelection archSelection = ArchSelection.AArch64, int?offset = null)
{
var webClient = new WebClient();
webClient.Headers[HttpRequestHeader.ContentType] = "application/json";
string json = $"{{\"asm\":\"{assembly}\",\"offset\":\"0x{offset ?? 0}\",\"arch\":\"{ArchToString(archSelection)}\"}}";
string result = webClient.UploadString("https://armconverter.com/api/convert", json);
switch (archSelection)
{
case ArchSelection.AArch64:
string aArch64Hex = AArch64Json.FromJson(result).Hex.AArch64[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(aArch64Hex))
{
throw new FormatException(aArch64Hex);
}
return(aArch64Hex);
case ArchSelection.AArch32:
string aArch32Hex = AArch32Json.FromJson(result).Hex.AArch32[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(aArch32Hex))
{
throw new FormatException(aArch32Hex);
}
return(aArch32Hex);
case ArchSelection.AArch32BigEndian:
string aArch32BigEndianHex = AArch32BigEndianJson.FromJson(result).Hex.AArch32BigEndian[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(aArch32BigEndianHex))
{
throw new FormatException(aArch32BigEndianHex);
}
return(aArch32BigEndianHex);
case ArchSelection.Thumb:
string thumbHex = ThumbJson.FromJson(result).Hex.Thumb[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(thumbHex))
{
throw new FormatException(thumbHex);
}
return(thumbHex);
case ArchSelection.ThumbBigEndian:
string thumbBigEndianHex = ThumbBigEndianJson.FromJson(result).Hex.ThumbBigEndian[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(thumbBigEndianHex))
{
throw new FormatException(thumbBigEndianHex);
}
return(thumbBigEndianHex);
default:
return(null);
}
}
/// <summary>
/// Asynchronously assembles the specified assembly code array <paramref name="assembly"/> and returns the result, this method does not block the calling thread.
/// </summary>
/// <returns>The resulting hex code array from the assembled assembly code.</returns>
/// <example>
/// <code>
/// string[] assembly = { "mov w0, #0", "ret", "ldr w3, [x1]", "and w3, w3, #0xff", "cmp w3, #0x61", "b.ne #0x1c", "adr x1, #0x24", "sub sp, sp, #0x60", "b #0xfffffffffffcbff4" };
/// string[] hex = await Assembler.MultiAssembleAsync (assembly);
/// Console.WriteLine (string.Join ('\n', hex));
/// </code>
/// </example>
/// <exception cref="System.FormatException">
/// Thrown when an error occurs after attempting to assemble one of the lines of the assembly code.
/// </exception>
/// See <see cref="Assembler.AssembleAsync(string, ArchSelection, int?)"/> to assemble a single line of assemble code asynchronously.
/// <param name="assembly">The assembly code string array to assemble.</param>
/// <param name="archSelection">The architecture that the assembly code <paramref name="assembly"/> corresponds to.</param>
/// <param name="offset">The offset integer that the resulting hex code should be shifted by.</param>
public static async Task <string[]> MultiAssembleAsync(string[] assembly, ArchSelection archSelection = ArchSelection.AArch64, int?offset = null)
{
var hex = new List <string> ();
foreach (string line in assembly)
{
var webClient = new WebClient();
webClient.Headers[HttpRequestHeader.ContentType] = "application/json";
string json = $"{{\"asm\":\"{line}\",\"offset\":\"0x{offset ?? 0}\",\"arch\":\"{ArchToString(archSelection)}\"}}";
string result = await webClient.UploadStringTaskAsync("https://armconverter.com/api/convert", json);
switch (archSelection)
{
case ArchSelection.AArch64:
var aArch64Json = await AArch64Json.FromJsonAsync(result);
string aArch64Hex = aArch64Json.Hex.AArch64[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(aArch64Hex))
{
throw new FormatException(aArch64Hex);
}
hex.Add(aArch64Hex);
break;
case ArchSelection.AArch32:
var aArch32Json = await AArch32Json.FromJsonAsync(result);
string aArch32Hex = aArch32Json.Hex.AArch32[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(aArch32Hex))
{
throw new FormatException(aArch32Hex);
}
hex.Add(aArch32Hex);
break;
case ArchSelection.AArch32BigEndian:
var aArch32BigEndianJson = await AArch32BigEndianJson.FromJsonAsync(result);
string aArch32BigEndianHex = aArch32BigEndianJson.Hex.AArch32BigEndian[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(aArch32BigEndianHex))
{
throw new FormatException(aArch32BigEndianHex);
}
hex.Add(aArch32BigEndianHex);
break;
case ArchSelection.Thumb:
var thumbJson = await ThumbJson.FromJsonAsync(result);
string thumbHex = thumbJson.Hex.Thumb[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(thumbHex))
{
throw new FormatException(thumbHex);
}
hex.Add(thumbHex);
break;
case ArchSelection.ThumbBigEndian:
var thumbBigEndianJson = await ThumbBigEndianJson.FromJsonAsync(result);
string thumbBigEndianHex = thumbBigEndianJson.Hex.ThumbBigEndian[1].ToString().Replace("### ", string.Empty);
if (ExceptionMessageList.Contains(thumbBigEndianHex))
{
throw new FormatException(thumbBigEndianHex);
}
hex.Add(thumbBigEndianHex);
break;
default:
return(null);
}
}
return(hex.ToArray());
}