mirrors/z3
3
0
Fork 0
mirror of https://github.com/Z3Prover/z3 synced 2025-04-06 17:44:08 +00:00
Code Activity

Java API: Added exception wrappers and build dependencies.

Browse source 
Signed-off-by: Christoph M. Wintersteiger <cwinter@microsoft.com>
This commit is contained in:
Christoph M. Wintersteiger 2012-11-30 15:39:25 +00:00
parent 654c02701c
commit 0c1f2a8281
47 changed files with 4908 additions and 4554 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
examples/java/JavaExample.java
View file

@ -159,7 +159,7 @@ class JavaExample
Sort t = f.Range(); Sort t = f.Range();
Sort[] dom = f.Domain(); Sort[] dom = f.Domain();
if (dom.length != 2 || !t.Equals(dom[0]) || !t.Equals(dom[1])) if (dom.length != 2 || !t.equals(dom[0]) || !t.equals(dom[1]))
{ {
System.out.println(Integer.toString(dom.length) + " " System.out.println(Integer.toString(dom.length) + " "
+ dom[0].toString() + " " + dom[1].toString() + " " + dom[0].toString() + " " + dom[1].toString() + " "
@ -700,7 +700,7 @@ class JavaExample
System.out.println(q2); System.out.println(q2);
} }
System.out.println(q1.Equals(q2)); System.out.println(q1.equals(q2));
} }
// / Prove that <tt>f(x, y) = f(w, v) implies y = v</tt> when // / Prove that <tt>f(x, y) = f(w, v) implies y = v</tt> when

21
scripts/mk_util.py
View file

@ -990,10 +990,13 @@ class JavaDLLComponent(Component):
else: else:
out.write('\t$(SLINK) $(SLINK_OUT_FLAG)libz3java$(SO_EXT) $(SLINK_FLAGS) api/java/Native$(OBJ_EXT) libz3$(SO_EXT)\n') out.write('\t$(SLINK) $(SLINK_OUT_FLAG)libz3java$(SO_EXT) $(SLINK_FLAGS) api/java/Native$(OBJ_EXT) libz3$(SO_EXT)\n')
out.write('%s.jar: libz3java$(SO_EXT) ' % self.package_name) out.write('%s.jar: libz3java$(SO_EXT) ' % self.package_name)
# for java_file in get_java_files(self.src_dir): deps = ''
# out.write('%s ' % java_file) for jfile in get_java_files(self.src_dir):
# for java_file in get_java_files((self.src_dir + "/%s/enumerations") % subdir): deps += ('%s/%s ' % (self.to_src_dir, jfile))
# out.write('%s ' % java_file) for jfile in get_java_files((self.src_dir + "/enumerations")):
deps += ('%s/enumerations/%s ' % (self.to_src_dir, jfile))
if IS_WINDOWS: deps = deps.replace('/', '\\')
out.write(deps)
out.write('\n') out.write('\n')
t = ('\t%s %s/enumerations/*.java -d api/java/classes\n' % (JAVAC, self.to_src_dir)) t = ('\t%s %s/enumerations/*.java -d api/java/classes\n' % (JAVAC, self.to_src_dir))
if IS_WINDOWS: t = t.replace('/','\\') if IS_WINDOWS: t = t.replace('/','\\')
@ -1103,10 +1106,12 @@ class JavaExampleComponent(ExampleComponent):
if JAVA_ENABLED: if JAVA_ENABLED:
pkg = get_component(JAVA_COMPONENT).package_name + '.jar' pkg = get_component(JAVA_COMPONENT).package_name + '.jar'
out.write('_ex_%s: %s' % (self.name, pkg)) out.write('_ex_%s: %s' % (self.name, pkg))
# for javafile in get_java_files(self.ex_dir): deps = ''
# out.write(' ') for jfile in get_java_files(self.ex_dir):
# out.write('%s/%s' % (self.to_ex_dir, javafile)) out.write(' %s/%s' % (self.to_ex_dir, jfile))
out.write('\n') if IS_WINDOWS:
deps = deps.replace('/', '\\')
out.write('%s\n' % deps)
out.write('\t%s -cp %s ' % (JAVAC, pkg)) out.write('\t%s -cp %s ' % (JAVAC, pkg))
win_ex_dir = self.to_ex_dir win_ex_dir = self.to_ex_dir
for javafile in get_java_files(self.ex_dir): for javafile in get_java_files(self.ex_dir):

55
scripts/update_api.py
View file

@ -489,18 +489,19 @@ def mk_java():
java_native = open(java_nativef, 'w') java_native = open(java_nativef, 'w')
java_native.write('// Automatically generated file\n') java_native.write('// Automatically generated file\n')
java_native.write('package %s;\n' % get_component('java').package_name) java_native.write('package %s;\n' % get_component('java').package_name)
java_native.write('import %s.enumerations.*;\n' % get_component('java').package_name)
java_native.write('public final class Native {\n') java_native.write('public final class Native {\n')
java_native.write(' public static class IntPtr { public int value; }\n') java_native.write(' public static class IntPtr { public int value; }\n')
java_native.write(' public static class LongPtr { public long value; }\n') java_native.write(' public static class LongPtr { public long value; }\n')
java_native.write(' public static class StringPtr { public String value; }\n') java_native.write(' public static class StringPtr { public String value; }\n')
java_native.write(' public static class errorHandler { public long ptr; }\n') java_native.write(' public static class errorHandler { public long ptr; }\n')
if IS_WINDOWS: if IS_WINDOWS:
java_native.write(' static { System.loadLibrary("%s"); }\n' % get_component('java').dll_name) java_native.write(' static { System.loadLibrary("%s"); }\n' % get_component('java').dll_name)
else: else:
java_native.write(' static { System.loadLibrary("%s"); }\n' % get_component('java').dll_name[3:]) # We need 3: to extract the prexi 'lib' form the dll_name java_native.write(' static { System.loadLibrary("%s"); }\n' % get_component('java').dll_name[3:]) # We need 3: to extract the prexi 'lib' form the dll_name
java_native.write('\n\n')
for name, result, params in _dotnet_decls: for name, result, params in _dotnet_decls:
java_native.write(' public static native %s %s(' % (type2java(result), java_method_name(name))) java_native.write(' protected static native %s INTERNAL%s(' % (type2java(result), java_method_name(name)))
first = True first = True
i = 0; i = 0;
for param in params: for param in params:
@ -511,12 +512,46 @@ def mk_java():
java_native.write('%s a%d' % (param2java(param), i)) java_native.write('%s a%d' % (param2java(param), i))
i = i + 1 i = i + 1
java_native.write(');\n') java_native.write(');\n')
java_native.write(' public static void main(String[] args) {\n') java_native.write('\n\n')
java_native.write(' IntPtr major = new IntPtr(), minor = new IntPtr(), build = new IntPtr(), revision = new IntPtr();\n') # Exception wrappers
java_native.write(' getVersion(major, minor, build, revision);\n') for name, result, params in _dotnet_decls:
java_native.write(' System.out.format("Z3 (for Java) %d.%d.%d%n", major.value, minor.value, build.value);\n') java_native.write(' public static %s %s(' % (type2java(result), java_method_name(name)))
java_native.write(' }\n') first = True
java_native.write('}\n'); i = 0;
for param in params:
if first:
first = False
else:
java_native.write(', ')
java_native.write('%s a%d' % (param2java(param), i))
i = i + 1
java_native.write(')')
if len(params) > 0 and param_type(params[0]) == CONTEXT:
java_native.write(' throws Z3Exception')
java_native.write('\n')
java_native.write(' {\n')
java_native.write(' ')
if result != VOID:
java_native.write('%s res = ' % type2java(result))
java_native.write('INTERNAL%s(' % (java_method_name(name)))
first = True
i = 0;
for param in params:
if first:
first = False
else:
java_native.write(', ')
java_native.write('a%d' % i)
i = i + 1
java_native.write(');\n')
if len(params) > 0 and param_type(params[0]) == CONTEXT:
java_native.write(' Z3_error_code err = Z3_error_code.fromInt(INTERNALgetErrorCode(a0));\n')
java_native.write(' if (err != Z3_error_code.Z3_OK)\n')
java_native.write(' throw new Z3Exception(INTERNALgetErrorMsgEx(a0, err.toInt()));\n')
if result != VOID:
java_native.write(' return res;\n')
java_native.write(' }\n\n')
java_native.write('}\n')
java_wrapper = open(java_wrapperf, 'w') java_wrapper = open(java_wrapperf, 'w')
java_wrapper.write('// Automatically generated file\n') java_wrapper.write('// Automatically generated file\n')
java_wrapper.write('#include<jni.h>\n') java_wrapper.write('#include<jni.h>\n')
@ -544,7 +579,7 @@ def mk_java():
java_wrapper.write(' delete [] NEW; \n\n') java_wrapper.write(' delete [] NEW; \n\n')
pkg_str = get_component('java').package_name.replace('.', '_') pkg_str = get_component('java').package_name.replace('.', '_')
for name, result, params in _dotnet_decls: for name, result, params in _dotnet_decls:
java_wrapper.write('JNIEXPORT %s JNICALL Java_%s_Native_%s(JNIEnv * jenv, jclass cls' % (type2javaw(result), pkg_str, java_method_name(name))) java_wrapper.write('JNIEXPORT %s JNICALL Java_%s_Native_INTERNAL%s(JNIEnv * jenv, jclass cls' % (type2javaw(result), pkg_str, java_method_name(name)))
i = 0; i = 0;
for param in params: for param in params:
java_wrapper.write(', ') java_wrapper.write(', ')
@ -629,7 +664,7 @@ def mk_java():
if result == STRING: if result == STRING:
java_wrapper.write(' return jenv->NewStringUTF(result);\n') java_wrapper.write(' return jenv->NewStringUTF(result);\n')
elif result != VOID: elif result != VOID:
java_wrapper.write(' return (%s) result;\n' % type2javaw(result)) java_wrapper.write(' return (%s) result;\n' % type2javaw(result))
java_wrapper.write('}\n') java_wrapper.write('}\n')
java_wrapper.write('#ifdef __cplusplus\n') java_wrapper.write('#ifdef __cplusplus\n')
java_wrapper.write('}\n') java_wrapper.write('}\n')

390
src/api/java/AST.java
View file

@ -13,216 +13,222 @@ import com.microsoft.z3.enumerations.*;
**/ **/
public class AST extends Z3Object public class AST extends Z3Object
{ {
/** /**
* Comparison operator. <param name="a">An AST</param> <param name="b">An * Comparison operator. <param name="a">An AST</param> <param name="b">An
* AST</param> * AST</param>
* *
* @return True if <paramref name="a"/> and <paramref name="b"/> are from * @return True if <paramref name="a"/> and <paramref name="b"/> are from
* the same context and represent the same sort; false otherwise. * the same context and represent the same sort; false otherwise.
**/ **/
/* Overloaded operators are not translated. */ /* Overloaded operators are not translated. */
/** /**
* Comparison operator. <param name="a">An AST</param> <param name="b">An * Comparison operator. <param name="a">An AST</param> <param name="b">An
* AST</param> * AST</param>
* *
* @return True if <paramref name="a"/> and <paramref name="b"/> are not * @return True if <paramref name="a"/> and <paramref name="b"/> are not
* from the same context or represent different sorts; false * from the same context or represent different sorts; false
* otherwise. * otherwise.
**/ **/
/* Overloaded operators are not translated. */ /* Overloaded operators are not translated. */
/** /**
* Object comparison. * Object comparison.
**/ **/
public boolean Equals(Object o) public boolean equals(Object o)
{ {
AST casted = (AST) o; AST casted = (AST) o;
if (casted == null) if (casted == null)
return false; return false;
return this == casted; return this == casted;
} }
/** /**
* Object Comparison. <param name="other">Another AST</param> * Object Comparison. <param name="other">Another AST</param>
* *
* @return Negative if the object should be sorted before <paramref * @return Negative if the object should be sorted before <paramref
* name="other"/>, positive if after else zero. * name="other"/>, positive if after else zero.
**/ **/
public int CompareTo(Object other) throws Z3Exception public int compareTo(Object other) throws Z3Exception
{ {
if (other == null) if (other == null)
return 1; return 1;
AST oAST = (AST) other; AST oAST = (AST) other;
if (oAST == null) if (oAST == null)
return 1; return 1;
else else
{ {
if (Id() < oAST.Id()) if (Id() < oAST.Id())
return -1; return -1;
else if (Id() > oAST.Id()) else if (Id() > oAST.Id())
return +1; return +1;
else else
return 0; return 0;
} }
} }
/** /**
* The AST's hash code. * The AST's hash code.
* *
* @return A hash code * @return A hash code
**/ **/
public int GetHashCode() throws Z3Exception public int GetHashCode() throws Z3Exception
{ {
return (int) Native.getAstHash(Context().nCtx(), NativeObject()); return (int) Native.getAstHash(Context().nCtx(), NativeObject());
} }
/** /**
* A unique identifier for the AST (unique among all ASTs). * A unique identifier for the AST (unique among all ASTs).
**/ **/
public int Id() throws Z3Exception public int Id() throws Z3Exception
{ {
return Native.getAstId(Context().nCtx(), NativeObject()); return Native.getAstId(Context().nCtx(), NativeObject());
} }
/** /**
* Translates (copies) the AST to the Context <paramref name="ctx"/>. <param * Translates (copies) the AST to the Context <paramref name="ctx"/>. <param
* name="ctx">A context</param> * name="ctx">A context</param>
* *
* @return A copy of the AST which is associated with <paramref name="ctx"/> * @return A copy of the AST which is associated with <paramref name="ctx"/>
**/ **/
public AST Translate(Context ctx) throws Z3Exception public AST Translate(Context ctx) throws Z3Exception
{ {
if (Context() == ctx) if (Context() == ctx)
return this; return this;
else else
return new AST(ctx, Native.translate(Context().nCtx(), return new AST(ctx, Native.translate(Context().nCtx(),
NativeObject(), ctx.nCtx())); NativeObject(), ctx.nCtx()));
} }
/** /**
* The kind of the AST. * The kind of the AST.
**/ **/
public Z3_ast_kind ASTKind() public Z3_ast_kind ASTKind() throws Z3Exception
{ {
return Z3_ast_kind.fromInt(Native.getAstKind(Context().nCtx(), return Z3_ast_kind.fromInt(Native.getAstKind(Context().nCtx(),
NativeObject())); NativeObject()));
} }
/** /**
* Indicates whether the AST is an Expr * Indicates whether the AST is an Expr
**/ **/
public boolean IsExpr() throws Z3Exception public boolean IsExpr() throws Z3Exception
{ {
switch (ASTKind()) switch (ASTKind())
{ {
case Z3_APP_AST: case Z3_APP_AST:
case Z3_NUMERAL_AST: case Z3_NUMERAL_AST:
case Z3_QUANTIFIER_AST: case Z3_QUANTIFIER_AST:
case Z3_VAR_AST: case Z3_VAR_AST:
return true; return true;
default: default:
return false; return false;
} }
} }
/** /**
* Indicates whether the AST is a BoundVariable * Indicates whether the AST is a BoundVariable
**/ **/
public boolean IsVar() throws Z3Exception public boolean IsVar() throws Z3Exception
{ {
return this.ASTKind() == Z3_ast_kind.Z3_VAR_AST; return this.ASTKind() == Z3_ast_kind.Z3_VAR_AST;
} }
/** /**
* Indicates whether the AST is a Quantifier * Indicates whether the AST is a Quantifier
**/ **/
public boolean IsQuantifier() throws Z3Exception public boolean IsQuantifier() throws Z3Exception
{ {
return this.ASTKind() == Z3_ast_kind.Z3_QUANTIFIER_AST; return this.ASTKind() == Z3_ast_kind.Z3_QUANTIFIER_AST;
} }
/** /**
* Indicates whether the AST is a Sort * Indicates whether the AST is a Sort
**/ **/
public boolean IsSort() throws Z3Exception public boolean IsSort() throws Z3Exception
{ {
return this.ASTKind() == Z3_ast_kind.Z3_SORT_AST; return this.ASTKind() == Z3_ast_kind.Z3_SORT_AST;
} }
/** /**
* Indicates whether the AST is a FunctionDeclaration * Indicates whether the AST is a FunctionDeclaration
**/ **/
public boolean IsFuncDecl() throws Z3Exception public boolean IsFuncDecl() throws Z3Exception
{ {
return this.ASTKind() == Z3_ast_kind.Z3_FUNC_DECL_AST; return this.ASTKind() == Z3_ast_kind.Z3_FUNC_DECL_AST;
} }
/** /**
* A string representation of the AST. * A string representation of the AST.
**/ **/
public String toString() public String toString()
{ {
return Native.astToString(Context().nCtx(), NativeObject()); try
} {
return Native.astToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
}
/** /**
* A string representation of the AST in s-expression notation. * A string representation of the AST in s-expression notation.
**/ **/
public String SExpr() throws Z3Exception public String SExpr() throws Z3Exception
{ {
return Native.astToString(Context().nCtx(), NativeObject()); return Native.astToString(Context().nCtx(), NativeObject());
} }
AST(Context ctx) AST(Context ctx)
{ {
super(ctx); super(ctx);
} }
AST(Context ctx, long obj) throws Z3Exception AST(Context ctx, long obj) throws Z3Exception
{ {
super(ctx, obj); super(ctx, obj);
} }
void IncRef(long o) throws Z3Exception void IncRef(long o) throws Z3Exception
{ {
// Console.WriteLine("AST IncRef()"); // Console.WriteLine("AST IncRef()");
if (Context() == null) if (Context() == null)
throw new Z3Exception("inc() called on null context"); throw new Z3Exception("inc() called on null context");
if (o == 0) if (o == 0)
throw new Z3Exception("inc() called on null AST"); throw new Z3Exception("inc() called on null AST");
Context().AST_DRQ().IncAndClear(Context(), o); Context().AST_DRQ().IncAndClear(Context(), o);
super.IncRef(o); super.IncRef(o);
} }
void DecRef(long o) throws Z3Exception void DecRef(long o) throws Z3Exception
{ {
// Console.WriteLine("AST DecRef()"); // Console.WriteLine("AST DecRef()");
if (Context() == null) if (Context() == null)
throw new Z3Exception("dec() called on null context"); throw new Z3Exception("dec() called on null context");
if (o == 0) if (o == 0)
throw new Z3Exception("dec() called on null AST"); throw new Z3Exception("dec() called on null AST");
Context().AST_DRQ().Add(o); Context().AST_DRQ().Add(o);
super.DecRef(o); super.DecRef(o);
} }
static AST Create(Context ctx, long obj) throws Z3Exception static AST Create(Context ctx, long obj) throws Z3Exception
{ {
switch (Z3_ast_kind.fromInt(Native.getAstKind(ctx.nCtx(), obj))) switch (Z3_ast_kind.fromInt(Native.getAstKind(ctx.nCtx(), obj)))
{ {
case Z3_FUNC_DECL_AST: case Z3_FUNC_DECL_AST:
return new FuncDecl(ctx, obj); return new FuncDecl(ctx, obj);
case Z3_QUANTIFIER_AST: case Z3_QUANTIFIER_AST:
return new Quantifier(ctx, obj); return new Quantifier(ctx, obj);
case Z3_SORT_AST: case Z3_SORT_AST:
return Sort.Create(ctx, obj); return Sort.Create(ctx, obj);
case Z3_APP_AST: case Z3_APP_AST:
case Z3_NUMERAL_AST: case Z3_NUMERAL_AST:
case Z3_VAR_AST: case Z3_VAR_AST:
return Expr.Create(ctx, obj); return Expr.Create(ctx, obj);
default: default:
throw new Z3Exception("Unknown AST kind"); throw new Z3Exception("Unknown AST kind");
} }
} }
} }

28
src/api/java/ASTDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
public class ASTDecRefQueue extends IDecRefQueue public class ASTDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.incRef(ctx.nCtx(), obj); try
} {
Native.incRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.decRef(ctx.nCtx(), obj); try
} {
Native.decRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

184
src/api/java/ASTMap.java
View file

@ -11,106 +11,114 @@ package com.microsoft.z3;
**/ **/
class ASTMap extends Z3Object class ASTMap extends Z3Object
{ {
/** /**
* Checks whether the map contains the key <paramref name="k"/>. <param * Checks whether the map contains the key <paramref name="k"/>. <param
* name="k">An AST</param> * name="k">An AST</param>
* *
* @return True if <paramref name="k"/> is a key in the map, false * @return True if <paramref name="k"/> is a key in the map, false
* otherwise. * otherwise.
**/ **/
public boolean Contains(AST k) public boolean Contains(AST k) throws Z3Exception
{ {
return Native.astMapContains(Context().nCtx(), NativeObject(), return Native.astMapContains(Context().nCtx(), NativeObject(),
k.NativeObject()); k.NativeObject());
} }
/** /**
* Finds the value associated with the key <paramref name="k"/>. <remarks> * Finds the value associated with the key <paramref name="k"/>. <remarks>
* This function signs an error when <paramref name="k"/> is not a key in * This function signs an error when <paramref name="k"/> is not a key in
* the map. </remarks> <param name="k">An AST</param> * the map. </remarks> <param name="k">An AST</param>
* @throws Z3Exception *
**/ * @throws Z3Exception
public AST Find(AST k) throws Z3Exception **/
{ public AST Find(AST k) throws Z3Exception
return new AST(Context(), Native.astMapFind(Context().nCtx(), {
NativeObject(), k.NativeObject())); return new AST(Context(), Native.astMapFind(Context().nCtx(),
} NativeObject(), k.NativeObject()));
}
/** /**
* Stores or replaces a new key/value pair in the map. <param name="k">The * Stores or replaces a new key/value pair in the map. <param name="k">The
* key AST</param> <param name="v">The value AST</param> * key AST</param> <param name="v">The value AST</param>
**/ **/
public void Insert(AST k, AST v) public void Insert(AST k, AST v) throws Z3Exception
{ {
Native.astMapInsert(Context().nCtx(), NativeObject(), k.NativeObject(), Native.astMapInsert(Context().nCtx(), NativeObject(), k.NativeObject(),
v.NativeObject()); v.NativeObject());
} }
/** /**
* Erases the key <paramref name="k"/> from the map. <param name="k">An * Erases the key <paramref name="k"/> from the map. <param name="k">An
* AST</param> * AST</param>
**/ **/
public void Erase(AST k) public void Erase(AST k) throws Z3Exception
{ {
Native.astMapErase(Context().nCtx(), NativeObject(), k.NativeObject()); Native.astMapErase(Context().nCtx(), NativeObject(), k.NativeObject());
} }
/** /**
* Removes all keys from the map. * Removes all keys from the map.
**/ **/
public void Reset() public void Reset() throws Z3Exception
{ {
Native.astMapReset(Context().nCtx(), NativeObject()); Native.astMapReset(Context().nCtx(), NativeObject());
} }
/** /**
* The size of the map * The size of the map
**/ **/
public int Size() public int Size() throws Z3Exception
{ {
return Native.astMapSize(Context().nCtx(), NativeObject()); return Native.astMapSize(Context().nCtx(), NativeObject());
} }
/** /**
* The keys stored in the map. * The keys stored in the map.
* @throws Z3Exception *
**/ * @throws Z3Exception
public ASTVector Keys() throws Z3Exception **/
{ public ASTVector Keys() throws Z3Exception
return new ASTVector(Context(), Native.astMapKeys(Context().nCtx(), {
NativeObject())); return new ASTVector(Context(), Native.astMapKeys(Context().nCtx(),
} NativeObject()));
}
/** /**
* Retrieves a string representation of the map. * Retrieves a string representation of the map.
**/ **/
public String toString() public String toString()
{ {
return Native.astMapToString(Context().nCtx(), NativeObject()); try
} {
return Native.astMapToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
}
ASTMap(Context ctx, long obj) throws Z3Exception ASTMap(Context ctx, long obj) throws Z3Exception
{ {
super(ctx, obj); super(ctx, obj);
} }
ASTMap(Context ctx) throws Z3Exception ASTMap(Context ctx) throws Z3Exception
{ {
super(ctx, Native.mkAstMap(ctx.nCtx())); super(ctx, Native.mkAstMap(ctx.nCtx()));
} }
void IncRef(long o) throws Z3Exception void IncRef(long o) throws Z3Exception
{ {
Context().ASTMap_DRQ().IncAndClear(Context(), o); Context().ASTMap_DRQ().IncAndClear(Context(), o);
super.IncRef(o); super.IncRef(o);
} }
void DecRef(long o) throws Z3Exception void DecRef(long o) throws Z3Exception
{ {
Context().ASTMap_DRQ().Add(o); Context().ASTMap_DRQ().Add(o);
super.DecRef(o); super.DecRef(o);
} }
} }

163
src/api/java/ASTVector.java
View file

@ -11,94 +11,99 @@ package com.microsoft.z3;
**/ **/
class ASTVector extends Z3Object class ASTVector extends Z3Object
{ {
/** /**
* The size of the vector * The size of the vector
**/ **/
public int Size() public int Size() throws Z3Exception
{ {
return Native.astVectorSize(Context().nCtx(), NativeObject()); return Native.astVectorSize(Context().nCtx(), NativeObject());
} }
/** /**
* Retrieves the i-th object in the vector. <remarks>May throw an * Retrieves the i-th object in the vector. <remarks>May throw an
* IndexOutOfBoundsException when <paramref name="i"/> is out of * IndexOutOfBoundsException when <paramref name="i"/> is out of
* range.</remarks> <param name="i">Index</param> * range.</remarks> <param name="i">Index</param>
* *
* @return An AST * @return An AST
* @throws Z3Exception * @throws Z3Exception
**/ **/
public AST get(int i) throws Z3Exception public AST get(int i) throws Z3Exception
{ {
return new AST(Context(), Native.astVectorGet(Context().nCtx(), return new AST(Context(), Native.astVectorGet(Context().nCtx(),
NativeObject(), i)); NativeObject(), i));
} }
public void set(int i, AST value) public void set(int i, AST value) throws Z3Exception
{ {
Native.astVectorSet(Context().nCtx(), NativeObject(), i, Native.astVectorSet(Context().nCtx(), NativeObject(), i,
value.NativeObject()); value.NativeObject());
} }
/** /**
* Resize the vector to <paramref name="newSize"/>. <param * Resize the vector to <paramref name="newSize"/>. <param
* name="newSize">The new size of the vector.</param> * name="newSize">The new size of the vector.</param>
**/ **/
public void Resize(int newSize) public void Resize(int newSize) throws Z3Exception
{ {
Native.astVectorResize(Context().nCtx(), NativeObject(), newSize); Native.astVectorResize(Context().nCtx(), NativeObject(), newSize);
} }
/** /**
* Add the AST <paramref name="a"/> to the back of the vector. The size is * Add the AST <paramref name="a"/> to the back of the vector. The size is
* increased by 1. <param name="a">An AST</param> * increased by 1. <param name="a">An AST</param>
**/ **/
public void Push(AST a) public void Push(AST a) throws Z3Exception
{ {
Native.astVectorPush(Context().nCtx(), NativeObject(), a.NativeObject());
}
Native.astVectorPush(Context().nCtx(), NativeObject(), a.NativeObject()); /**
} * Translates all ASTs in the vector to <paramref name="ctx"/>. <param
* name="ctx">A context</param>
*
* @return A new ASTVector
* @throws Z3Exception
**/
public ASTVector Translate(Context ctx) throws Z3Exception
{
return new ASTVector(Context(), Native.astVectorTranslate(Context()
.nCtx(), NativeObject(), ctx.nCtx()));
}
/** /**
* Translates all ASTs in the vector to <paramref name="ctx"/>. <param * Retrieves a string representation of the vector.
* name="ctx">A context</param> **/
* public String toString()
* @return A new ASTVector {
* @throws Z3Exception try
**/ {
public ASTVector Translate(Context ctx) throws Z3Exception return Native.astVectorToString(Context().nCtx(), NativeObject());
{ } catch (Z3Exception e)
return new ASTVector(Context(), Native.astVectorTranslate(Context() {
.nCtx(), NativeObject(), ctx.nCtx())); return "Z3Exception: " + e.getMessage();
} }
}
/** ASTVector(Context ctx, long obj) throws Z3Exception
* Retrieves a string representation of the vector. {
**/ super(ctx, obj);
public String toString() }
{
return Native.astVectorToString(Context().nCtx(), NativeObject());
}
ASTVector(Context ctx, long obj) throws Z3Exception ASTVector(Context ctx) throws Z3Exception
{ {
super(ctx, obj); super(ctx, Native.mkAstVector(ctx.nCtx()));
} }
ASTVector(Context ctx) throws Z3Exception void IncRef(long o) throws Z3Exception
{ {
super(ctx, Native.mkAstVector(ctx.nCtx())); Context().ASTVector_DRQ().IncAndClear(Context(), o);
} super.IncRef(o);
}
void IncRef(long o) throws Z3Exception void DecRef(long o) throws Z3Exception
{ {
Context().ASTVector_DRQ().IncAndClear(Context(), o); Context().ASTVector_DRQ().Add(o);
super.IncRef(o); super.DecRef(o);
} }
void DecRef(long o) throws Z3Exception
{
Context().ASTVector_DRQ().Add(o);
super.DecRef(o);
}
} }

115
src/api/java/ApplyResult.java
View file

@ -12,64 +12,71 @@ package com.microsoft.z3;
**/ **/
public class ApplyResult extends Z3Object public class ApplyResult extends Z3Object
{ {
/** /**
* The number of Subgoals. * The number of Subgoals.
**/ **/
public int NumSubgoals() public int NumSubgoals() throws Z3Exception
{ {
return Native.applyResultGetNumSubgoals(Context().nCtx(), return Native.applyResultGetNumSubgoals(Context().nCtx(),
NativeObject()); NativeObject());
} }
/** /**
* Retrieves the subgoals from the ApplyResult. * Retrieves the subgoals from the ApplyResult.
* @throws Z3Exception *
**/ * @throws Z3Exception
public Goal[] Subgoals() throws Z3Exception **/
{ public Goal[] Subgoals() throws Z3Exception
int n = NumSubgoals(); {
Goal[] res = new Goal[n]; int n = NumSubgoals();
for (int i = 0; i < n; i++) Goal[] res = new Goal[n];
res[i] = new Goal(Context(), Native.applyResultGetSubgoal(Context() for (int i = 0; i < n; i++)
.nCtx(), NativeObject(), i)); res[i] = new Goal(Context(), Native.applyResultGetSubgoal(Context()
return res; .nCtx(), NativeObject(), i));
} return res;
}
/** /**
* Convert a model for the subgoal <paramref name="i"/> into a model for the * Convert a model for the subgoal <paramref name="i"/> into a model for the
* original goal <code>g</code>, that the ApplyResult was obtained from. * original goal <code>g</code>, that the ApplyResult was obtained from.
* *
* @return A model for <code>g</code> * @return A model for <code>g</code>
* @throws Z3Exception * @throws Z3Exception
**/ **/
public Model ConvertModel(int i, Model m) throws Z3Exception public Model ConvertModel(int i, Model m) throws Z3Exception
{ {
return new Model(Context(), Native.applyResultConvertModel(Context() return new Model(Context(), Native.applyResultConvertModel(Context()
.nCtx(), NativeObject(), i, m.NativeObject())); .nCtx(), NativeObject(), i, m.NativeObject()));
} }
/** /**
* A string representation of the ApplyResult. * A string representation of the ApplyResult.
**/ **/
public String toString() public String toString()
{ {
return Native.applyResultToString(Context().nCtx(), NativeObject()); try
} {
return Native.applyResultToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
}
ApplyResult(Context ctx, long obj) throws Z3Exception ApplyResult(Context ctx, long obj) throws Z3Exception
{ {
super(ctx, obj); super(ctx, obj);
} }
void IncRef(long o) throws Z3Exception void IncRef(long o) throws Z3Exception
{ {
Context().ApplyResult_DRQ().IncAndClear(Context(), o); Context().ApplyResult_DRQ().IncAndClear(Context(), o);
super.IncRef(o); super.IncRef(o);
} }
void DecRef(long o) throws Z3Exception void DecRef(long o) throws Z3Exception
{ {
Context().ApplyResult_DRQ().Add(o); Context().ApplyResult_DRQ().Add(o);
super.DecRef(o); super.DecRef(o);
} }
} }

28
src/api/java/ApplyResultDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
class ApplyResultDecRefQueue extends IDecRefQueue class ApplyResultDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.applyResultIncRef(ctx.nCtx(), obj); try
} {
Native.applyResultIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.applyResultDecRef(ctx.nCtx(), obj); try
} {
Native.applyResultDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

28
src/api/java/AstMapDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
class ASTMapDecRefQueue extends IDecRefQueue class ASTMapDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.astMapIncRef(ctx.nCtx(), obj); try
} {
Native.astMapIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.astMapDecRef(ctx.nCtx(), obj); try
} {
Native.astMapDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

28
src/api/java/AstVectorDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
class ASTVectorDecRefQueue extends IDecRefQueue class ASTVectorDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.astVectorIncRef(ctx.nCtx(), obj); try
} {
Native.astVectorIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.astVectorDecRef(ctx.nCtx(), obj); try
} {
Native.astVectorDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

90
src/api/java/BitVecNum.java
View file

@ -13,50 +13,56 @@ import java.math.BigInteger;
**/ **/
public class BitVecNum extends BitVecExpr public class BitVecNum extends BitVecExpr
{ {
/** /**
* Retrieve the int value. * Retrieve the int value.
* *
* @throws Z3Exception * @throws Z3Exception
**/ **/
public int Int() throws Z3Exception public int Int() throws Z3Exception
{ {
Native.IntPtr res = new Native.IntPtr(); Native.IntPtr res = new Native.IntPtr();
if (Native.getNumeralInt(Context().nCtx(), NativeObject(), res) ^ true) if (Native.getNumeralInt(Context().nCtx(), NativeObject(), res) ^ true)
throw new Z3Exception("Numeral is not an int"); throw new Z3Exception("Numeral is not an int");
return res.value; return res.value;
} }
/** /**
* Retrieve the 64-bit int value. * Retrieve the 64-bit int value.
* *
* @throws Z3Exception * @throws Z3Exception
**/ **/
public long Long() throws Z3Exception public long Long() throws Z3Exception
{ {
Native.LongPtr res = new Native.LongPtr(); Native.LongPtr res = new Native.LongPtr();
if (Native.getNumeralInt64(Context().nCtx(), NativeObject(), res) ^ true) if (Native.getNumeralInt64(Context().nCtx(), NativeObject(), res) ^ true)
throw new Z3Exception("Numeral is not an int64"); throw new Z3Exception("Numeral is not an int64");
return res.value; return res.value;
} }
/** /**
* Retrieve the BigInteger value. * Retrieve the BigInteger value.
**/ **/
public BigInteger BigInteger() public BigInteger BigInteger()
{ {
return new BigInteger(this.toString()); return new BigInteger(this.toString());
} }
/** /**
* Returns a string representation of the numeral. * Returns a string representation of the numeral.
**/ **/
public String toString() public String toString()
{ {
return Native.getNumeralString(Context().nCtx(), NativeObject()); try
} {
return Native.getNumeralString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
}
BitVecNum(Context ctx, long obj) throws Z3Exception BitVecNum(Context ctx, long obj) throws Z3Exception
{ {
super(ctx, obj); super(ctx, obj);
} }
} }

2
src/api/java/BitVecSort.java
View file

@ -13,7 +13,7 @@ public class BitVecSort extends Sort
/** /**
* The size of the bit-vector sort. * The size of the bit-vector sort.
**/ **/
public int Size() public int Size() throws Z3Exception
{ {
return Native.getBvSortSize(Context().nCtx(), NativeObject()); return Native.getBvSortSize(Context().nCtx(), NativeObject());
} }

2
src/api/java/Constructor.java
View file

@ -54,7 +54,7 @@ public class Constructor extends Z3Object
/** /**
* Destructor. * Destructor.
**/ **/
protected void finalize() protected void finalize() throws Z3Exception
{ {
Native.delConstructor(Context().nCtx(), NativeObject()); Native.delConstructor(Context().nCtx(), NativeObject());
} }

2
src/api/java/ConstructorList.java
View file

@ -14,7 +14,7 @@ public class ConstructorList extends Z3Object
/** /**
* Destructor. * Destructor.
**/ **/
protected void finalize() protected void finalize() throws Z3Exception
{ {
Native.delConstructorList(Context().nCtx(), NativeObject()); Native.delConstructorList(Context().nCtx(), NativeObject());
} }

6218
src/api/java/Context.java
View file

File diff suppressed because it is too large Load diff

2
src/api/java/DatatypeSort.java
View file

@ -14,7 +14,7 @@ public class DatatypeSort extends Sort
/** /**
* The number of constructors of the datatype sort. * The number of constructors of the datatype sort.
**/ **/
public int NumConstructors() public int NumConstructors() throws Z3Exception
{ {
return Native.getDatatypeSortNumConstructors(Context().nCtx(), return Native.getDatatypeSortNumConstructors(Context().nCtx(),
NativeObject()); NativeObject());

2
src/api/java/FiniteDomainSort.java
View file

@ -14,7 +14,7 @@ public class FiniteDomainSort extends Sort
/** /**
* The size of the finite domain sort. * The size of the finite domain sort.
**/ **/
public long Size() public long Size() throws Z3Exception
{ {
Native.LongPtr res = new Native.LongPtr(); Native.LongPtr res = new Native.LongPtr();
Native.getFiniteDomainSortSize(Context().nCtx(), NativeObject(), res); Native.getFiniteDomainSortSize(Context().nCtx(), NativeObject(), res);

550
src/api/java/Fixedpoint.java
View file

@ -14,314 +14,320 @@ import com.microsoft.z3.enumerations.*;
public class Fixedpoint extends Z3Object public class Fixedpoint extends Z3Object
{ {
/** /**
* A string that describes all available fixedpoint solver parameters. * A string that describes all available fixedpoint solver parameters.
**/ **/
public String Help() public String Help() throws Z3Exception
{ {
return Native.fixedpointGetHelp(Context().nCtx(), NativeObject());
}
return Native.fixedpointGetHelp(Context().nCtx(), NativeObject()); /**
} * Sets the fixedpoint solver parameters.
*
* @throws Z3Exception
**/
public void setParameters(Params value) throws Z3Exception
{
/** Context().CheckContextMatch(value);
* Sets the fixedpoint solver parameters. Native.fixedpointSetParams(Context().nCtx(), NativeObject(),
* value.NativeObject());
* @throws Z3Exception }
**/
public void setParameters(Params value) throws Z3Exception
{
Context().CheckContextMatch(value); /**
Native.fixedpointSetParams(Context().nCtx(), NativeObject(), * Retrieves parameter descriptions for Fixedpoint solver.
value.NativeObject()); *
} * @throws Z3Exception
**/
public ParamDescrs ParameterDescriptions() throws Z3Exception
{
return new ParamDescrs(Context(), Native.fixedpointGetParamDescrs(
Context().nCtx(), NativeObject()));
}
/** /**
* Retrieves parameter descriptions for Fixedpoint solver. * Assert a constraint (or multiple) into the fixedpoint solver.
* @throws Z3Exception *
**/ * @throws Z3Exception
public ParamDescrs ParameterDescriptions() throws Z3Exception **/
{ public void Assert(BoolExpr[] constraints) throws Z3Exception
return new ParamDescrs(Context(), Native.fixedpointGetParamDescrs( {
Context().nCtx(), NativeObject())); Context().CheckContextMatch(constraints);
} for (BoolExpr a : constraints)
{
Native.fixedpointAssert(Context().nCtx(), NativeObject(),
a.NativeObject());
}
}
/** /**
* Assert a constraint (or multiple) into the fixedpoint solver. * Register predicate as recursive relation.
* *
* @throws Z3Exception * @throws Z3Exception
**/ **/
public void Assert(BoolExpr[] constraints) throws Z3Exception public void RegisterRelation(FuncDecl f) throws Z3Exception
{ {
Context().CheckContextMatch(constraints); Context().CheckContextMatch(f);
for (BoolExpr a : constraints) Native.fixedpointRegisterRelation(Context().nCtx(), NativeObject(),
{ f.NativeObject());
Native.fixedpointAssert(Context().nCtx(), NativeObject(), }
a.NativeObject());
}
}
/** /**
* Register predicate as recursive relation. * Add rule into the fixedpoint solver.
* *
* @throws Z3Exception * @throws Z3Exception
**/ **/
public void RegisterRelation(FuncDecl f) throws Z3Exception public void AddRule(BoolExpr rule, Symbol name) throws Z3Exception
{ {
Context().CheckContextMatch(f); Context().CheckContextMatch(rule);
Native.fixedpointRegisterRelation(Context().nCtx(), NativeObject(), Native.fixedpointAddRule(Context().nCtx(), NativeObject(),
f.NativeObject()); rule.NativeObject(), AST.GetNativeObject(name));
} }
/** /**
* Add rule into the fixedpoint solver. * Add table fact to the fixedpoint solver.
* *
* @throws Z3Exception * @throws Z3Exception
**/ **/
public void AddRule(BoolExpr rule, Symbol name) throws Z3Exception public void AddFact(FuncDecl pred, int[] args) throws Z3Exception
{ {
Context().CheckContextMatch(rule); Context().CheckContextMatch(pred);
Native.fixedpointAddRule(Context().nCtx(), NativeObject(), Native.fixedpointAddFact(Context().nCtx(), NativeObject(),
rule.NativeObject(), AST.GetNativeObject(name)); pred.NativeObject(), (int) args.length, args);
} }
/** /**
* Add table fact to the fixedpoint solver. * Query the fixedpoint solver. A query is a conjunction of constraints. The
* * constraints may include the recursively defined relations. The query is
* @throws Z3Exception * satisfiable if there is an instance of the query variables and a
**/ * derivation for it. The query is unsatisfiable if there are no derivations
public void AddFact(FuncDecl pred, int[] args) throws Z3Exception * satisfying the query variables.
{ *
* @throws Z3Exception
**/
public Status Query(BoolExpr query) throws Z3Exception
{
Context().CheckContextMatch(pred); Context().CheckContextMatch(query);
Native.fixedpointAddFact(Context().nCtx(), NativeObject(), Z3_lbool r = Z3_lbool.fromInt(Native.fixedpointQuery(Context().nCtx(),
pred.NativeObject(), (int) args.length, args); NativeObject(), query.NativeObject()));
} switch (r)
{
case Z3_L_TRUE:
return Status.SATISFIABLE;
case Z3_L_FALSE:
return Status.UNSATISFIABLE;
default:
return Status.UNKNOWN;
}
}
/** /**
* Query the fixedpoint solver. A query is a conjunction of constraints. The * Query the fixedpoint solver. A query is an array of relations. The query
* constraints may include the recursively defined relations. The query is * is satisfiable if there is an instance of some relation that is
* satisfiable if there is an instance of the query variables and a * non-empty. The query is unsatisfiable if there are no derivations
* derivation for it. The query is unsatisfiable if there are no derivations * satisfying any of the relations.
* satisfying the query variables. *
* * @throws Z3Exception
* @throws Z3Exception **/
**/ public Status Query(FuncDecl[] relations) throws Z3Exception
public Status Query(BoolExpr query) throws Z3Exception {
{
Context().CheckContextMatch(query); Context().CheckContextMatch(relations);
Z3_lbool r = Z3_lbool.fromInt(Native.fixedpointQuery(Context().nCtx(), Z3_lbool r = Z3_lbool.fromInt(Native.fixedpointQueryRelations(Context()
NativeObject(), query.NativeObject())); .nCtx(), NativeObject(), AST.ArrayLength(relations), AST
switch (r) .ArrayToNative(relations)));
{ switch (r)
case Z3_L_TRUE: {
return Status.SATISFIABLE; case Z3_L_TRUE:
case Z3_L_FALSE: return Status.SATISFIABLE;
return Status.UNSATISFIABLE; case Z3_L_FALSE:
default: return Status.UNSATISFIABLE;
return Status.UNKNOWN; default:
} return Status.UNKNOWN;
} }
}
/** /**
* Query the fixedpoint solver. A query is an array of relations. The query * Creates a backtracking point. <seealso cref="Pop"/>
* is satisfiable if there is an instance of some relation that is **/
* non-empty. The query is unsatisfiable if there are no derivations public void Push() throws Z3Exception
* satisfying any of the relations. {
* Native.fixedpointPush(Context().nCtx(), NativeObject());
* @throws Z3Exception }
**/
public Status Query(FuncDecl[] relations) throws Z3Exception
{
Context().CheckContextMatch(relations); /**
Z3_lbool r = Z3_lbool.fromInt(Native.fixedpointQueryRelations(Context() * Backtrack one backtracking point. <remarks>Note that an exception is
.nCtx(), NativeObject(), AST.ArrayLength(relations), AST * thrown if Pop is called without a corresponding <code>Push</code>
.ArrayToNative(relations))); * </remarks> <seealso cref="Push"/>
switch (r) **/
{ public void Pop() throws Z3Exception
case Z3_L_TRUE: {
return Status.SATISFIABLE; Native.fixedpointPop(Context().nCtx(), NativeObject());
case Z3_L_FALSE: }
return Status.UNSATISFIABLE;
default:
return Status.UNKNOWN;
}
}
/** /**
* Creates a backtracking point. <seealso cref="Pop"/> * Update named rule into in the fixedpoint solver.
**/ *
public void Push() * @throws Z3Exception
{ **/
Native.fixedpointPush(Context().nCtx(), NativeObject()); public void UpdateRule(BoolExpr rule, Symbol name) throws Z3Exception
} {
/** Context().CheckContextMatch(rule);
* Backtrack one backtracking point. <remarks>Note that an exception is Native.fixedpointUpdateRule(Context().nCtx(), NativeObject(),
* thrown if Pop is called without a corresponding <code>Push</code> rule.NativeObject(), AST.GetNativeObject(name));
* </remarks> <seealso cref="Push"/> }
**/
public void Pop()
{
Native.fixedpointPop(Context().nCtx(), NativeObject());
}
/** /**
* Update named rule into in the fixedpoint solver. * Retrieve satisfying instance or instances of solver, or definitions for
* * the recursive predicates that show unsatisfiability.
* @throws Z3Exception *
**/ * @throws Z3Exception
public void UpdateRule(BoolExpr rule, Symbol name) throws Z3Exception **/
{ public Expr GetAnswer() throws Z3Exception
{
long ans = Native.fixedpointGetAnswer(Context().nCtx(), NativeObject());
return (ans == 0) ? null : Expr.Create(Context(), ans);
}
Context().CheckContextMatch(rule); /**
Native.fixedpointUpdateRule(Context().nCtx(), NativeObject(), * Retrieve explanation why fixedpoint engine returned status Unknown.
rule.NativeObject(), AST.GetNativeObject(name)); **/
} public String GetReasonUnknown() throws Z3Exception
{
/** return Native.fixedpointGetReasonUnknown(Context().nCtx(),
* Retrieve satisfying instance or instances of solver, or definitions for NativeObject());
* the recursive predicates that show unsatisfiability. }
*
* @throws Z3Exception
**/
public Expr GetAnswer() throws Z3Exception
{
long ans = Native.fixedpointGetAnswer(Context().nCtx(), NativeObject());
return (ans == 0) ? null : Expr.Create(Context(), ans);
}
/** /**
* Retrieve explanation why fixedpoint engine returned status Unknown. * Retrieve the number of levels explored for a given predicate.
**/ **/
public String GetReasonUnknown() public int GetNumLevels(FuncDecl predicate) throws Z3Exception
{ {
return Native.fixedpointGetNumLevels(Context().nCtx(), NativeObject(),
predicate.NativeObject());
}
return Native.fixedpointGetReasonUnknown(Context().nCtx(), /**
NativeObject()); * Retrieve the cover of a predicate.
} *
* @throws Z3Exception
**/
public Expr GetCoverDelta(int level, FuncDecl predicate) throws Z3Exception
{
long res = Native.fixedpointGetCoverDelta(Context().nCtx(),
NativeObject(), level, predicate.NativeObject());
return (res == 0) ? null : Expr.Create(Context(), res);
}
/** /**
* Retrieve the number of levels explored for a given predicate. * Add <tt>property</tt> about the <tt>predicate</tt>. The property is added
**/ * at <tt>level</tt>.
public int GetNumLevels(FuncDecl predicate) **/
{ public void AddCover(int level, FuncDecl predicate, Expr property)
return Native.fixedpointGetNumLevels(Context().nCtx(), NativeObject(), throws Z3Exception
predicate.NativeObject()); {
} Native.fixedpointAddCover(Context().nCtx(), NativeObject(), level,
predicate.NativeObject(), property.NativeObject());
}
/** /**
* Retrieve the cover of a predicate. * Retrieve internal string representation of fixedpoint object.
* **/
* @throws Z3Exception public String toString()
**/ {
public Expr GetCoverDelta(int level, FuncDecl predicate) throws Z3Exception try
{ {
long res = Native.fixedpointGetCoverDelta(Context().nCtx(), return Native.fixedpointToString(Context().nCtx(), NativeObject(),
NativeObject(), level, predicate.NativeObject()); 0, null);
return (res == 0) ? null : Expr.Create(Context(), res); } catch (Z3Exception e)
} {
return "Z3Exception: " + e.getMessage();
}
}
/** /**
* Add <tt>property</tt> about the <tt>predicate</tt>. The property is added * Instrument the Datalog engine on which table representation to use for
* at <tt>level</tt>. * recursive predicate.
**/ **/
public void AddCover(int level, FuncDecl predicate, Expr property) public void SetPredicateRepresentation(FuncDecl f, Symbol[] kinds) throws Z3Exception
{ {
Native.fixedpointAddCover(Context().nCtx(), NativeObject(), level,
predicate.NativeObject(), property.NativeObject());
}
/** Native.fixedpointSetPredicateRepresentation(Context().nCtx(),
* Retrieve internal string representation of fixedpoint object. NativeObject(), f.NativeObject(), AST.ArrayLength(kinds),
**/ Symbol.ArrayToNative(kinds));
public String toString()
{
return Native.fixedpointToString(Context().nCtx(), NativeObject(), 0,
null);
}
/** }
* Instrument the Datalog engine on which table representation to use for
* recursive predicate.
**/
public void SetPredicateRepresentation(FuncDecl f, Symbol[] kinds)
{
Native.fixedpointSetPredicateRepresentation(Context().nCtx(), /**
NativeObject(), f.NativeObject(), AST.ArrayLength(kinds), * Convert benchmark given as set of axioms, rules and queries to a string.
Symbol.ArrayToNative(kinds)); **/
public String toString(BoolExpr[] queries) throws Z3Exception
{
} return Native.fixedpointToString(Context().nCtx(), NativeObject(),
AST.ArrayLength(queries), AST.ArrayToNative(queries));
}
/** /**
* Convert benchmark given as set of axioms, rules and queries to a string. * Retrieve set of rules added to fixedpoint context.
**/ *
public String toString(BoolExpr[] queries) * @throws Z3Exception
{ **/
public BoolExpr[] Rules() throws Z3Exception
{
return Native.fixedpointToString(Context().nCtx(), NativeObject(), ASTVector v = new ASTVector(Context(), Native.fixedpointGetRules(
AST.ArrayLength(queries), AST.ArrayToNative(queries)); Context().nCtx(), NativeObject()));
} int n = v.Size();
BoolExpr[] res = new BoolExpr[n];
for (int i = 0; i < n; i++)
res[i] = new BoolExpr(Context(), v.get(i).NativeObject());
return res;
}
/** /**
* Retrieve set of rules added to fixedpoint context. * Retrieve set of assertions added to fixedpoint context.
* *
* @throws Z3Exception * @throws Z3Exception
**/ **/
public BoolExpr[] Rules() throws Z3Exception public BoolExpr[] Assertions() throws Z3Exception
{ {
ASTVector v = new ASTVector(Context(), Native.fixedpointGetRules( ASTVector v = new ASTVector(Context(), Native.fixedpointGetAssertions(
Context().nCtx(), NativeObject())); Context().nCtx(), NativeObject()));
int n = v.Size(); int n = v.Size();
BoolExpr[] res = new BoolExpr[n]; BoolExpr[] res = new BoolExpr[n];
for (int i = 0; i < n; i++) for (int i = 0; i < n; i++)
res[i] = new BoolExpr(Context(), v.get(i).NativeObject()); res[i] = new BoolExpr(Context(), v.get(i).NativeObject());
return res; return res;
} }
/** Fixedpoint(Context ctx, long obj) throws Z3Exception
* Retrieve set of assertions added to fixedpoint context. {
* super(ctx, obj);
* @throws Z3Exception }
**/
public BoolExpr[] Assertions() throws Z3Exception
{
ASTVector v = new ASTVector(Context(), Native.fixedpointGetAssertions( Fixedpoint(Context ctx) throws Z3Exception
Context().nCtx(), NativeObject())); {
int n = v.Size(); super(ctx, Native.mkFixedpoint(ctx.nCtx()));
BoolExpr[] res = new BoolExpr[n]; }
for (int i = 0; i < n; i++)
res[i] = new BoolExpr(Context(), v.get(i).NativeObject());
return res;
}
Fixedpoint(Context ctx, long obj) throws Z3Exception void IncRef(long o) throws Z3Exception
{ {
super(ctx, obj); Context().Fixedpoint_DRQ().IncAndClear(Context(), o);
} super.IncRef(o);
}
Fixedpoint(Context ctx) throws Z3Exception void DecRef(long o) throws Z3Exception
{ {
super(ctx, Native.mkFixedpoint(ctx.nCtx())); Context().Fixedpoint_DRQ().Add(o);
} super.DecRef(o);
}
void IncRef(long o) throws Z3Exception
{
Context().Fixedpoint_DRQ().IncAndClear(Context(), o);
super.IncRef(o);
}
void DecRef(long o) throws Z3Exception
{
Context().Fixedpoint_DRQ().Add(o);
super.DecRef(o);
}
} }

28
src/api/java/FixedpointDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
class FixedpointDecRefQueue extends IDecRefQueue class FixedpointDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.fixedpointIncRef(ctx.nCtx(), obj); try
} {
Native.fixedpointIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.fixedpointDecRef(ctx.nCtx(), obj); try
} {
Native.fixedpointDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

666
src/api/java/FuncDecl.java
View file

@ -13,379 +13,385 @@ import com.microsoft.z3.enumerations.*;
**/ **/
public class FuncDecl extends AST public class FuncDecl extends AST
{ {
/** /**
* Comparison operator. * Comparison operator.
* *
* @return True if <paramref name="a"/> and <paramref name="b"/> share the * @return True if <paramref name="a"/> and <paramref name="b"/> share the
* same context and are equal, false otherwise. * same context and are equal, false otherwise.
**/ **/
/* Overloaded operators are not translated. */ /* Overloaded operators are not translated. */
/** /**
* Comparison operator. * Comparison operator.
* *
* @return True if <paramref name="a"/> and <paramref name="b"/> do not * @return True if <paramref name="a"/> and <paramref name="b"/> do not
* share the same context or are not equal, false otherwise. * share the same context or are not equal, false otherwise.
**/ **/
/* Overloaded operators are not translated. */ /* Overloaded operators are not translated. */
/** /**
* Object comparison. * Object comparison.
**/ **/
public boolean Equals(Object o) public boolean Equals(Object o)
{ {
FuncDecl casted = (FuncDecl) o; FuncDecl casted = (FuncDecl) o;
if (casted == null) if (casted == null)
return false; return false;
return this == casted; return this == casted;
} }
/** /**
* A hash code. * A hash code.
**/ **/
public int GetHashCode() throws Z3Exception public int GetHashCode() throws Z3Exception
{ {
return super.GetHashCode(); return super.GetHashCode();
} }
/** /**
* A string representations of the function declaration. * A string representations of the function declaration.
**/ **/
public String toString() public String toString()
{ {
return Native.funcDeclToString(Context().nCtx(), NativeObject()); try
} {
return Native.funcDeclToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
}
/** /**
* Returns a unique identifier for the function declaration. * Returns a unique identifier for the function declaration.
**/ **/
public int Id() throws Z3Exception public int Id() throws Z3Exception
{ {
return Native.getFuncDeclId(Context().nCtx(), NativeObject()); return Native.getFuncDeclId(Context().nCtx(), NativeObject());
} }
/** /**
* The arity of the function declaration * The arity of the function declaration
**/ **/
public int Arity() throws Z3Exception public int Arity() throws Z3Exception
{ {
return Native.getArity(Context().nCtx(), NativeObject()); return Native.getArity(Context().nCtx(), NativeObject());
} }
/** /**
* The size of the domain of the function declaration <seealso * The size of the domain of the function declaration <seealso
* cref="Arity"/> * cref="Arity"/>
**/ **/
public int DomainSize() public int DomainSize() throws Z3Exception
{ {
return Native.getDomainSize(Context().nCtx(), NativeObject()); return Native.getDomainSize(Context().nCtx(), NativeObject());
} }
/** /**
* The domain of the function declaration * The domain of the function declaration
**/ **/
public Sort[] Domain() throws Z3Exception public Sort[] Domain() throws Z3Exception
{ {
int n = DomainSize(); int n = DomainSize();
Sort[] res = new Sort[n]; Sort[] res = new Sort[n];
for (int i = 0; i < n; i++) for (int i = 0; i < n; i++)
res[i] = Sort.Create(Context(), res[i] = Sort.Create(Context(),
Native.getDomain(Context().nCtx(), NativeObject(), i)); Native.getDomain(Context().nCtx(), NativeObject(), i));
return res; return res;
} }
/** /**
* The range of the function declaration * The range of the function declaration
**/ **/
public Sort Range() throws Z3Exception public Sort Range() throws Z3Exception
{ {
return Sort.Create(Context(), return Sort.Create(Context(),
Native.getRange(Context().nCtx(), NativeObject())); Native.getRange(Context().nCtx(), NativeObject()));
} }
/** /**
* The kind of the function declaration. * The kind of the function declaration.
**/ **/
public Z3_decl_kind DeclKind() throws Z3Exception public Z3_decl_kind DeclKind() throws Z3Exception
{ {
return Z3_decl_kind.fromInt(Native.getDeclKind(Context().nCtx(), return Z3_decl_kind.fromInt(Native.getDeclKind(Context().nCtx(),
NativeObject())); NativeObject()));
} }
/** /**
* The name of the function declaration * The name of the function declaration
**/ **/
public Symbol Name() throws Z3Exception public Symbol Name() throws Z3Exception
{ {
return Symbol.Create(Context(), return Symbol.Create(Context(),
Native.getDeclName(Context().nCtx(), NativeObject())); Native.getDeclName(Context().nCtx(), NativeObject()));
} }
/** /**
* The number of parameters of the function declaration * The number of parameters of the function declaration
**/ **/
public int NumParameters() throws Z3Exception public int NumParameters() throws Z3Exception
{ {
return Native.getDeclNumParameters(Context().nCtx(), NativeObject()); return Native.getDeclNumParameters(Context().nCtx(), NativeObject());
} }
/** /**
* The parameters of the function declaration * The parameters of the function declaration
**/ **/
public Parameter[] Parameters() throws Z3Exception public Parameter[] Parameters() throws Z3Exception
{ {
int num = NumParameters(); int num = NumParameters();
Parameter[] res = new Parameter[num]; Parameter[] res = new Parameter[num];
for (int i = 0; i < num; i++) for (int i = 0; i < num; i++)
{ {
Z3_parameter_kind k = Z3_parameter_kind.fromInt(Native Z3_parameter_kind k = Z3_parameter_kind.fromInt(Native
.getDeclParameterKind(Context().nCtx(), NativeObject(), i)); .getDeclParameterKind(Context().nCtx(), NativeObject(), i));
switch (k) switch (k)
{ {
case Z3_PARAMETER_INT: case Z3_PARAMETER_INT:
res[i] = new Parameter(k, Native.getDeclIntParameter(Context() res[i] = new Parameter(k, Native.getDeclIntParameter(Context()
.nCtx(), NativeObject(), i)); .nCtx(), NativeObject(), i));
break; break;
case Z3_PARAMETER_DOUBLE: case Z3_PARAMETER_DOUBLE:
res[i] = new Parameter(k, Native.getDeclDoubleParameter( res[i] = new Parameter(k, Native.getDeclDoubleParameter(
Context().nCtx(), NativeObject(), i)); Context().nCtx(), NativeObject(), i));
break; break;
case Z3_PARAMETER_SYMBOL: case Z3_PARAMETER_SYMBOL:
res[i] = new Parameter(k, Symbol.Create(Context(), Native res[i] = new Parameter(k, Symbol.Create(Context(), Native
.getDeclSymbolParameter(Context().nCtx(), .getDeclSymbolParameter(Context().nCtx(),
NativeObject(), i))); NativeObject(), i)));
break; break;
case Z3_PARAMETER_SORT: case Z3_PARAMETER_SORT:
res[i] = new Parameter(k, Sort.Create(Context(), Native res[i] = new Parameter(k, Sort.Create(Context(), Native
.getDeclSortParameter(Context().nCtx(), NativeObject(), .getDeclSortParameter(Context().nCtx(), NativeObject(),
i))); i)));
break; break;
case Z3_PARAMETER_AST: case Z3_PARAMETER_AST:
res[i] = new Parameter(k, new AST(Context(), res[i] = new Parameter(k, new AST(Context(),
Native.getDeclAstParameter(Context().nCtx(), Native.getDeclAstParameter(Context().nCtx(),
NativeObject(), i))); NativeObject(), i)));
break; break;
case Z3_PARAMETER_FUNC_DECL: case Z3_PARAMETER_FUNC_DECL:
res[i] = new Parameter(k, new FuncDecl(Context(), res[i] = new Parameter(k, new FuncDecl(Context(),
Native.getDeclFuncDeclParameter(Context().nCtx(), Native.getDeclFuncDeclParameter(Context().nCtx(),
NativeObject(), i))); NativeObject(), i)));
break; break;
case Z3_PARAMETER_RATIONAL: case Z3_PARAMETER_RATIONAL:
res[i] = new Parameter(k, Native.getDeclRationalParameter( res[i] = new Parameter(k, Native.getDeclRationalParameter(
Context().nCtx(), NativeObject(), i)); Context().nCtx(), NativeObject(), i));
break; break;
default: default:
throw new Z3Exception( throw new Z3Exception(
"Unknown function declaration parameter kind encountered"); "Unknown function declaration parameter kind encountered");
} }
} }
return res; return res;
} }
/** /**
* Function declarations can have Parameters associated with them. * Function declarations can have Parameters associated with them.
**/ **/
public class Parameter public class Parameter
{ {
private Z3_parameter_kind kind; private Z3_parameter_kind kind;
private int i; private int i;
private double d; private double d;
private Symbol sym; private Symbol sym;
private Sort srt; private Sort srt;
private AST ast; private AST ast;
private FuncDecl fd; private FuncDecl fd;
private String r; private String r;
/** /**
* The int value of the parameter.</summary> * The int value of the parameter.</summary>
**/ **/
public int Int() throws Z3Exception public int Int() throws Z3Exception
{ {
if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_INT) if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_INT)
throw new Z3Exception("parameter is not an int"); throw new Z3Exception("parameter is not an int");
return i; return i;
} }
/** /**
* The double value of the parameter.</summary> * The double value of the parameter.</summary>
**/ **/
public double Double() throws Z3Exception public double Double() throws Z3Exception
{ {
if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_DOUBLE) if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_DOUBLE)
throw new Z3Exception("parameter is not a double "); throw new Z3Exception("parameter is not a double ");
return d; return d;
} }
/** /**
* The Symbol value of the parameter.</summary> * The Symbol value of the parameter.</summary>
**/ **/
public Symbol Symbol() throws Z3Exception public Symbol Symbol() throws Z3Exception
{ {
if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_SYMBOL) if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_SYMBOL)
throw new Z3Exception("parameter is not a Symbol"); throw new Z3Exception("parameter is not a Symbol");
return sym; return sym;
} }
/** /**
* The Sort value of the parameter.</summary> * The Sort value of the parameter.</summary>
**/ **/
public Sort Sort() throws Z3Exception public Sort Sort() throws Z3Exception
{ {
if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_SORT) if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_SORT)
throw new Z3Exception("parameter is not a Sort"); throw new Z3Exception("parameter is not a Sort");
return srt; return srt;
} }
/** /**
* The AST value of the parameter.</summary> * The AST value of the parameter.</summary>
**/ **/
public AST AST() throws Z3Exception public AST AST() throws Z3Exception
{ {
if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_AST) if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_AST)
throw new Z3Exception("parameter is not an AST"); throw new Z3Exception("parameter is not an AST");
return ast; return ast;
} }
/** /**
* The FunctionDeclaration value of the parameter.</summary> * The FunctionDeclaration value of the parameter.</summary>
**/ **/
public FuncDecl FuncDecl() throws Z3Exception public FuncDecl FuncDecl() throws Z3Exception
{ {
if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_FUNC_DECL) if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_FUNC_DECL)
throw new Z3Exception("parameter is not a function declaration"); throw new Z3Exception("parameter is not a function declaration");
return fd; return fd;
} }
/** /**
* The rational string value of the parameter.</summary> * The rational string value of the parameter.</summary>
**/ **/
public String Rational() throws Z3Exception public String Rational() throws Z3Exception
{ {
if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_RATIONAL) if (ParameterKind() != Z3_parameter_kind.Z3_PARAMETER_RATIONAL)
throw new Z3Exception("parameter is not a rational String"); throw new Z3Exception("parameter is not a rational String");
return r; return r;
} }
/** /**
* The kind of the parameter. * The kind of the parameter.
**/ **/
public Z3_parameter_kind ParameterKind() throws Z3Exception public Z3_parameter_kind ParameterKind() throws Z3Exception
{ {
return kind; return kind;
} }
Parameter(Z3_parameter_kind k, int i) Parameter(Z3_parameter_kind k, int i)
{ {
this.kind = k; this.kind = k;
this.i = i; this.i = i;
} }
Parameter(Z3_parameter_kind k, double d) Parameter(Z3_parameter_kind k, double d)
{ {
this.kind = k; this.kind = k;
this.d = d; this.d = d;
} }
Parameter(Z3_parameter_kind k, Symbol s) Parameter(Z3_parameter_kind k, Symbol s)
{ {
this.kind = k; this.kind = k;
this.sym = s; this.sym = s;
} }
Parameter(Z3_parameter_kind k, Sort s) Parameter(Z3_parameter_kind k, Sort s)
{ {
this.kind = k; this.kind = k;
this.srt = s; this.srt = s;
} }
Parameter(Z3_parameter_kind k, AST a) Parameter(Z3_parameter_kind k, AST a)
{ {
this.kind = k; this.kind = k;
this.ast = a; this.ast = a;
} }
Parameter(Z3_parameter_kind k, FuncDecl fd) Parameter(Z3_parameter_kind k, FuncDecl fd)
{ {
this.kind = k; this.kind = k;
this.fd = fd; this.fd = fd;
} }
Parameter(Z3_parameter_kind k, String r) Parameter(Z3_parameter_kind k, String r)
{ {
this.kind = k; this.kind = k;
this.r = r; this.r = r;
} }
} }
FuncDecl(Context ctx, long obj) throws Z3Exception FuncDecl(Context ctx, long obj) throws Z3Exception
{ {
super(ctx, obj); super(ctx, obj);
} }
FuncDecl(Context ctx, Symbol name, Sort[] domain, Sort range) FuncDecl(Context ctx, Symbol name, Sort[] domain, Sort range)
throws Z3Exception throws Z3Exception
{ {
super(ctx, Native.mkFuncDecl(ctx.nCtx(), name.NativeObject(), super(ctx, Native.mkFuncDecl(ctx.nCtx(), name.NativeObject(),
AST.ArrayLength(domain), AST.ArrayToNative(domain), AST.ArrayLength(domain), AST.ArrayToNative(domain),
range.NativeObject())); range.NativeObject()));
} }
FuncDecl(Context ctx, String prefix, Sort[] domain, Sort range) FuncDecl(Context ctx, String prefix, Sort[] domain, Sort range)
throws Z3Exception throws Z3Exception
{ {
super(ctx, Native.mkFreshFuncDecl(ctx.nCtx(), prefix, super(ctx, Native.mkFreshFuncDecl(ctx.nCtx(), prefix,
AST.ArrayLength(domain), AST.ArrayToNative(domain), AST.ArrayLength(domain), AST.ArrayToNative(domain),
range.NativeObject())); range.NativeObject()));
} }
void CheckNativeObject(long obj) throws Z3Exception void CheckNativeObject(long obj) throws Z3Exception
{ {
if (Native.getAstKind(Context().nCtx(), obj) != Z3_ast_kind.Z3_FUNC_DECL_AST if (Native.getAstKind(Context().nCtx(), obj) != Z3_ast_kind.Z3_FUNC_DECL_AST
.toInt()) .toInt())
throw new Z3Exception( throw new Z3Exception(
"Underlying object is not a function declaration"); "Underlying object is not a function declaration");
super.CheckNativeObject(obj); super.CheckNativeObject(obj);
} }
/** /**
* Create expression that applies function to arguments. * Create expression that applies function to arguments. <param
* <param name="args"></param> * name="args"></param>
* *
* @return * @return
**/ **/
/* operator this[] not translated */ /* operator this[] not translated */
/** /**
* Create expression that applies function to arguments. * Create expression that applies function to arguments. <param
* <param name="args"></param> * name="args"></param>
* *
* @return * @return
**/ **/
public Expr Apply(Expr[] args) throws Z3Exception public Expr Apply(Expr[] args) throws Z3Exception
{ {
Context().CheckContextMatch(args); Context().CheckContextMatch(args);
return Expr.Create(Context(), this, args); return Expr.Create(Context(), this, args);
} }
/** /**
* Create expression that applies function to one argument. * Create expression that applies function to one argument. <param
* <param name="arg"></param> * name="arg"></param>
* *
* @return * @return
**/ **/
public Expr Apply(Expr arg) throws Z3Exception public Expr Apply(Expr arg) throws Z3Exception
{ {
Context().CheckContextMatch(arg); Context().CheckContextMatch(arg);
Expr[] a = { arg }; Expr[] a = { arg };
return Expr.Create(Context(), this, a); return Expr.Create(Context(), this, a);
} }
} }

6
src/api/java/FuncInterp.java
View file

@ -33,7 +33,7 @@ public class FuncInterp extends Z3Object
/** /**
* The number of arguments of the entry. * The number of arguments of the entry.
**/ **/
public int NumArgs() public int NumArgs() throws Z3Exception
{ {
return Native.funcEntryGetNumArgs(Context().nCtx(), NativeObject()); return Native.funcEntryGetNumArgs(Context().nCtx(), NativeObject());
} }
@ -93,7 +93,7 @@ public class FuncInterp extends Z3Object
/** /**
* The number of entries in the function interpretation. * The number of entries in the function interpretation.
**/ **/
public int NumEntries() public int NumEntries() throws Z3Exception
{ {
return Native.funcInterpGetNumEntries(Context().nCtx(), NativeObject()); return Native.funcInterpGetNumEntries(Context().nCtx(), NativeObject());
} }
@ -127,7 +127,7 @@ public class FuncInterp extends Z3Object
/** /**
* The arity of the function interpretation * The arity of the function interpretation
**/ **/
public int Arity() public int Arity() throws Z3Exception
{ {
return Native.funcInterpGetArity(Context().nCtx(), NativeObject()); return Native.funcInterpGetArity(Context().nCtx(), NativeObject());
} }

28
src/api/java/FuncInterpDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
class FuncInterpDecRefQueue extends IDecRefQueue class FuncInterpDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.funcInterpIncRef(ctx.nCtx(), obj); try
} {
Native.funcInterpIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.funcInterpDecRef(ctx.nCtx(), obj); try
} {
Native.funcInterpDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

28
src/api/java/FuncInterpEntryDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
class FuncInterpEntryDecRefQueue extends IDecRefQueue class FuncInterpEntryDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.funcEntryIncRef(ctx.nCtx(), obj); try
} {
Native.funcEntryIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.funcEntryDecRef(ctx.nCtx(), obj); try
} {
Native.funcEntryDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

371
src/api/java/Goal.java
View file

@ -14,207 +14,218 @@ import com.microsoft.z3.enumerations.*;
**/ **/
public class Goal extends Z3Object public class Goal extends Z3Object
{ {
/** /**
* The precision of the goal. <remarks> Goals can be transformed using over * The precision of the goal. <remarks> Goals can be transformed using over
* and under approximations. An under approximation is applied when the * and under approximations. An under approximation is applied when the
* objective is to find a model for a given goal. An over approximation is * objective is to find a model for a given goal. An over approximation is
* applied when the objective is to find a proof for a given goal. * applied when the objective is to find a proof for a given goal.
* </remarks> * </remarks>
**/ **/
public Z3_goal_prec Precision() public Z3_goal_prec Precision() throws Z3Exception
{ {
return Z3_goal_prec.fromInt(Native.goalPrecision(Context().nCtx(), return Z3_goal_prec.fromInt(Native.goalPrecision(Context().nCtx(),
NativeObject())); NativeObject()));
} }
/** /**
* Indicates whether the goal is precise. * Indicates whether the goal is precise.
**/ **/
public boolean IsPrecise() public boolean IsPrecise() throws Z3Exception
{ {
return Precision() == Z3_goal_prec.Z3_GOAL_PRECISE; return Precision() == Z3_goal_prec.Z3_GOAL_PRECISE;
} }
/** /**
* Indicates whether the goal is an under-approximation. * Indicates whether the goal is an under-approximation.
**/ **/
public boolean IsUnderApproximation() public boolean IsUnderApproximation() throws Z3Exception
{ {
return Precision() == Z3_goal_prec.Z3_GOAL_UNDER; return Precision() == Z3_goal_prec.Z3_GOAL_UNDER;
} }
/** /**
* Indicates whether the goal is an over-approximation. * Indicates whether the goal is an over-approximation.
**/ **/
public boolean IsOverApproximation() public boolean IsOverApproximation() throws Z3Exception
{ {
return Precision() == Z3_goal_prec.Z3_GOAL_OVER; return Precision() == Z3_goal_prec.Z3_GOAL_OVER;
} }
/** /**
* Indicates whether the goal is garbage (i.e., the product of over- and * Indicates whether the goal is garbage (i.e., the product of over- and
* under-approximations). * under-approximations).
**/ **/
public boolean IsGarbage() public boolean IsGarbage() throws Z3Exception
{ {
return Precision() == Z3_goal_prec.Z3_GOAL_UNDER_OVER; return Precision() == Z3_goal_prec.Z3_GOAL_UNDER_OVER;
} }
/** /**
* Adds the <paramref name="constraints"/> to the given goal. * Adds the <paramref name="constraints"/> to the given goal.
* @throws Z3Exception *
**/ * @throws Z3Exception
public void Assert(BoolExpr[] constraints) throws Z3Exception **/
{ public void Assert(BoolExpr[] constraints) throws Z3Exception
Context().CheckContextMatch(constraints); {
for (BoolExpr c : constraints) Context().CheckContextMatch(constraints);
{ for (BoolExpr c : constraints)
Native.goalAssert(Context().nCtx(), NativeObject(), {
c.NativeObject()); Native.goalAssert(Context().nCtx(), NativeObject(),
} c.NativeObject());
} }
}
/** /**
* Adds a <paramref name="constraint"/> to the given goal. * Adds a <paramref name="constraint"/> to the given goal.
* @throws Z3Exception *
**/ * @throws Z3Exception
public void Assert(BoolExpr constraint) throws Z3Exception **/
{ public void Assert(BoolExpr constraint) throws Z3Exception
Context().CheckContextMatch(constraint); {
Native.goalAssert(Context().nCtx(), NativeObject(), Context().CheckContextMatch(constraint);
constraint.NativeObject()); Native.goalAssert(Context().nCtx(), NativeObject(),
} constraint.NativeObject());
}
/** /**
* Indicates whether the goal contains `false'. * Indicates whether the goal contains `false'.
**/ **/
public boolean Inconsistent() public boolean Inconsistent() throws Z3Exception
{ {
return Native.goalInconsistent(Context().nCtx(), NativeObject()); return Native.goalInconsistent(Context().nCtx(), NativeObject());
} }
/** /**
* The depth of the goal. <remarks> This tracks how many transformations * The depth of the goal. <remarks> This tracks how many transformations
* were applied to it. </remarks> * were applied to it. </remarks>
**/ **/
public int Depth() public int Depth() throws Z3Exception
{ {
return Native.goalDepth(Context().nCtx(), NativeObject()); return Native.goalDepth(Context().nCtx(), NativeObject());
} }
/** /**
* Erases all formulas from the given goal. * Erases all formulas from the given goal.
**/ **/
public void Reset() public void Reset() throws Z3Exception
{ {
Native.goalReset(Context().nCtx(), NativeObject()); Native.goalReset(Context().nCtx(), NativeObject());
} }
/** /**
* The number of formulas in the goal. * The number of formulas in the goal.
**/ **/
public int Size() public int Size() throws Z3Exception
{ {
return Native.goalSize(Context().nCtx(), NativeObject()); return Native.goalSize(Context().nCtx(), NativeObject());
} }
/** /**
* The formulas in the goal. * The formulas in the goal.
* @throws Z3Exception *
**/ * @throws Z3Exception
public BoolExpr[] Formulas() throws Z3Exception **/
{ public BoolExpr[] Formulas() throws Z3Exception
int n = Size(); {
BoolExpr[] res = new BoolExpr[n]; int n = Size();
for (int i = 0; i < n; i++) BoolExpr[] res = new BoolExpr[n];
res[i] = new BoolExpr(Context(), Native.goalFormula(Context() for (int i = 0; i < n; i++)
.nCtx(), NativeObject(), i)); res[i] = new BoolExpr(Context(), Native.goalFormula(Context()
return res; .nCtx(), NativeObject(), i));
} return res;
}
/** /**
* The number of formulas, subformulas and terms in the goal. * The number of formulas, subformulas and terms in the goal.
**/ **/
public int NumExprs() public int NumExprs() throws Z3Exception
{ {
return Native.goalNumExprs(Context().nCtx(), NativeObject()); return Native.goalNumExprs(Context().nCtx(), NativeObject());
} }
/** /**
* Indicates whether the goal is empty, and it is precise or the product of * Indicates whether the goal is empty, and it is precise or the product of
* an under approximation. * an under approximation.
**/ **/
public boolean IsDecidedSat() public boolean IsDecidedSat() throws Z3Exception
{ {
return Native.goalIsDecidedSat(Context().nCtx(), NativeObject()); return Native.goalIsDecidedSat(Context().nCtx(), NativeObject());
} }
/** /**
* Indicates whether the goal contains `false', and it is precise or the * Indicates whether the goal contains `false', and it is precise or the
* product of an over approximation. * product of an over approximation.
**/ **/
public boolean IsDecidedUnsat() public boolean IsDecidedUnsat() throws Z3Exception
{ {
return Native.goalIsDecidedUnsat(Context().nCtx(), NativeObject()); return Native.goalIsDecidedUnsat(Context().nCtx(), NativeObject());
} }
/** /**
* Translates (copies) the Goal to the target Context <paramref * Translates (copies) the Goal to the target Context <paramref
* name="ctx"/>. * name="ctx"/>.
* @throws Z3Exception *
**/ * @throws Z3Exception
public Goal Translate(Context ctx) throws Z3Exception **/
{ public Goal Translate(Context ctx) throws Z3Exception
return new Goal(ctx, Native.goalTranslate(Context().nCtx(), {
NativeObject(), ctx.nCtx())); return new Goal(ctx, Native.goalTranslate(Context().nCtx(),
} NativeObject(), ctx.nCtx()));
}
/** /**
* Simplifies the goal. <remarks>Essentially invokes the `simplify' tactic * Simplifies the goal. <remarks>Essentially invokes the `simplify' tactic
* on the goal.</remarks> * on the goal.</remarks>
**/ **/
public Goal Simplify(Params p) throws Z3Exception public Goal Simplify(Params p) throws Z3Exception
{ {
Tactic t = Context().MkTactic("simplify"); Tactic t = Context().MkTactic("simplify");
ApplyResult res = t.Apply(this, p); ApplyResult res = t.Apply(this, p);
if (res.NumSubgoals() == 0) if (res.NumSubgoals() == 0)
throw new Z3Exception("No subgoals"); throw new Z3Exception("No subgoals");
else else
return res.Subgoals()[0]; return res.Subgoals()[0];
} }
/** /**
* Goal to string conversion. * Goal to string conversion.
* *
* @return A string representation of the Goal. * @return A string representation of the Goal.
**/ **/
public String toString() public String toString()
{ {
return Native.goalToString(Context().nCtx(), NativeObject()); try
} {
return Native.goalToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
}
Goal(Context ctx, long obj) throws Z3Exception Goal(Context ctx, long obj) throws Z3Exception
{ {
super(ctx, obj); super(ctx, obj);
} }
Goal(Context ctx, boolean models, boolean unsatCores, boolean proofs) throws Z3Exception Goal(Context ctx, boolean models, boolean unsatCores, boolean proofs)
{ throws Z3Exception
super(ctx, Native.mkGoal(ctx.nCtx(), (models) ? true : false, {
(unsatCores) ? true : false, (proofs) ? true : false)); super(ctx, Native.mkGoal(ctx.nCtx(), (models) ? true : false,
} (unsatCores) ? true : false, (proofs) ? true : false));
}
void IncRef(long o) throws Z3Exception void IncRef(long o) throws Z3Exception
{ {
Context().Goal_DRQ().IncAndClear(Context(), o); Context().Goal_DRQ().IncAndClear(Context(), o);
super.IncRef(o); super.IncRef(o);
} }
void DecRef(long o) throws Z3Exception void DecRef(long o) throws Z3Exception
{ {
Context().Goal_DRQ().Add(o); Context().Goal_DRQ().Add(o);
super.DecRef(o); super.DecRef(o);
} }
} }

28
src/api/java/GoalDecRefQueue.java
View file

@ -7,13 +7,25 @@ package com.microsoft.z3;
class GoalDecRefQueue extends IDecRefQueue class GoalDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.goalIncRef(ctx.nCtx(), obj); try
} {
Native.goalIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.goalDecRef(ctx.nCtx(), obj); try
} {
Native.goalDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
}
}; };

82
src/api/java/IntNum.java
View file

@ -14,46 +14,52 @@ import java.math.BigInteger;
public class IntNum extends IntExpr public class IntNum extends IntExpr
{ {
IntNum(Context ctx, long obj) throws Z3Exception IntNum(Context ctx, long obj) throws Z3Exception
{ {
super(ctx, obj); super(ctx, obj);
} }
/** /**
* Retrieve the int value. * Retrieve the int value.
**/ **/
public int Int() throws Z3Exception public int Int() throws Z3Exception
{ {
Native.IntPtr res = new Native.IntPtr(); Native.IntPtr res = new Native.IntPtr();
if (Native.getNumeralInt(Context().nCtx(), NativeObject(), res) ^ true) if (Native.getNumeralInt(Context().nCtx(), NativeObject(), res) ^ true)
throw new Z3Exception("Numeral is not an int"); throw new Z3Exception("Numeral is not an int");
return res.value; return res.value;
} }
/** /**
* Retrieve the 64-bit int value. * Retrieve the 64-bit int value.
**/ **/
public long Int64() throws Z3Exception public long Int64() throws Z3Exception
{ {
Native.LongPtr res = new Native.LongPtr(); Native.LongPtr res = new Native.LongPtr();
if (Native.getNumeralInt64(Context().nCtx(), NativeObject(), res) ^ true) if (Native.getNumeralInt64(Context().nCtx(), NativeObject(), res) ^ true)
throw new Z3Exception("Numeral is not an int64"); throw new Z3Exception("Numeral is not an int64");
return res.value; return res.value;
} }
/** /**
* Retrieve the BigInteger value. * Retrieve the BigInteger value.
**/ **/
public BigInteger BigInteger() throws Z3Exception public BigInteger BigInteger() throws Z3Exception
{ {
return new BigInteger(this.toString()); return new BigInteger(this.toString());
} }
/** /**
* Returns a string representation of the numeral. * Returns a string representation of the numeral.
**/ **/
public String toString() public String toString()
{ {
return Native.getNumeralString(Context().nCtx(), NativeObject()); try
} {
return Native.getNumeralString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
}
} }

39
src/api/java/Model.java
View file

@ -19,7 +19,7 @@ public class Model extends Z3Object
* *
* @return An expression if the constant has an interpretation in the model, * @return An expression if the constant has an interpretation in the model,
* null otherwise. * null otherwise.
* @throws Z3Exception * @throws Z3Exception
**/ **/
public Expr ConstInterp(Expr a) throws Z3Exception public Expr ConstInterp(Expr a) throws Z3Exception
{ {
@ -33,7 +33,7 @@ public class Model extends Z3Object
* *
* @return An expression if the function has an interpretation in the model, * @return An expression if the function has an interpretation in the model,
* null otherwise. * null otherwise.
* @throws Z3Exception * @throws Z3Exception
**/ **/
public Expr ConstInterp(FuncDecl f) throws Z3Exception public Expr ConstInterp(FuncDecl f) throws Z3Exception
{ {
@ -60,7 +60,7 @@ public class Model extends Z3Object
* *
* @return A FunctionInterpretation if the function has an interpretation in * @return A FunctionInterpretation if the function has an interpretation in
* the model, null otherwise. * the model, null otherwise.
* @throws Z3Exception * @throws Z3Exception
**/ **/
public FuncInterp FuncInterp(FuncDecl f) throws Z3Exception public FuncInterp FuncInterp(FuncDecl f) throws Z3Exception
{ {
@ -105,14 +105,15 @@ public class Model extends Z3Object
/** /**
* The number of constants that have an interpretation in the model. * The number of constants that have an interpretation in the model.
**/ **/
public int NumConsts() public int NumConsts() throws Z3Exception
{ {
return Native.modelGetNumConsts(Context().nCtx(), NativeObject()); return Native.modelGetNumConsts(Context().nCtx(), NativeObject());
} }
/** /**
* The function declarations of the constants in the model. * The function declarations of the constants in the model.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public FuncDecl[] ConstDecls() throws Z3Exception public FuncDecl[] ConstDecls() throws Z3Exception
{ {
@ -127,14 +128,15 @@ public class Model extends Z3Object
/** /**
* The number of function interpretations in the model. * The number of function interpretations in the model.
**/ **/
public int NumFuncs() public int NumFuncs() throws Z3Exception
{ {
return Native.modelGetNumFuncs(Context().nCtx(), NativeObject()); return Native.modelGetNumFuncs(Context().nCtx(), NativeObject());
} }
/** /**
* The function declarations of the function interpretations in the model. * The function declarations of the function interpretations in the model.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public FuncDecl[] FuncDecls() throws Z3Exception public FuncDecl[] FuncDecls() throws Z3Exception
{ {
@ -148,7 +150,8 @@ public class Model extends Z3Object
/** /**
* All symbols that have an interpretation in the model. * All symbols that have an interpretation in the model.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public FuncDecl[] Decls() throws Z3Exception public FuncDecl[] Decls() throws Z3Exception
{ {
@ -192,7 +195,7 @@ public class Model extends Z3Object
* that does not have an interpretation in the model. </param> * that does not have an interpretation in the model. </param>
* *
* @return The evaluation of <paramref name="t"/> in the model. * @return The evaluation of <paramref name="t"/> in the model.
* @throws Z3Exception * @throws Z3Exception
**/ **/
public Expr Eval(Expr t, boolean completion) throws Z3Exception public Expr Eval(Expr t, boolean completion) throws Z3Exception
{ {
@ -206,7 +209,8 @@ public class Model extends Z3Object
/** /**
* Alias for <code>Eval</code>. * Alias for <code>Eval</code>.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Expr Evaluate(Expr t, boolean completion) throws Z3Exception public Expr Evaluate(Expr t, boolean completion) throws Z3Exception
{ {
@ -217,7 +221,7 @@ public class Model extends Z3Object
* The number of uninterpreted sorts that the model has an interpretation * The number of uninterpreted sorts that the model has an interpretation
* for. * for.
**/ **/
public int NumSorts() public int NumSorts() throws Z3Exception
{ {
return Native.modelGetNumSorts(Context().nCtx(), NativeObject()); return Native.modelGetNumSorts(Context().nCtx(), NativeObject());
} }
@ -228,7 +232,8 @@ public class Model extends Z3Object
* in a formula. The interpretation for a sort is a finite set of distinct * in a formula. The interpretation for a sort is a finite set of distinct
* values. We say this finite set is the "universe" of the sort. </remarks> * values. We say this finite set is the "universe" of the sort. </remarks>
* <seealso cref="NumSorts"/> <seealso cref="SortUniverse"/> * <seealso cref="NumSorts"/> <seealso cref="SortUniverse"/>
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Sort[] Sorts() throws Z3Exception public Sort[] Sorts() throws Z3Exception
{ {
@ -248,7 +253,7 @@ public class Model extends Z3Object
* *
* @return An array of expressions, where each is an element of the universe * @return An array of expressions, where each is an element of the universe
* of <paramref name="s"/> * of <paramref name="s"/>
* @throws Z3Exception * @throws Z3Exception
**/ **/
public Expr[] SortUniverse(Sort s) throws Z3Exception public Expr[] SortUniverse(Sort s) throws Z3Exception
{ {
@ -269,7 +274,13 @@ public class Model extends Z3Object
**/ **/
public String toString() public String toString()
{ {
return Native.modelToString(Context().nCtx(), NativeObject()); try
{
return Native.modelToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
Model(Context ctx, long obj) throws Z3Exception Model(Context ctx, long obj) throws Z3Exception

16
src/api/java/ModelDecRefQueue.java
View file

@ -9,11 +9,23 @@ class ModelDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.modelIncRef(ctx.nCtx(), obj); try
{
Native.modelIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.modelDecRef(ctx.nCtx(), obj); try
{
Native.modelDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
}; };

14
src/api/java/ParamDescrs.java
View file

@ -16,7 +16,7 @@ public class ParamDescrs extends Z3Object
/** /**
* validate a set of parameters. * validate a set of parameters.
**/ **/
public void Validate(Params p) public void Validate(Params p) throws Z3Exception
{ {
Native.paramsValidate(Context().nCtx(), p.NativeObject(), Native.paramsValidate(Context().nCtx(), p.NativeObject(),
@ -26,7 +26,7 @@ public class ParamDescrs extends Z3Object
/** /**
* Retrieve kind of parameter. * Retrieve kind of parameter.
**/ **/
public Z3_param_kind GetKind(Symbol name) public Z3_param_kind GetKind(Symbol name) throws Z3Exception
{ {
return Z3_param_kind.fromInt(Native.paramDescrsGetKind( return Z3_param_kind.fromInt(Native.paramDescrsGetKind(
@ -53,7 +53,7 @@ public class ParamDescrs extends Z3Object
/** /**
* The size of the ParamDescrs. * The size of the ParamDescrs.
**/ **/
public int Size() public int Size() throws Z3Exception
{ {
return Native.paramDescrsSize(Context().nCtx(), NativeObject()); return Native.paramDescrsSize(Context().nCtx(), NativeObject());
} }
@ -63,7 +63,13 @@ public class ParamDescrs extends Z3Object
**/ **/
public String toString() public String toString()
{ {
return Native.paramDescrsToString(Context().nCtx(), NativeObject()); try
{
return Native.paramDescrsToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
ParamDescrs(Context ctx, long obj) throws Z3Exception ParamDescrs(Context ctx, long obj) throws Z3Exception

16
src/api/java/ParamDescrsDecRefQueue.java
View file

@ -9,11 +9,23 @@ class ParamDescrsDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.paramDescrsIncRef(ctx.nCtx(), obj); try
{
Native.paramDescrsIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.paramDescrsDecRef(ctx.nCtx(), obj); try
{
Native.paramDescrsDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
}; };

8
src/api/java/Params.java
View file

@ -80,7 +80,13 @@ public class Params extends Z3Object
**/ **/
public String toString() public String toString()
{ {
return Native.paramsToString(Context().nCtx(), NativeObject()); try
{
return Native.paramsToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
Params(Context ctx) throws Z3Exception Params(Context ctx) throws Z3Exception

16
src/api/java/ParamsDecRefQueue.java
View file

@ -9,11 +9,23 @@ class ParamsDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.paramsIncRef(ctx.nCtx(), obj); try
{
Native.paramsIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.paramsDecRef(ctx.nCtx(), obj); try
{
Native.paramsDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
}; };

10
src/api/java/Pattern.java
View file

@ -15,7 +15,7 @@ public class Pattern extends AST
/** /**
* The number of terms in the pattern. * The number of terms in the pattern.
**/ **/
public int NumTerms() public int NumTerms() throws Z3Exception
{ {
return Native.getPatternNumTerms(Context().nCtx(), NativeObject()); return Native.getPatternNumTerms(Context().nCtx(), NativeObject());
} }
@ -41,7 +41,13 @@ public class Pattern extends AST
**/ **/
public String toString() public String toString()
{ {
return Native.patternToString(Context().nCtx(), NativeObject()); try
{
return Native.patternToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
Pattern(Context ctx, long obj) throws Z3Exception Pattern(Context ctx, long obj) throws Z3Exception

16
src/api/java/ProbeDecRefQueue.java
View file

@ -9,11 +9,23 @@ class ProbeDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.probeIncRef(ctx.nCtx(), obj); try
{
Native.probeIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.probeDecRef(ctx.nCtx(), obj); try
{
Native.probeDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
}; };

12
src/api/java/Quantifier.java
View file

@ -16,7 +16,7 @@ public class Quantifier extends BoolExpr
/** /**
* Indicates whether the quantifier is universal. * Indicates whether the quantifier is universal.
**/ **/
public boolean IsUniversal() public boolean IsUniversal() throws Z3Exception
{ {
return Native.isQuantifierForall(Context().nCtx(), NativeObject()); return Native.isQuantifierForall(Context().nCtx(), NativeObject());
} }
@ -24,7 +24,7 @@ public class Quantifier extends BoolExpr
/** /**
* Indicates whether the quantifier is existential. * Indicates whether the quantifier is existential.
**/ **/
public boolean IsExistential() public boolean IsExistential() throws Z3Exception
{ {
return !IsUniversal(); return !IsUniversal();
} }
@ -32,7 +32,7 @@ public class Quantifier extends BoolExpr
/** /**
* The weight of the quantifier. * The weight of the quantifier.
**/ **/
public int Weight() public int Weight() throws Z3Exception
{ {
return Native.getQuantifierWeight(Context().nCtx(), NativeObject()); return Native.getQuantifierWeight(Context().nCtx(), NativeObject());
} }
@ -40,7 +40,7 @@ public class Quantifier extends BoolExpr
/** /**
* The number of patterns. * The number of patterns.
**/ **/
public int NumPatterns() public int NumPatterns() throws Z3Exception
{ {
return Native return Native
.getQuantifierNumPatterns(Context().nCtx(), NativeObject()); .getQuantifierNumPatterns(Context().nCtx(), NativeObject());
@ -64,7 +64,7 @@ public class Quantifier extends BoolExpr
/** /**
* The number of no-patterns. * The number of no-patterns.
**/ **/
public int NumNoPatterns() public int NumNoPatterns() throws Z3Exception
{ {
return Native.getQuantifierNumNoPatterns(Context().nCtx(), return Native.getQuantifierNumNoPatterns(Context().nCtx(),
NativeObject()); NativeObject());
@ -88,7 +88,7 @@ public class Quantifier extends BoolExpr
/** /**
* The number of bound variables. * The number of bound variables.
**/ **/
public int NumBound() public int NumBound() throws Z3Exception
{ {
return Native.getQuantifierNumBound(Context().nCtx(), NativeObject()); return Native.getQuantifierNumBound(Context().nCtx(), NativeObject());
} }

9
src/api/java/RatNum.java
View file

@ -7,6 +7,7 @@
package com.microsoft.z3; package com.microsoft.z3;
import java.math.BigInteger; import java.math.BigInteger;
/** /**
* Rational Numerals * Rational Numerals
**/ **/
@ -63,7 +64,13 @@ public class RatNum extends RealExpr
**/ **/
public String toString() public String toString()
{ {
return Native.getNumeralString(Context().nCtx(), NativeObject()); try
{
return Native.getNumeralString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
RatNum(Context ctx, long obj) throws Z3Exception RatNum(Context ctx, long obj) throws Z3Exception

2
src/api/java/RelationSort.java
View file

@ -14,7 +14,7 @@ public class RelationSort extends Sort
/** /**
* The arity of the relation sort. * The arity of the relation sort.
**/ **/
public int Arity() public int Arity() throws Z3Exception
{ {
return Native.getRelationArity(Context().nCtx(), NativeObject()); return Native.getRelationArity(Context().nCtx(), NativeObject());
} }

64
src/api/java/Solver.java
View file

@ -16,14 +16,15 @@ public class Solver extends Z3Object
/** /**
* A string that describes all available solver parameters. * A string that describes all available solver parameters.
**/ **/
public String Help() public String Help() throws Z3Exception
{ {
return Native.solverGetHelp(Context().nCtx(), NativeObject()); return Native.solverGetHelp(Context().nCtx(), NativeObject());
} }
/** /**
* Sets the solver parameters. * Sets the solver parameters.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public void setParameters(Params value) throws Z3Exception public void setParameters(Params value) throws Z3Exception
{ {
@ -34,7 +35,8 @@ public class Solver extends Z3Object
/** /**
* Retrieves parameter descriptions for solver. * Retrieves parameter descriptions for solver.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public ParamDescrs ParameterDescriptions() throws Z3Exception public ParamDescrs ParameterDescriptions() throws Z3Exception
{ {
@ -46,7 +48,7 @@ public class Solver extends Z3Object
* The current number of backtracking points (scopes). <seealso cref="Pop"/> * The current number of backtracking points (scopes). <seealso cref="Pop"/>
* <seealso cref="Push"/> * <seealso cref="Push"/>
**/ **/
public int NumScopes() public int NumScopes() throws Z3Exception
{ {
return Native.solverGetNumScopes(Context().nCtx(), NativeObject()); return Native.solverGetNumScopes(Context().nCtx(), NativeObject());
} }
@ -54,7 +56,7 @@ public class Solver extends Z3Object
/** /**
* Creates a backtracking point. <seealso cref="Pop"/> * Creates a backtracking point. <seealso cref="Pop"/>
**/ **/
public void Push() public void Push() throws Z3Exception
{ {
Native.solverPush(Context().nCtx(), NativeObject()); Native.solverPush(Context().nCtx(), NativeObject());
} }
@ -62,9 +64,9 @@ public class Solver extends Z3Object
/** /**
* Backtracks one backtracking point. <remarks>. * Backtracks one backtracking point. <remarks>.
**/ **/
public void Pop() public void Pop() throws Z3Exception
{ {
Pop(1); Pop(1);
} }
/** /**
@ -72,7 +74,7 @@ public class Solver extends Z3Object
* an exception is thrown if <paramref name="n"/> is not smaller than * an exception is thrown if <paramref name="n"/> is not smaller than
* <code>NumScopes</code></remarks> <seealso cref="Push"/> * <code>NumScopes</code></remarks> <seealso cref="Push"/>
**/ **/
public void Pop(int n) public void Pop(int n) throws Z3Exception
{ {
Native.solverPop(Context().nCtx(), NativeObject(), n); Native.solverPop(Context().nCtx(), NativeObject(), n);
} }
@ -81,14 +83,15 @@ public class Solver extends Z3Object
* Resets the Solver. <remarks>This removes all assertions from the * Resets the Solver. <remarks>This removes all assertions from the
* solver.</remarks> * solver.</remarks>
**/ **/
public void Reset() public void Reset() throws Z3Exception
{ {
Native.solverReset(Context().nCtx(), NativeObject()); Native.solverReset(Context().nCtx(), NativeObject());
} }
/** /**
* Assert a multiple constraints into the solver. * Assert a multiple constraints into the solver.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public void Assert(BoolExpr[] constraints) throws Z3Exception public void Assert(BoolExpr[] constraints) throws Z3Exception
{ {
@ -102,17 +105,20 @@ public class Solver extends Z3Object
/** /**
* Assert one constraint into the solver. * Assert one constraint into the solver.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public void Assert(BoolExpr constraint) throws Z3Exception public void Assert(BoolExpr constraint) throws Z3Exception
{ {
Context().CheckContextMatch(constraint); Context().CheckContextMatch(constraint);
Native.solverAssert(Context().nCtx(), NativeObject(), constraint.NativeObject()); Native.solverAssert(Context().nCtx(), NativeObject(),
constraint.NativeObject());
} }
/** /**
* The number of assertions in the solver. * The number of assertions in the solver.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public int NumAssertions() throws Z3Exception public int NumAssertions() throws Z3Exception
{ {
@ -123,7 +129,8 @@ public class Solver extends Z3Object
/** /**
* The set of asserted formulas. * The set of asserted formulas.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public BoolExpr[] Assertions() throws Z3Exception public BoolExpr[] Assertions() throws Z3Exception
{ {
@ -141,7 +148,7 @@ public class Solver extends Z3Object
* <remarks> <seealso cref="Model"/> <seealso cref="UnsatCore"/> <seealso * <remarks> <seealso cref="Model"/> <seealso cref="UnsatCore"/> <seealso
* cref="Proof"/> </remarks> * cref="Proof"/> </remarks>
**/ **/
public Status Check(Expr[] assumptions) public Status Check(Expr[] assumptions) throws Z3Exception
{ {
Z3_lbool r; Z3_lbool r;
if (assumptions == null) if (assumptions == null)
@ -167,9 +174,9 @@ public class Solver extends Z3Object
* <remarks> <seealso cref="Model"/> <seealso cref="UnsatCore"/> <seealso * <remarks> <seealso cref="Model"/> <seealso cref="UnsatCore"/> <seealso
* cref="Proof"/> </remarks> * cref="Proof"/> </remarks>
**/ **/
public Status Check() public Status Check() throws Z3Exception
{ {
return Check(null); return Check(null);
} }
/** /**
@ -177,7 +184,8 @@ public class Solver extends Z3Object
* <code>null</code> if <code>Check</code> was not invoked before, if its * <code>null</code> if <code>Check</code> was not invoked before, if its
* results was not <code>SATISFIABLE</code>, or if model production is not * results was not <code>SATISFIABLE</code>, or if model production is not
* enabled. </remarks> * enabled. </remarks>
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Model Model() throws Z3Exception public Model Model() throws Z3Exception
{ {
@ -193,7 +201,8 @@ public class Solver extends Z3Object
* <code>null</code> if <code>Check</code> was not invoked before, if its * <code>null</code> if <code>Check</code> was not invoked before, if its
* results was not <code>UNSATISFIABLE</code>, or if proof production is * results was not <code>UNSATISFIABLE</code>, or if proof production is
* disabled. </remarks> * disabled. </remarks>
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Expr Proof() throws Z3Exception public Expr Proof() throws Z3Exception
{ {
@ -209,7 +218,8 @@ public class Solver extends Z3Object
* is a subset of <code>Assertions</code> The result is empty if * is a subset of <code>Assertions</code> The result is empty if
* <code>Check</code> was not invoked before, if its results was not * <code>Check</code> was not invoked before, if its results was not
* <code>UNSATISFIABLE</code>, or if core production is disabled. </remarks> * <code>UNSATISFIABLE</code>, or if core production is disabled. </remarks>
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Expr[] UnsatCore() throws Z3Exception public Expr[] UnsatCore() throws Z3Exception
{ {
@ -227,15 +237,15 @@ public class Solver extends Z3Object
* A brief justification of why the last call to <code>Check</code> returned * A brief justification of why the last call to <code>Check</code> returned
* <code>UNKNOWN</code>. * <code>UNKNOWN</code>.
**/ **/
public String ReasonUnknown() public String ReasonUnknown() throws Z3Exception
{ {
return Native.solverGetReasonUnknown(Context().nCtx(), NativeObject()); return Native.solverGetReasonUnknown(Context().nCtx(), NativeObject());
} }
/** /**
* Solver statistics. * Solver statistics.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Statistics Statistics() throws Z3Exception public Statistics Statistics() throws Z3Exception
{ {
@ -248,7 +258,13 @@ public class Solver extends Z3Object
**/ **/
public String toString() public String toString()
{ {
return Native.solverToString(Context().nCtx(), NativeObject()); try
{
return Native.solverToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
Solver(Context ctx, long obj) throws Z3Exception Solver(Context ctx, long obj) throws Z3Exception

16
src/api/java/SolverDecRefQueue.java
View file

@ -9,11 +9,23 @@ class SolverDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.solverIncRef(ctx.nCtx(), obj); try
{
Native.solverIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.solverDecRef(ctx.nCtx(), obj); try
{
Native.solverDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
}; };

10
src/api/java/Sort.java
View file

@ -37,7 +37,7 @@ public class Sort extends AST
* *
* @return * @return
**/ **/
public boolean Equals(Object o) public boolean equals(Object o)
{ {
Sort casted = (Sort) o; Sort casted = (Sort) o;
if (casted == null) if (casted == null)
@ -86,7 +86,13 @@ public class Sort extends AST
**/ **/
public String toString() public String toString()
{ {
return Native.sortToString(Context().nCtx(), NativeObject()); try
{
return Native.sortToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
/** /**

21
src/api/java/Statistics.java
View file

@ -56,7 +56,8 @@ public class Statistics extends Z3Object
/** /**
* The string representation of the the entry's value. * The string representation of the the entry's value.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public String Value() throws Z3Exception public String Value() throws Z3Exception
{ {
@ -107,20 +108,27 @@ public class Statistics extends Z3Object
**/ **/
public String toString() public String toString()
{ {
return Native.statsToString(Context().nCtx(), NativeObject()); try
{
return Native.statsToString(Context().nCtx(), NativeObject());
} catch (Z3Exception e)
{
return "Z3Exception: " + e.getMessage();
}
} }
/** /**
* The number of statistical data. * The number of statistical data.
**/ **/
public int Size() public int Size() throws Z3Exception
{ {
return Native.statsSize(Context().nCtx(), NativeObject()); return Native.statsSize(Context().nCtx(), NativeObject());
} }
/** /**
* The data entries. * The data entries.
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Entry[] Entries() throws Z3Exception public Entry[] Entries() throws Z3Exception
{ {
@ -147,7 +155,7 @@ public class Statistics extends Z3Object
/** /**
* The statistical counters. * The statistical counters.
**/ **/
public String[] Keys() public String[] Keys() throws Z3Exception
{ {
int n = Size(); int n = Size();
String[] res = new String[n]; String[] res = new String[n];
@ -159,7 +167,8 @@ public class Statistics extends Z3Object
/** /**
* The value of a particular statistical counter. <remarks>Returns null if * The value of a particular statistical counter. <remarks>Returns null if
* the key is unknown.</remarks> * the key is unknown.</remarks>
* @throws Z3Exception *
* @throws Z3Exception
**/ **/
public Entry get(String key) throws Z3Exception public Entry get(String key) throws Z3Exception
{ {

18
src/api/java/StatisticsDecRefQueue.java
View file

@ -9,11 +9,23 @@ class StatisticsDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.statsIncRef(ctx.nCtx(), obj); try
{
Native.statsIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.statsDecRef(ctx.nCtx(), obj); try
{
Native.statsDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
}; };

6
src/api/java/Symbol.java
View file

@ -16,7 +16,7 @@ public class Symbol extends Z3Object
/** /**
* The kind of the symbol (int or string) * The kind of the symbol (int or string)
**/ **/
protected Z3_symbol_kind Kind() protected Z3_symbol_kind Kind() throws Z3Exception
{ {
return Z3_symbol_kind.fromInt(Native.getSymbolKind(Context().nCtx(), return Z3_symbol_kind.fromInt(Native.getSymbolKind(Context().nCtx(),
NativeObject())); NativeObject()));
@ -25,7 +25,7 @@ public class Symbol extends Z3Object
/** /**
* Indicates whether the symbol is of Int kind * Indicates whether the symbol is of Int kind
**/ **/
public boolean IsIntSymbol() public boolean IsIntSymbol() throws Z3Exception
{ {
return Kind() == Z3_symbol_kind.Z3_INT_SYMBOL; return Kind() == Z3_symbol_kind.Z3_INT_SYMBOL;
} }
@ -33,7 +33,7 @@ public class Symbol extends Z3Object
/** /**
* Indicates whether the symbol is of string kind. * Indicates whether the symbol is of string kind.
**/ **/
public boolean IsStringSymbol() public boolean IsStringSymbol() throws Z3Exception
{ {
return Kind() == Z3_symbol_kind.Z3_STRING_SYMBOL; return Kind() == Z3_symbol_kind.Z3_STRING_SYMBOL;
} }

2
src/api/java/Tactic.java
View file

@ -18,7 +18,7 @@ public class Tactic extends Z3Object
/** /**
* A string containing a description of parameters accepted by the tactic. * A string containing a description of parameters accepted by the tactic.
**/ **/
public String Help() public String Help() throws Z3Exception
{ {
return Native.tacticGetHelp(Context().nCtx(), NativeObject()); return Native.tacticGetHelp(Context().nCtx(), NativeObject());
} }

16
src/api/java/TacticDecRefQueue.java
View file

@ -9,11 +9,23 @@ class TacticDecRefQueue extends IDecRefQueue
{ {
public void IncRef(Context ctx, long obj) public void IncRef(Context ctx, long obj)
{ {
Native.tacticIncRef(ctx.nCtx(), obj); try
{
Native.tacticIncRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
public void DecRef(Context ctx, long obj) public void DecRef(Context ctx, long obj)
{ {
Native.tacticDecRef(ctx.nCtx(), obj); try
{
Native.tacticDecRef(ctx.nCtx(), obj);
} catch (Z3Exception e)
{
// OK.
}
} }
}; };

2
src/api/java/TupleSort.java
View file

@ -25,7 +25,7 @@ public class TupleSort extends Sort
/** /**
* The number of fields in the tuple. * The number of fields in the tuple.
**/ **/
public int NumFields() public int NumFields() throws Z3Exception
{ {
return Native.getTupleSortNumFields(Context().nCtx(), NativeObject()); return Native.getTupleSortNumFields(Context().nCtx(), NativeObject());
} }