topic Prime 3.0 Custom Functions (string arguments) in Mathcad

Prime 3.0 Custom Functions (string arguments)

spolak — Thu, 03 May 2018 16:43:22 GMT

I have a user function for Mathcad 15 that works great (in Mathcad 15). I'm attempting to build that .dll for Mathcad Prime 3.0. After compiling the code (linking the mcaduser.lib that is distributed with Mathcad Prime 3.0), all the custom functions defined in my .dll work fine

Re: Prime 3.0 Custom Functions (string arguments)

spolak — Fri, 22 Nov 2013 16:36:18 GMT

By the way, the custom/user function I'm trying to build is a wrapper for CoolProp, which is an open-source library of thermophysical fluid properties, including humid air (water/steam). The user function I compiled for Mathcad 15 wraps the CoolProp library quite well. I've only implemented a few of the top level functions, but enough to sufficiently extract all properties for all the fluids in the CoolProp library. CoolProp is open-source, and so is the Mathcad wrapper for it. Here's a link to the Mathcad wrapper:

http://sourceforge.net/projects/coolprop/files/CoolProp/4.0.0beta/MathCAD/

Now I just need to figure out these "nuances" of Prime 3.0 that are preventing me from building the CoolProp wrapper...

Scott

Re: Prime 3.0 Custom Functions (string arguments)

RogerYeh — Sat, 23 Nov 2013 02:27:42 GMT

R&D has been informed of this issue. Thank you for bringing it to our attention!

Re: Prime 3.0 Custom Functions (string arguments)

LucMeekes — Sun, 24 Nov 2013 12:30:23 GMT

Hi Scott,

I hope the failure is not due to missing a call to MathcadAllocate, to obtain storage for the string...

{Don't know if allocation for storage of strings and arrays is required in Prime as it is in Mathcad.}

Success!
Luc

Re: Prime 3.0 Custom Functions (string arguments)

jsheehan — Mon, 25 Nov 2013 01:32:43 GMT

Luc

You are correct, nice catch . Our QA/Engineering team suggests replacing the call to "new"

char

* c = MathcadAllocate(s.size()+1);

// creat a c-string (pointer) c with the same size as s

In your

GetCoolPropsParamMathcad

Function

This will protect your code across DLL boundaries.

John

Re: Prime 3.0 Custom Functions (string arguments)

spolak — Tue, 26 Nov 2013 15:45:41 GMT

Luc, thanks for the tip - you were absolutely correct. I've only ever used the MathcadAllocate functions for array objects, not for strings. It makes perfect sense though. Thanks again!

Scott

Re: Prime 3.0 Custom Functions (string arguments)

agodemar — Fri, 06 Dec 2013 12:07:22 GMT

Hi guys,

just to develop a little more this subject, this is what works for me:

// -----------------------------------------------

// File: test_string_return.cpp

// test for a function that returns a string

#include "stdafx.h"

#include "mcadincl.h"

#include <string>

using namespace std;

LRESULT test_string_return_Function( LPMCSTRING ParamValue, LPCMCSTRING ParamName );

LRESULT test_string_return_Function( LPMCSTRING ParamValue, LPCMCSTRING ParamName )

{

// see: http://stackoverflow.com/questions/347949/convert-stdstring-to-const-char-or-char

string str_val = "foox";

char *cstr_val = MathcadAllocate(str_val.size() + 1);

std::copy(str_val.begin(), str_val.end(), cstr_val);

cstr_val[str_val.size()] = '\0';

ParamValue->str = cstr_val;

// normal return

return 0;

}

// fill out a FUNCTIONINFO structure with

// the information needed for registering the

// function with Mathcad

FUNCTIONINFO test_string_return =

{

// Name by which mathcad will recognize the function

"test_string_return",

// description of "test_string_return_Function" parameters to be used

// by the Insert Function dialog box

"string-value",

// description of the function for the Insert Function dialog box

"test: pass a string and receive a string as output",

// pointer to the executible code

(LPCFUNCTION)test_string_return_Function,

// type of returned object

STRING,

// number of input parameters (not including the returned object)

// test_string_return_Function( value )

// types of input parameters

{STRING}

};

// -----------------------------------------------

This is needed, for example, when one wants to read the attribute of a dataset in an HDF file. In that case the string, which is the attribute value, has to be returned to Mathcad.

Agostino