Add kill method to VirtualMachine

Author: adazem009

include/scratchcpp/virtualmachine.h

@@ -128,6 +128,7 @@ class LIBSCRATCHCPP_EXPORT VirtualMachine
         void replaceReturnValue(const Value &v, unsigned int offset);
 
         void run();
+        void kill();
         void reset();
         void moveToLastCheckpoint();
 

src/engine/virtualmachine.cpp

@@ -175,6 +175,13 @@ void VirtualMachine::run()
     impl->running = false;
 }
 
+/*! Stops the execution and sets atEnd to true. */
+void VirtualMachine::kill()
+{
+    reset();
+    impl->atEnd = true;
+}
+
 /*! Jumps back to the initial position. */
 void VirtualMachine::reset()
 {

test/virtual_machine/virtual_machine_test.cpp

@@ -1590,7 +1590,7 @@ TEST(VirtualMachineTest, OP_WARP)
     ASSERT_EQ(vm.registerCount(), 0);
 }
 
-TEST(VirtualMachineTest, Reset)
+TEST(VirtualMachineTest, ResetAndKill)
 {
     static unsigned int bytecode1[] = { OP_START, OP_NULL, OP_EXEC, 0, OP_HALT };
     static unsigned int bytecode2[] = { OP_START, OP_NULL, OP_EXEC, 1, OP_HALT };
@@ -1629,6 +1629,14 @@ TEST(VirtualMachineTest, Reset)
 
     vm.reset();
     ASSERT_FALSE(vm.atEnd());
+
+    // kill()
+    vm.run();
+    ASSERT_FALSE(vm.atEnd());
+    ASSERT_EQ(vm.registerCount(), 1);
+    vm.kill();
+    ASSERT_EQ(vm.registerCount(), 0);
+    ASSERT_TRUE(vm.atEnd());
 }
 
 TEST(VirtualMachineTest, NoCrashWhenRepeatingZeroTimes)