Add context-aware instruction text

Author: tinysec

Function/BNGetInstructionTextWithContext.cs

@@ -23,22 +23,22 @@ internal static extern bool BNGetInstructionTextWithContext(
 		    IntPtr arch   , 
 
 			// const uint8_t* data
-		    IntPtr data   , 
+		    byte[] data,
 
 			// uint64_t addr
 		    ulong addr   , 
 
 			// size_t* len
-		    IntPtr len   , 
+		    ref UIntPtr len,
 
 			// void* context
 		    IntPtr context   , 
 
 			// BNInstructionTextToken** result
-		    IntPtr result   , 
+		    out IntPtr result,
 
 			// size_t* count
-		    IntPtr count  
+		    out UIntPtr count
 		);
 	}
 }

Handle/BNArchitecture.cs

@@ -572,6 +572,42 @@ out arrayLength
 		    return tokens;
 	    }
 
+		public InstructionTextToken[] GetInstructionTextWithContext(
+			byte[] data,
+			ulong address,
+			ref ulong length,
+			IntPtr context
+		)
+		{
+			if (null == data)
+			{
+				throw new ArgumentNullException(nameof(data));
+			}
+
+			UIntPtr nativeLength = new UIntPtr(length);
+			bool ok = NativeMethods.BNGetInstructionTextWithContext(
+				this.handle,
+				data,
+				address,
+				ref nativeLength,
+				context,
+				out IntPtr tokens,
+				out UIntPtr count
+			);
+			length = nativeLength.ToUInt64();
+			if (!ok)
+			{
+				return Array.Empty<InstructionTextToken>();
+			}
+
+			return UnsafeUtils.TakeStructArrayEx<BNInstructionTextToken, InstructionTextToken>(
+				tokens,
+				count.ToUInt64(),
+				InstructionTextToken.FromNative,
+				NativeMethods.BNFreeInstructionText
+			);
+		}
+
 	    public string GetRegisterName(RegisterIndex reg)
 	    {
 		    return UnsafeUtils.TakeAnsiString(
@@ -1190,4 +1226,4 @@ public void SetStdcallCallingConvention(CallingConvention cc)
 
 	}
 
-}
+}