5 files changed, 147 insertions, 0 deletions
diff --git a/SWIG/Examples/java/constants/.cvsignore b/SWIG/Examples/java/constants/.cvsignore
new file mode 100644
index 000000000..c4072f651
--- /dev/null
+++ b/SWIG/Examples/java/constants/.cvsignore
@@ -0,0 +1,3 @@
+*.java
+*.class
+example_wrap.c
diff --git a/SWIG/Examples/java/constants/Makefile b/SWIG/Examples/java/constants/Makefile
new file mode 100644
index 000000000..0a5478cd5
--- /dev/null
+++ b/SWIG/Examples/java/constants/Makefile
@@ -0,0 +1,20 @@
+TOP        = ../..
+SWIG       = $(TOP)/../swig
+SRCS       = 
+TARGET     = libexample
+INTERFACE  = example.i
+SWIGOPT    = -shadow
+
+all::	java
+
+java::
+	$(MAKE) -f $(TOP)/Makefile SRCS='$(SRCS)' SWIG='$(SWIG)' \
+	SWIGOPT='$(SWIGOPT)' TARGET='$(TARGET)' INTERFACE='$(INTERFACE)' java_cpp
+	javac *.java
+
+clean::
+	mv main.java main.java.tmp
+	rm -f *_wrap* *.o core *~ *.so *.class *.java 
+	mv main.java.tmp main.java
+
+check: all
diff --git a/SWIG/Examples/java/constants/example.i b/SWIG/Examples/java/constants/example.i
new file mode 100644
index 000000000..29a1a7f11
--- /dev/null
+++ b/SWIG/Examples/java/constants/example.i
@@ -0,0 +1,26 @@
+/* File : example.i */
+%module example
+
+/* A few preprocessor macros */
+
+#define    ICONST      42
+#define    FCONST      2.1828
+#define    CCONST      'x'
+#define    CCONST2     '\n'
+#define    SCONST      "Hello World"
+#define    SCONST2     "\"Hello World\""
+
+/* This should work just fine */
+#define    EXPR        ICONST + 3*(FCONST)
+
+/* This shouldn't do anything */
+#define    EXTERN      extern
+
+/* Neither should this (BAR isn't defined) */
+#define    FOO         (ICONST + BAR)
+
+/* The following statements also produce constants */
+const int     iconst = 37;
+const double  fconst = 3.14;
+
+
diff --git a/SWIG/Examples/java/constants/index.html b/SWIG/Examples/java/constants/index.html
new file mode 100644
index 000000000..390acc649
--- /dev/null
+++ b/SWIG/Examples/java/constants/index.html
@@ -0,0 +1,53 @@
+<html>
+<head>
+<title>SWIG:Examples:java:constants</title>
+</head>
+
+<body bgcolor="#ffffff">
+
+<tt>SWIG/Examples/java/constants/</tt>
+<hr>
+
+<H2>Wrapping C Constants</H2>
+
+<tt>$Header$</tt><br>
+
+<p>
+When SWIG encounters C preprocessor macros and C declarations that look like constants,
+it creates Java constant with an identical value.  Click <a href="example.i">here</a>
+to see a SWIG interface with some constant declarations in it.
+
+<h2>Accessing Constants from Java</h2>
+
+Click <a href="main.java">here</a> to see a Java program that prints out the values
+of the constants contained in the above file.
+
+<h2>Key points</h2>
+
+<ul>
+<li>The values of preprocessor macros are converted into Java constants.
+<li>Types are inferred by syntax (e.g., "3" is an integer and "3.5" is a float).
+<li>Character constants such as 'x' are converted into Java strings.
+<li>C string literals such as "Hello World" are converted into Java strings.
+<li>Macros that are not fully defined are simply ignored.  For example:
+<blockquote>
+<pre>
+#define EXTERN extern
+</pre>
+</blockquote>
+is ignored because SWIG has no idea what type of variable this would be.
+
+<p>
+<li>Expressions are allowed provided that all of their components are defined. Otherwise, the constant is ignored.
+
+<li>Certain C declarations involving 'const' are also turned into Java constants. 
+<li>The constants that appear in a SWIG interface file do not have to appear in any sort
+of matching C source file since the creation of a constant does not require linkage
+to a stored value (i.e., a value held in a C global variable or memory location).
+</ul>
+
+<hr>
+
+
+</body>
+</html>
diff --git a/SWIG/Examples/java/constants/main.java b/SWIG/Examples/java/constants/main.java
new file mode 100644
index 000000000..af793f4a7
--- /dev/null
+++ b/SWIG/Examples/java/constants/main.java
@@ -0,0 +1,45 @@
+import example;
+import java.lang.reflect.*;
+
+public class main {
+  static {
+    try {
+        System.loadLibrary("example");
+    } catch (UnsatisfiedLinkError e) {
+      System.err.println("Cannot load the example native code.\nMake sure your LD_LIBRARY_PATH contains \'.\'\n" + e);
+      System.exit(1);
+    }
+  }
+
+  public static void main(String argv[]) 
+  {
+    System.out.println("ICONST  = " + example.ICONST + " (should be 42)");
+    System.out.println("FCONST  = " + example.FCONST + " (should be 2.1828)");
+    System.out.println("CCONST  = " + example.CCONST + " (should be 'x')");
+    System.out.println("CCONST2 = " + example.CCONST2 + " (this should be on a new line)");
+    System.out.println("SCONST  = " + example.SCONST + " (should be 'Hello World')");
+    System.out.println("SCONST2 = " + example.SCONST2 + " (should be '\"Hello World\"')");
+    System.out.println("EXPR    = " + example.EXPR +   " (should be 48.5484)");
+    System.out.println("iconst  = " + example.iconst + " (should be 37)");
+    System.out.println("fconst  = " + example.fconst + " (should be 3.14)");
+
+// Use reflection to check if these variables are defined:
+    try
+    {
+        System.out.println("EXTERN = " + example.class.getField("EXTERN") + " (Arg! This shouldn't print anything)");
+    }
+    catch (NoSuchFieldException e)
+    {
+        System.out.println("EXTERN isn't defined (good)");
+    }
+
+    try
+    {
+        System.out.println("FOO    = " + example.class.getField("FOO") + " (Arg! This shouldn't print anything)");
+    }
+    catch (NoSuchFieldException e)
+    {
+        System.out.println("FOO isn't defined (good)");
+    }
+  }
+}