📄 mvgetnstr.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>getnstr</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_002_001_433"> </a>NAME</h4><blockquote>getnstr, getstr, mvgetnstr, mvgetstr, mvwgetnstr, mvwgetstr, wgetstr, wgetnstr- get a multi-byte character string from the terminal</blockquote><h4><a name = "tag_002_001_434"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="curses.h.html">curses.h</a>>int getnstr(char *<i>str</i>, int <i>n</i>);int getstr(char *<i>str</i>);int mvgetnstr(int <i>y</i>, int <i>x</i>, char *<i>str</i>, int <i>n</i>);int mvgetstr(int <i>y</i>, int <i>x</i>, char *<i>str</i>);int mvwgetnstr(WINDOW *<i>win</i>, int <i>y</i>, int <i>x</i>, char *<i>str</i>, int <i>n</i>);int mvwgetstr(WINDOW *<i>win</i>, int <i>y</i>, int <i>x</i>, char *<i>str</i>);int wgetnstr(WINDOW *<i>win</i>, char *<i>str</i>, int <i>n</i>);int wgetstr(WINDOW *<i>win</i>, char *<i>str</i>);</code></pre></blockquote><h4><a name = "tag_002_001_435"> </a>DESCRIPTION</h4><blockquote>The effect of<i><a href="getstr.html">getstr()</a></i>is as though a series of calls to<i><a href="getch.html">getch()</a></i>were made, until a newline, carriage return orend-of-file is received.The resulting value is placed in the area pointed to by <i>str</i>.The string is then terminated with a null byte. The<i>getnstr()</i>,<i>mvgetnstr()</i>,<i>mvwgetnstr()</i>and<i>wgetnstr()</i>functions read at most <i>n</i> bytes, thus preventing a possible overflow ofthe input buffer. The user's erase and kill characters are interpreted, aswell as any special keys (such as function keys, home key, clear key, and soon).<p>The<i>mvgetstr()</i>function is identical to<i><a href="getstr.html">getstr()</a></i>except that it is as though it is a call to<i><a href="move.html">move()</a></i>and then a series of calls to<i><a href="getch.html">getch()</a></i>.The<i>mvwgetstr()</i>function is identical to<i><a href="getstr.html">getstr()</a></i>except it is as though a call to<i><a href="wmove.html">wmove()</a></i>is made and then a series of calls to<i><a href="wgetch.html">wgetch()</a></i>. The<i>mvgetnstr()</i>function is identical to<i>getnstr()</i>except that it is as though it is a call to<i><a href="move.html">move()</a></i>and then a series of calls to<i><a href="getch.html">getch()</a></i>.The<i>mvwgetnstr()</i>function is identical to<i>getnstr()</i>except it is as though a call to<i><a href="wmove.html">wmove()</a></i>is made and then a series of calls to<i><a href="wgetch.html">wgetch()</a></i>.<p>The<i>getnstr()</i>,<i>wgetnstr()</i>,<i>mvgetnstr()</i>and<i>mvwgetnstr()</i>functions will only return the entire multi-byte sequence associated with acharacter. If the array is large enough to contain at least one character,the functions fill the array with complete characters. If the array is notlarge enough to contain any complete characters, the function fails.</blockquote><h4><a name = "tag_002_001_436"> </a>RETURN VALUE</h4><blockquote>Upon successful completion, these functions return OK.Otherwise, they return ERR.</blockquote><h4><a name = "tag_002_001_437"> </a>ERRORS</h4><blockquote>No errors are defined.</blockquote><h4><a name = "tag_002_001_438"> </a>APPLICATION USAGE</h4><blockquote>Reading a line that overflows the array pointed to by <i>str</i> with<i><a href="getstr.html">getstr()</a></i>,<i>mvgetstr()</i>,<i>mvwgetstr()</i>or<i>wgetstr()</i>causes undefined results. The use of<i>getnstr()</i>,<i>mvgetnstr()</i>,<i>mvwgetnstr()</i>or<i>wgetnstr()</i>,respectively, is recommended.</blockquote><h4><a name = "tag_002_001_439"> </a>SEE ALSO</h4><blockquote><xref href=terminalinput><a href="intov.html#tag_001_005">Input Processing</a></xref>,<i><a href="beep.html">beep()</a></i>,<i><a href="getch.html">getch()</a></i>,<i><a href="curses.h.html"><curses.h></a></i>.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -