Add smart cast method for utility.

Author: Moderocky

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>org.byteskript</groupId>
     <artifactId>byteskript</artifactId>
-    <version>1.0.23</version>
+    <version>1.0.24</version>
     <name>ByteSkript</name>
     <description>A compiled JVM implementation of the Skript language.</description>
 

src/main/java/org/byteskript/skript/api/SyntaxElement.java

@@ -143,7 +143,7 @@ default void writeCall(final MethodBuilder builder, final Method method, final C
             else sub = context.getBuilder().addMatching(target);
             sub.setModifiers(0x00000002 | 0x00000008 | 0x00001000 | 0x00000040);
             int index = 0;
-            for (Type input : inputs) {
+            for (final Type input : inputs) {
                 sub.writeCode(loadObject(index));
                 sub.writeCode(cast(input));
                 index++;

src/main/java/org/byteskript/skript/runtime/Skript.java

@@ -284,11 +284,29 @@ public static Skript currentInstance() {
         return skript;
     }
 
-    public <From, To> void registerConverter(Class<From> from, Class<To> to, Converter<From, To> converter) {
-        final Converter.Data data = new Converter.Data(from, to);
-        this.converters.put(data, converter);
-    }
-    
+    /**
+     * A utility method to handle converting types for syntax.
+     * This will throw an error if conversion is impossible.
+     */
+    public static <To> To convert(Object from, Class<To> to) {
+        return convert(from, to, true);
+    }
+    
+    /**
+     * A utility method to handle converting types for syntax.
+     * If the fail parameter is true, this will throw an error, otherwise returning null.
+     */
+    @SuppressWarnings("unchecked")
+    public static <From, To> To convert(From from, Class<To> to, boolean fail) {
+        if (to.isInstance(from)) return to.cast(from);
+        final Skript instance = findInstance();
+        final Converter<From, To> converter = (Converter<From, To>) instance.getConverter(from.getClass(), to);
+        if (converter != null) return converter.convert(from);
+        if (fail) throw new ScriptRuntimeError("Unable convert '" + from + "' to type " + to.getSimpleName() + ".");
+        else return null;
+    }
+    
+    @SuppressWarnings("unchecked")
     public <From, To> Converter<From, To> getConverter(Class<From> from, Class<To> to) {
         final Converter.Data data = new Converter.Data(from, to);
         if (converters.containsKey(data)) return (Converter<From, To>) converters.get(data);
@@ -299,6 +317,11 @@ public <From, To> Converter<From, To> getConverter(Class<From> from, Class<To> t
         return null;
     }
 
+    public <From, To> void registerConverter(Class<From> from, Class<To> to, Converter<From, To> converter) {
+        final Converter.Data data = new Converter.Data(from, to);
+        this.converters.put(data, converter);
+    }
+    
     @Description("""
         Gets the parent class-loader attached to this Skript runtime.
         This is used to search available libraries and scripts for classes.