protocol

java_utils_protocol

Abstract interface to Java utility predicates.

author:
Paulo Moura
version:
1.4
date:
2017/3/21
compilation flags:
static

(no dependencies on other entities)

Public interface

value_reference/2

Returns an opaque term that represents the Java value with the given name.

compilation flags:
static
template:
value_reference(Value,Reference)
mode – number of proofs:
value_reference(?atom,--ground) – one_or_more

true/1

Returns an opaque term that represents the Java value true.

compilation flags:
static
template:
true(Reference)
mode – number of proofs:
true(--ground) – one

false/1

Returns an opaque term that represents the Java value false.

compilation flags:
static
template:
false(Reference)
mode – number of proofs:
false(--ground) – one

void/1

Returns an opaque term that represents the Java value void.

compilation flags:
static
template:
void(Reference)
mode – number of proofs:
void(--ground) – one

null/1

Returns an opaque term that represents the Java value null.

compilation flags:
static
template:
null(Reference)
mode – number of proofs:
null(--ground) – one

is_true/1

True when the argument is the Java value true. Fails if the argument is not instantiated.

compilation flags:
static
template:
is_true(Reference)
mode – number of proofs:
is_true(@term) – zero_or_one

is_false/1

True when the argument is the Java value false. Fails if the argument is not instantiated.

compilation flags:
static
template:
is_false(Reference)
mode – number of proofs:
is_false(@term) – zero_or_one

is_void/1

True when the argument is the Java value void. Fails if the argument is not instantiated.

compilation flags:
static
template:
is_void(Reference)
mode – number of proofs:
is_void(@term) – zero_or_one

is_null/1

True when the argument is the Java value null. Fails if the argument is not instantiated.

compilation flags:
static
template:
is_null(Reference)
mode – number of proofs:
is_null(@term) – zero_or_one

terms_to_array/2

Converts a list of ground Prolog terms to an array (a Java reference).

compilation flags:
static
template:
terms_to_array(Terms,Array)
mode – number of proofs:
terms_to_array(++list(ground),-array) – one

array_to_terms/3

Converts an array (a Java reference) to a list of ground Prolog terms returning also its length. The array elements must be atoms, integers, floats, or compound terms. Fails otherwise.

compilation flags:
static
template:
array_to_terms(Array,Terms,Length)
mode – number of proofs:
array_to_terms(+array,-list(ground),-integer) – one

array_to_terms/2

Converts an array (a Java reference) to a list of ground Prolog terms. The array elements must be atoms, integers, floats, or ground compound terms. Fails otherwise.

compilation flags:
static
template:
array_to_terms(Array,Terms)
mode – number of proofs:
array_to_terms(+array,-list(term)) – one

array_list/2

Converts between an array (a Java reference) and a list. Deprecated. Use the terms_to_array/2 and array_to_terms/2-3 instead in new code.

compilation flags:
static
template:
array_list(Array,List)
mode – number of proofs:
array_list(+array,-list) – one
array_list(-array,+list) – one

iterator_element/2

Enumerates, by backtracking, all iterator elements.

compilation flags:
static
template:
iterator_element(Iterator,Element)
mode – number of proofs:
iterator_element(+iterator,-element) – zero_or_more

decode_exception/2

Decodes an exception into its corresponding cause. Fails if the exception is not a Java exception.

compilation flags:
static
template:
decode_exception(Exception,Cause)
mode – number of proofs:
decode_exception(+callable,-atom) – zero_or_one

decode_exception/3

Decodes an exception into its corresponding cause and a stack trace. Fails if the exception is not a Java exception.

compilation flags:
static
template:
decode_exception(Exception,Cause,StackTrace)
mode – number of proofs:
decode_exception(+callable,-atom,-list(atom)) – zero_or_one

Protected interface

(none)

Private predicates

(none)

Operators

(none)

Remarks

(none)

See also

(none)