Interface QDLFunction

    • Method Detail

      • getName

        String getName()
        The name of this function as you want it invoked in QDL. This will be what the function is called in the workspace.
        Returns:
      • getArgCount

        int[] getArgCount()
        The contract is that when QDL invokes this method, it will faithfully give all of the arguments as an array of Objects. Overloading is not possible in QDL (it is weakly typed) except by argument count, so if this is called "foo" and you have versions with 3 and 4 arguments, then f(a,b,c) would be executed with the arguments passed. To achieve overloading for Java methods, have the number of arguments this accepts as the elements of the array. So if this has a value of [1,2,3] then this function will be invoked if called with 1, 2 or 3 arguments and an error by the QDL runtime engine will be raised, if, say, 4 are passed.
        Returns:
      • evaluate

        Object evaluate​(Object[] objects,
                        State state)
                 throws Throwable
        The method that is invoked by QDL that is the function. It will have the arguments already evaluated and put in to the array of objects. It is up to you to do any checking you see fit. State is supplied if needed.
        Parameters:
        objects -
        state -
        Returns:
        Throws:
        Throwable
      • getDocumentation

        List<String> getDocumentation​(int argCount)
        Return documentation to be displayed in the workspace. Short version displays the first line (element of the list) so make sure that is informative. The long version should contain details of use. Best practice is that have a succinct one line description for each arg count and a body that explains the usage more fully.
        Returns: