Predefined (Golo Programming Language 0-preview11 API)

java.lang.Object
- gololang.Predefined

```
public class Predefined
extends Object
```
Predefined provides the module of predefined functions in Golo. The provided module is imported by default.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Object`	`aget(Object a, Object i)` Access an array element by index.
`static Object`	`alength(Object a)` Array length.
`static Object`	`Array(Object... values)` Makes a Java primitive array out of values.
`static Class<?>`	`arrayTypeOf(Object klass)` Returns an array class given a type class.
`static void`	`aset(Object a, Object i, Object value)` Updates an array element by index.
`static Object`	`asInterfaceInstance(Object interfaceClass, Object target)` Turns a method handle into a instance of a single-method interface.
`static Object`	`atoList(Object[] values)` Makes a list out of a Java primitive array.
`static boolean`	`fileExists(Object file)` Check if a file exists.
`static Object`	`fileToText(Object file, Object encoding)` Reads the content of a text file.
`static Object`	`fun(Object name, Object module)` Obtains the first method handle / closure to a function.
`static Object`	`fun(Object name, Object module, Object arity)` Obtains a method handle / closure to a function.
`static boolean`	`isArray(Object object)` Checks if an object is a (JVM) array or not.
`static Object`	`isClosure(Object object)` Test whether an object is a closure or not.
`static Object`	`mapEntry(Object key, Object value)` Makes a key / value pair.
`static Class<?>`	`objectArrayType()` Function to obtain the `Object[].class` reference.
`static void`	`print(Object obj)` Prints to the standard console.
`static void`	`println(Object obj)` Prints to the standard console, including a newline.
`static void`	`raise(Object message)` Raises a `RuntimeException` with a message.
`static void`	`raise(Object message, Object cause)` Raises a `RuntimeException` with a message and a cause.
`static Object`	`range(Object from, Object to)` Makes an integer range object between two bounds.
`static String`	`readln()` Reads the next line of characters from the console.
`static String`	`readln(String message)` Reads the next line of characters from the console.
`static String`	`readPassword()` Reads a password from the console with echoing disabled.
`static String`	`readPassword(String message)` Reads a password from the console with echoing disabled.
`static void`	`require(Object condition, Object errorMessage)` Requires that a condition be `true`.
`static void`	`requireNotNull(Object obj)` Requires that an object is not the `null` reference.
`static char[]`	`secureReadPassword()` Reads a password from the console with echoing disabled, returning an `char[]` array.
`static char[]`	`secureReadPassword(String message)` Reads a password from the console with echoing disabled, returning an `char[]` array.
`static void`	`textToFile(Object text, Object file)` Writes some text to a file.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - raise
```
public static void raise(Object message)
```
    Raises a RuntimeException with a message.
    
    Parameters:
    
    message - the exception description.
    
    Throws:
    
    RuntimeException - (always)
  - raise
```
public static void raise(Object message,
                         Object cause)
```
    Raises a RuntimeException with a message and a cause.
    
    Parameters:
    
    message - the exception description.
    
    cause - the exception cause.
    
    Throws:
    
    RuntimeException - (always)
  - print
```
public static void print(Object obj)
```
    Prints to the standard console.
    
    Parameters:
    
    obj - the object to be printed.
  - println
```
public static void println(Object obj)
```
    Prints to the standard console, including a newline.
    
    Parameters:
    
    obj - obj the object to be printed.
  - readln
```
public static String readln()
                     throws IOException
```
    Reads the next line of characters from the console.
    
    Returns:
    
    a String.
    
    Throws:
    
    IOException
  - readln
```
public static String readln(String message)
                     throws IOException
```
    Reads the next line of characters from the console.
    
    Parameters:
    
    message - displays a prompt message.
    
    Returns:
    
    a String.
    
    Throws:
    
    IOException
  - readPassword
```
public static String readPassword()
                           throws IOException
```
    Reads a password from the console with echoing disabled.
    
    Returns:
    
    a String.
    
    Throws:
    
    IOException
  - readPassword
```
public static String readPassword(String message)
                           throws IOException
```
    Reads a password from the console with echoing disabled.
    
    Parameters:
    
    message - displays a prompt message.
    
    Returns:
    
    a String.
    
    Throws:
    
    IOException
  - secureReadPassword
```
public static char[] secureReadPassword()
                                 throws IOException
```
    Reads a password from the console with echoing disabled, returning an char[] array.
    
    Returns:
    
    a character array.
    
    Throws:
    
    IOException
  - secureReadPassword
```
public static char[] secureReadPassword(String message)
                                 throws IOException
```
    Reads a password from the console with echoing disabled, returning an char[] array.
    
    Parameters:
    
    message - displays a prompt message.
    
    Returns:
    
    a character array.
    
    Throws:
    
    IOException
  - requireNotNull
```
public static void requireNotNull(Object obj)
                           throws AssertionError
```
    Requires that an object is not the null reference.
    
    Parameters:
    
    obj - the object to test against null.
    
    Throws:
    
    AssertionError - if obj is null.
  - require
```
public static void require(Object condition,
                           Object errorMessage)
                    throws IllegalArgumentException,
                           AssertionError
```
    Requires that a condition be true.
    
    Parameters:
    
    condition - the condition, must be a Boolean.
    
    errorMessage - the error message, must be a String.
    
    Throws:
    
    IllegalArgumentException - if the arguments are of the wrong type.
    
    AssertionError - if condition is false.
  - Array
```
public static Object Array(Object... values)
```
    Makes a Java primitive array out of values.
    
    Parameters:
    
    values - the values.
    
    Returns:
    
    an array.
  - atoList
```
public static Object atoList(Object[] values)
```
    Makes a list out of a Java primitive array.
    
    Parameters:
    
    values - the array.
    
    Returns:
    
    a list from the java.util package.
  - aget
```
public static Object aget(Object a,
                          Object i)
```
    Access an array element by index.
    
    Parameters:
    
    a - the array.
    
    i - the index.
    
    Returns:
    
    the element at index i.
  - aset
```
public static void aset(Object a,
                        Object i,
                        Object value)
```
    Updates an array element by index.
    
    Parameters:
    
    a - the array.
    
    i - the index.
    
    value - the new value.
  - alength
```
public static Object alength(Object a)
```
    Array length.
    
    Parameters:
    
    a - the array.
    
    Returns:
    
    the length of a.
  - range
```
public static Object range(Object from,
                           Object to)
```
    Makes an integer range object between two bounds. Range objects implement java.lang.Iterable, so they can be used in Golo foreach loops.
    
    Parameters:
    
    from - the lower-bound (inclusive) as an Integer or Long.
    
    to - the upper-bound (exclusive) as an Integer or Long.
    
    Returns:
    
    a range object.
    
    See Also:
    
    Iterable
  - mapEntry
```
public static Object mapEntry(Object key,
                              Object value)
```
    Makes a key / value pair.
    
    Parameters:
    
    key - the key.
    
    value - the value.
    
    Returns:
    
    an instance of AbstractMap.SimpleEntry
    
    See Also:
    
    AbstractMap.SimpleEntry
  - asInterfaceInstance
```
public static Object asInterfaceInstance(Object interfaceClass,
                                         Object target)
```
    Turns a method handle into a instance of a single-method interface.
    
    Parameters:
    
    interfaceClass - the target single-method interface class.
    
    target - the implementation method handle.
    
    Returns:
    
    an instance of interfaceClass.
    
    See Also:
    
    MethodHandleProxies.asInterfaceInstance(Class, java.lang.invoke.MethodHandle)
  - isClosure
```
public static Object isClosure(Object object)
```
    Test whether an object is a closure or not.
    
    Parameters:
    
    object - the object.
    
    Returns:
    
    true if object is an instance of java.lang.invoke.MethodHandle, false otherwise.
  - fun
```
public static Object fun(Object name,
                         Object module,
                         Object arity)
                  throws Throwable
```
    Obtains a method handle / closure to a function.
    
    Parameters:
    
    name - the function name.
    
    module - the function enclosing module (a Java class).
    
    arity - the function arity, where a negative value means that any arity will do.
    
    Returns:
    
    a method handle to the matched function.
    
    Throws:
    
    NoSuchMethodException - if the target function could not be found.
    
    IllegalArgumentException - if the argument types are not of types (String, Class, Integer).
    
    Throwable - if an error occurs.
  - fun
```
public static Object fun(Object name,
                         Object module)
                  throws Throwable
```
    Obtains the first method handle / closure to a function.
    This is the same as calling fun(name, module, -1).
    
    Throws:
    
    Throwable
    
    See Also:
    
    fun(Object, Object, Object)
  - fileToText
```
public static Object fileToText(Object file,
                                Object encoding)
                         throws Throwable
```
    Reads the content of a text file.
    
    Parameters:
    
    file - the file to read from as an instance of either String, File or Path.
    
    encoding - the file encoding as a String or Charset.
    
    Returns:
    
    the content as a String.
    
    Throws:
    
    Throwable
  - textToFile
```
public static void textToFile(Object text,
                              Object file)
                       throws Throwable
```
    Writes some text to a file. The file is created if it does not exist, and overwritten if it already exists.
    
    Parameters:
    
    text - the text to write.
    
    file - the file to write to as an instance of either String, File or Path.
    
    Throws:
    
    Throwable
  - fileExists
```
public static boolean fileExists(Object file)
```
    Check if a file exists.
    
    Parameters:
    
    file - the file to read from as an instance of either String, File or Path.
    
    Returns:
    
    true if the file exists, false if it doesn't
  - isArray
```
public static boolean isArray(Object object)
```
    Checks if an object is a (JVM) array or not.
    
    Parameters:
    
    object - the object to check.
    
    Returns:
    
    true if object is an array, false otherwise or if null.
  - objectArrayType
```
public static Class<?> objectArrayType()
```
    Function to obtain the Object[].class reference.
    
    Returns:
    
    Object[].class
  - arrayTypeOf
```
public static Class<?> arrayTypeOf(Object klass)
                            throws ClassNotFoundException
```
    Returns an array class given a type class.
    
    Parameters:
    
    klass - the array type.
    
    Returns:
    
    the class of the array of type klass, i.e., klass[].
    
    Throws:
    
    ClassNotFoundException - if the type could not be found.

Class Predefined

Method Summary

Methods inherited from class java.lang.Object

Method Detail

raise

raise

print

println

readln

readln

readPassword

readPassword

secureReadPassword

secureReadPassword

requireNotNull

require

Array

atoList

aget

aset

alength

range

mapEntry

asInterfaceInstance

isClosure

fun

fun

fileToText

textToFile

fileExists

isArray

objectArrayType

arrayTypeOf