Utilities.cpp File Reference

Implementation file with miscellaneous definitions used throughout the WSTP-related part of LibraryLinkUtilities. More...

Detailed Description

Implementation file with miscellaneous definitions used throughout the WSTP-related part of LibraryLinkUtilities.

Date

Nov 26, 2017

Author

Rafal Chojna rafal.nosp@m.c@wo.nosp@m.lfram.nosp@m..com

#include "LLU/WSTP/Utilities.h"
#include "LLU/ErrorLog/ErrorManager.h"

Include dependency graph for Utilities.cpp:

Namespaces
	LLU
	Main namespace of LibraryLink Utilities.
	LLU::WS
	Contains definitions related to WSTP functionality in LLU.

Functions
void	LLU::WS::Detail::checkError (WSLINK m, int statusOk, const std::string &errorName, const std::string &debugInfo="")
	Checks if WSTP operation was successful and throws appropriate exception otherwise. More...
void	LLU::WS::Detail::throwLLUException (const std::string &errorName, const std::string &debugInfo="")
	Simple wrapper over ErrorManager::throwException used to break dependency cycle between WSStream and ErrorManager. More...
WSLINK	LLU::WS::Detail::getNewLoopback (WSLINK m)
	Returns a new loopback link using WSLinkEnvironment(m) as WSENV. More...
int	LLU::WS::Detail::countExpressionsInLoopbackLink (WSLINK &lpbckLink)
	Get the number of expressions stored in the loopback link. More...

Function Documentation

checkError()

void LLU::WS::Detail::checkError	(	WSLINK	m,
		int	statusOk,
		const std::string &	errorName,
		const std::string &	debugInfo = ""
	)

Checks if WSTP operation was successful and throws appropriate exception otherwise.

Parameters

[in]	m	- low-level object of type WSLINK received from LibraryLink
[in]	statusOk	- status code return from a WSTP function
[in]	errorName	- what error name to put in the exception if WSTP function failed
[in]	debugInfo	- additional info to be attached to the exception

countExpressionsInLoopbackLink()

int LLU::WS::Detail::countExpressionsInLoopbackLink

(

WSLINK &

lpbckLink

)

Get the number of expressions stored in the loopback link.

Parameters

lpbckLink

- a reference to the loopback link, after expressions are counted this argument will be assigned a different WSLINK

Returns

a number of expression stored in the loopback link

getNewLoopback()

WSLINK LLU::WS::Detail::getNewLoopback

(

WSLINK

m

)

Returns a new loopback link using WSLinkEnvironment(m) as WSENV.

Parameters

m	- valid WSLINK

Returns

a brand new Loopback Link

throwLLUException()

void LLU::WS::Detail::throwLLUException	(	const std::string &	errorName,
		const std::string &	debugInfo = ""
	)

Simple wrapper over ErrorManager::throwException used to break dependency cycle between WSStream and ErrorManager.

Parameters

errorName	- what error name to put in the exception
debugInfo	- additional info to be attached to the exception