Added info_string

Author: botev

examples/helloworld.rs

@@ -7,6 +7,7 @@ use af::*;
 fn main() {
     set_device(0);
     info();
+    print!("Info String:\n{}", info_string(true));
 
     let num_rows: u64 = 5;
     let num_cols: u64 = 3;

src/device/mod.rs

@@ -2,12 +2,13 @@ extern crate libc;
 
 use defines::AfError;
 use error::HANDLE_ERROR;
-use self::libc::{c_int, size_t, c_char};
+use self::libc::{c_int, size_t, c_char, c_void};
 use std::ffi::CString;
 
 extern {
     fn af_get_version(major: *mut c_int, minor: *mut c_int, patch: *mut c_int) -> c_int;
     fn af_info() -> c_int;
+    fn af_info_string(str: *mut *mut c_char, verbose: bool) -> c_int;
     fn af_init() -> c_int;
     fn af_get_device_count(nDevices: *mut c_int) -> c_int;
     fn af_get_dbl_support(available: *mut c_int, device: c_int) -> c_int;
@@ -20,6 +21,8 @@ extern {
     fn af_get_mem_step_size(step_bytes: *mut size_t) -> c_int;
     fn af_device_gc() -> c_int;
     fn af_sync(device: c_int) -> c_int;
+
+    fn af_free_host (ptr: *mut c_void) -> c_int;
 }
 
 /// Get ArrayFire Version Number
@@ -56,6 +59,31 @@ pub fn info() {
     }
 }
 
+/// Return library meta-info as `String`
+///
+/// # Examples
+///
+/// An example output of `af::info_string` call looks like below
+///
+/// ```text
+/// ArrayFire v3.0.0 (CUDA, 64-bit Mac OSX, build d8d4b38)
+/// Platform: CUDA Toolkit 7, Driver: CUDA Driver Version: 7000
+/// [0] GeForce GT 750M, 2048 MB, CUDA Compute 3.0
+/// ```
+pub fn info_string(verbose: bool) -> String {
+    let mut tmp: *mut c_char = 0 as *mut c_char;
+    unsafe {
+        let err_val = af_info_string(&mut tmp, verbose);
+        HANDLE_ERROR(AfError::from(err_val));
+
+        let result = CString::from_raw(tmp).into_string().unwrap();
+
+        let err_val = af_free_host(tmp as *mut c_void);
+        HANDLE_ERROR(AfError::from(err_val));
+        result
+    }
+}
+
 /// Initialize ArrayFire library
 ///
 /// 0th device will be the default device unless init call

src/lib.rs

@@ -40,7 +40,7 @@ pub use data::{select, selectl, selectr, replace, replace_scalar};
 pub use data::{range_t, iota_t, identity_t, constant_t};
 mod data;
 
-pub use device::{get_version, info, init, device_count, is_double_available, set_device, get_device};
+pub use device::{get_version, info, info_string, init, device_count, is_double_available, set_device, get_device};
 pub use device::{device_mem_info, print_mem_info, set_mem_step_size, get_mem_step_size, device_gc, sync};
 mod device;