add working helloworld

.gitignore

@@ -9,4 +9,5 @@ bindgen.txt
 src/bindings.rs
 creduce_bug_*
 # !__bindgen.ii
-*.log
+*.log
+*.oct

Cargo.toml

@@ -1,20 +1,5 @@
-[package]
-name = "octh"
-version = "0.1.0"
-authors = ["Cameron Taggart <[email protected]>"]
-build = "build.rs"
-description = "A bindgen generated Rust wrapper around oct.h for creating Oct-Files for GNU Octave"
-keywords = ["Octave"]
-license = "GPL"
-homepage = "https://github.com/ctaggart/octh"
-repository = "https://github.com/ctaggart/octh"
-edition = "2018"
-
-[lib]
-# crate-type = ["dylib"]
-
-[build-dependencies]
-# bindgen = "*"
-# need https://github.com/rust-lang/rust-bindgen/commit/fa6a68d7c768cd9d4efc418f5d8d9ceb104704ad
-bindgen = { branch = "master", git = "https://github.com/rust-lang/rust-bindgen" }
-cc = "*"
+[workspace]
+members = [
+    "octh",
+    "example-helloworld",
+]

example-helloworld/Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "helloworld"
+version = "0.1.0"
+edition = "2018"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+octh = { path = "../octh" }

example-helloworld/build.rs

@@ -0,0 +1,5 @@
+fn main() {
+    println!("/home/linuxbrew/.linuxbrew/Cellar/octave/5.1.0_6/lib/octave/5.1.0");
+    println!("cargo:rustc-link-lib=octave");
+    println!("cargo:rustc-link-lib=octinterp");
+}

example-helloworld/readme.md

@@ -0,0 +1,37 @@
+The is a port of the `helloworld.cc` from [A.1.1 Getting Started with Oct-File](https://octave.org/doc/interpreter/Getting-Started-with-Oct_002dFiles.html#Getting-Started-with-Oct_002dFiles). The original ported C++ was:
+
+``` cc
+#include <octave/oct.h>
+
+DEFUN_DLD (helloworld, args, nargout,
+           "Hello World Help String")
+{
+  octave_stdout << "Hello World has "
+                << args.length () << " input arguments and "
+                << nargout << " output arguments.\n";
+
+  // Return empty matrices for any outputs
+  octave_value_list retval (nargout);
+  for (int i = 0; i < nargout; i++)
+    retval(i) = octave_value (Matrix ());
+
+  return retval;
+}
+```
+
+The `mkoctfile` function compiles it to a `helloworld.oct` file. You can then run it within Octave with:
+``` m
+helloworld (1, 2, 3)
+```
+Which prints:
+```
+Hello World has 3 input arguments and 0 output arguments.
+```
+
+You can build this example by doing:
+``` sh
+cargo build
+cp target/debug/libhelloworld.so helloworld.oct
+```
+
+Start Octave with `octave`. Then run `helloworld (1, 2, 3)` within Octave.

example-helloworld/src/lib.rs

@@ -0,0 +1,14 @@
+use octh::*;
+
+#[no_mangle]
+pub extern "C" fn Ghelloworld (library: *const dynamic_library, relative: bool) -> *mut dld_function {
+    let name = StdString::from_bytes_with_nul(b"helloworld\0");
+    let help = StdString::from_bytes_with_nul(b"Hello World Help String\0");
+    dld_function_create(helloworld, library, name, help, relative)
+}
+
+extern "C" fn helloworld (args: *const value_list, nargout: i32) -> value_list {
+    let nargin = value_list_length(args);
+    println!("Hello World has {} input arguments and {} output arguments.", nargin, nargout);
+    value_list_new(0)
+}

octh/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "octh"
+version = "0.1.0"
+authors = ["Cameron Taggart <[email protected]>"]
+build = "build.rs"
+description = "A bindgen generated Rust wrapper around oct.h for creating Oct-Files for GNU Octave"
+keywords = ["Octave"]
+license = "GPL"
+homepage = "https://github.com/ctaggart/octh"
+repository = "https://github.com/ctaggart/octh"
+edition = "2018"
+
+[lib]
+# crate-type = ["dylib"]
+
+[build-dependencies]
+# bindgen = "*"
+# need https://github.com/rust-lang/rust-bindgen/commit/fa6a68d7c768cd9d4efc418f5d8d9ceb104704ad
+bindgen = { branch = "master", git = "https://github.com/rust-lang/rust-bindgen" }
+cc = "*"

build.rs → octh/build.rs

@@ -22,6 +22,7 @@ fn bindgen(target: &str) {
         .enable_cxx_namespaces()
         .whitelist_type("octave.*")
         .whitelist_function("octave.*")
+        .whitelist_function("stdstring.*")
         .opaque_type("octave.refcount")
         .use_core()
         // .raw_line("#![allow(warnings)]")