MLPutRealNumberAsUTF32String (C Function)

MLPutRealNumberAsUTF32String has been replaced by WSPutRealNumberAsUTF32String.

int MLPutRealNumberAsUTF32String(MLINK l, const unsigned int *s, int n)

sends the floating-point number encoded as UTF-32 string s of length n to the MathLink connection specified by l.

Details

  • Send the number s in the form "3.14159"
  • The number s encoded in UTF-32 must begin with a byte order mark.
  • The length of the number n must include the byte order mark.
  • MLPutRealNumberAsUTF32String() returns 0 on error, and a nonzero value if the function succeeds.
  • MLPutRealNumberAsUTF32String() is declared in the MathLink header file mathlink.h.

Examples

Basic Examples  (1)

#include "mathlink.h"

/* A function to put the expression Sqrt[2.75] to a link */

void f(MLINK l)
{    
    unsigned int theNumber[5];

    theNumber[0] = 0xFEFF;
    theNumber[1] = '2';
    theNumber[2] = '.';
    theNumber[3] = '7';
    theNumber[4] = '5';

    if(! MLPutFunction(l, "Sqrt", 1))
    { /* Unable to put Sqrt[] to the link */ }

    if(! MLPutRealNumberAsUTF32String(l, theNumber, 5))
    { /* Unable to put the number to the link */}

    if(! MLEndPacket(l))
    { /* Unable to put the end-of-packet sequence to l */ }

    if(! MLFlush(l))
    { /* Unable to flush any output buffered in l */ }
}