86 lines
3.3 KiB
HTML
86 lines
3.3 KiB
HTML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
|
|
<title>PvaClientPutGetGet</title>
|
|
<link rel="stylesheet" type="text/css"
|
|
href="http://epics-pvdata.sourceforge.net/base.css" />
|
|
<link rel="stylesheet" type="text/css"
|
|
href="http://epics-pvdata.sourceforge.net/epicsv4.css" />
|
|
<style type="text/css">
|
|
/*<![CDATA[*/
|
|
.about { margin-left: 3em; margin-right: 3em; font-size: .83em}
|
|
table { margin-left: auto; margin-right: auto }
|
|
.diagram { text-align: center; margin: 2.5em 0 }
|
|
span.opt { color: grey }
|
|
span.nterm { font-style:italic }
|
|
span.term { font-family:courier }
|
|
span.user { font-family:courier }
|
|
span.user:before { content:"<" }
|
|
span.user:after { content:">" }
|
|
.nonnorm { font-style:italic }
|
|
p.ed { color: #AA0000 }
|
|
span.ed { color: #AA0000 }
|
|
p.ed.priv { display: inline; }
|
|
span.ed.priv { display: inline; }
|
|
/*]]>*/</style>
|
|
<!-- Script that generates the Table of Contents -->
|
|
<script type="text/javascript"
|
|
src="http://epics-pvdata.sourceforge.net/script/tocgen.js">
|
|
</script>
|
|
</head>
|
|
<body>
|
|
|
|
<h1>PvaClientPutGetGet</h1>
|
|
|
|
<p>
|
|
pvaClientPutGet is a synchronous wrapper for the pvAccess::ChannelPutGet API, which is a callback based API.
|
|
Thus it is easier to use than pvAccess::ChannelPut itself.
|
|
</p>
|
|
<p>
|
|
<b>NOTE:</b>
|
|
Except for union fields pvaClientPutGet takes care of modifying the bitSet associated with
|
|
the data sent to the server.
|
|
</p>
|
|
<p>An instance of PvaClientPutGet is created via a call to one of the followimg:</p>
|
|
<pre>
|
|
class PvaClientChannel
|
|
...
|
|
{
|
|
...
|
|
PvaClientPutGetPtr createPutGet(std::string const & request);
|
|
PvaClientPutGetPtr createPutGet(epics::pvData::PVStructurePtr const & pvRequest);
|
|
...
|
|
};
|
|
<p>An instance of <b>PvaClientPutGet</b> connects to a single channel.
|
|
<b>PvaClientPutGet</b> has both synchronous methods, which block, and non blocking methods.
|
|
</p>
|
|
<p><b>PvaClientPutGet</b> has methods:</p>
|
|
<pre>
|
|
connect calls issueConnect and then waitConnect.
|
|
issueConnect issues a request to the server to create the server side of ChannelPut.
|
|
waitConnect blocks until server responds that it has created the ChannelPut.
|
|
putGet call issuePutGet and then waitPutGet.
|
|
issuePutGet issue a putGet and return immediately.
|
|
waitPutGet wait until putGet completes.
|
|
getGet calls issueGetGet and then waitGetGet.
|
|
issueGetGet issues a request to the server to get the latest data for the get data.
|
|
waitGetGet waits until the server send a message that the getGet is complete.
|
|
getPut calls issueGetPut and then waitGetPut.
|
|
issueGetPut issues a request to the server to get the latest data for the put data.
|
|
waitGetPut waits until the server send a message that the getPut is complete.
|
|
getPutData get the put portion of the data.
|
|
getGetData get the get portion of the data.
|
|
</pre>
|
|
<p>
|
|
<b>issueConnect</b>, <b>issuePutGet</b>, <b>issueGetGet</b> and <b>issueGetPut</b> do not block.
|
|
All other methods can block.
|
|
</p>
|
|
|
|
|
|
</body>
|
|
</html>
|
|
|