📄 libsde16.htm
字号:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta name="GENERATOR" content="Quadralay WebWorks Publisher Professional Edition 6.0.5">
<meta name="TEMPLATEBASE" content="book_html">
<meta name="LASTUPDATED" content="12/04/03 16:07:07">
<title>debuggetkey</title>
<STYLE TYPE="text/css">
<!--
span.Signal { text-transform: uppercase; font-family: Verdana }
-->
</STYLE>
</head>
<body link="#3366CC" vlink="#9999CC" text="#000000" alink="#0000CC" bgcolor="#FFFFFF"
background="images/backgrnd.gif">
<p><img src="images/stlogo.gif" width="106" height="83" align="left"
alt="logo here!"> </p>
<table width="331" border="0" align="right" cellpadding="0" cellspacing="0">
<tr>
<td><a href="a_refman.htm"><img src="images/navtoc.gif" width="84" height="23"
border="0" alt="TOC"> </a></td>
<td><a href="libsde15.htm"><img src="images/navprev.gif" width="80" height="23"
border="0" alt="PREV"> </a></td>
<td><a href="libsde17.htm"><img src="images/navnext.gif" width="83" height="23"
border="0" alt="NEXT"> </a></td>
<td><a href="a_refmaa.htm"><img src="images/navidx.gif" width="84" height="23"
border="0" alt="INDEX"> </a></td>
</tr>
</table>
<p><br clear="all">
</p>
<hr align="left">
<blockquote>
<h2>
<a name="1204839"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">debuggetkey</font>
</h2><hr>
<p>
<a name="1204840"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Read a character from the keyboard</font>
</p>
<h3>
<a name="1204841"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Synopsis</font>
</h3>
<a name="1204842"> </a><font size=2 face=Courier><strong>#include <debug.h><br></strong></font>
<a name="1204843"> </a><font size=2 face=Courier><strong>long int debuggetkey( long int <font size=2 face=Courier><strong><em>*buf </em></strong></font>);<br></strong></font>
<h3>
<a name="1204844"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Arguments</font>
</h3>
<p>
<a name="1209155"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><b><font size=2 face=Courier><strong>long int </strong></font><font size=2 face=Courier><strong><em>*buf</em></strong></font></b></font>
<br>
<dl><dl> <dl>
<dt> <a name="1209157"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">A pointer to a location where the input key will be stored</font>
</dl>
</dl></dl>
<h3>
<a name="1204847"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Results</font>
</h3>
<p>
<a name="1204848"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">Returns <font size=2 face=Courier><strong>1</strong></font> on success. Other values are errors.</font>
</p>
<h3>
<a name="1204849"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Errors</font>
</h3>
<p>
<a name="1204850"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif">The function will fail to execute if another debug function is already executing (for example from another concurrent thread of execution) and a mutual exclusion function pointer has not been registered with the debug library. In this case the function returns <font size=2 face=Courier><strong>DEBUG_FN_REENTERED</strong></font>. If the debugger is not connected to the target, the function will fail and return <font size=2 face=Courier><strong>DEBUG_NOT_CONNECTED</strong></font>. The value returned for any other error is <font size=2 face=Courier><strong>-1</strong></font>.</font>
</p>
<h3>
<a name="1204851"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Description</font>
</h3>
<p>
<a name="1204852"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><font size=2 face=Courier><strong>debuggetkey</strong></font> stores the ASCII value of the character typed at the keyboard in the location pointed to by <font size=2 face=Courier><strong>buf</strong></font>. The routine waits indefinitely for the next keystroke and only returns when a key is available. The effect on any buffered data in the standard input stream is host-defined.</font>
</p>
<h3>
<a name="1204853"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">Example</font>
</h3>
<a name="1204854"> </a><font size=2 face=Courier><strong>long int key;<br>long int numkeys;<br><br></strong></font>
<a name="1204857"> </a><font size=2 face=Courier><strong>numkeys = debuggetkey(&key);<br></strong></font>
<h3>
<a name="1204858"> </a><font color="#003366" face="Verdana, Arial, Helvetica, sans-serif">See also</font>
</h3>
<p>
<a name="1204859"> </a><font size=2 face="Verdana, Arial, Helvetica, sans-serif"><a href="libsde21.htm#1204959"><font color="#0000ff" face="Verdana, Arial, Helvetica, sans-serif"><i>debugpollkey</i></font></a></font>
</p>
</blockquote>
<hr>
<table width="331" border="0" align="left" cellpadding="0" cellspacing="0">
<tr>
<td><a href="a_refman.htm"><img src="images/navtoc.gif" width="84" height="23"
border="0" alt="TOC"> </a></td>
<td><a href="libsde15.htm"><img src="images/navprev.gif" width="80" height="23"
border="0" alt="PREV"> </a></td>
<td><a href="libsde17.htm"><img src="images/navnext.gif" width="83" height="23"
border="0" alt="NEXT"> </a></td>
<td><a href="a_refmaa.htm"><img src="images/navidx.gif" width="84" height="23"
border="0" alt="INDEX"> </a></td>
</tr>
</table>
<font size=1 face="Verdana, Arial, Helvetica, sans-serif"> © 2001, 2002, 2003 STMicroelectronics. All Rights Reserved.<br>
ADCS 7250966F</font>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -