svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
curs_insstr(3x)
curs_insstr(3x) Library calls curs_insstr(3x)
NAME
insstr, winsstr, mvinsstr, mvinsnstr, insnstr, winsnstr, mvwinsstr,
mvwinsnstr - insert a string in a curses window
SYNOPSIS
#include <ncursesw/curses.h>
int insstr(const char * str);
int winsstr(WINDOW * win, const char * str);
int mvinsstr(int y, int x, const char * str);
int mvwinsstr(WINDOW * win, int y, int x, const char * str);
int insnstr(const char * str, int n);
int winsnstr(WINDOW * win, const char * str, int n);
int mvinsnstr(int y, int x, const char * str, int n);
int mvwinsnstr(WINDOW * win, int y, int x, const char * str,
int n);
DESCRIPTION
winsstr inserts a string str before the character at the cursor in win‐
dow win as if by calling winsch(3X) for each char in str. No line
wrapping is performed. Characters to the right of the cursor are
shifted right; those at the right edge of the window may be lost.
winsstr stops inserting if it would have to wrap to the next line to
write the next char in str. The cursor position does not change (after
moving to (y, x), if specified). insnstr does the same, but inserts at
most n characters, or as many as possible (up to the end of the line)
if n is negative. ncurses(3X) describes the variants of these func‐
tions.
RETURN VALUE
These functions return OK on success and ERR on failure.
In ncurses, they return ERR if
• win is NULL,
• str is NULL, or
• an internal winsch(3X) call returns ERR.
Functions prefixed with “mv” first perform cursor movement and fail if
the position (y, x) is outside the window boundaries.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
ity library/ncurses = Stability Uncommitted
NOTES
All of these functions except winsnstr may be implemented as macros.
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at:
https://github.com/oracle/solaris-userland
The original community source was downloaded from:
https://invisible-mirror.net/archives/ncurses/cur‐
rent/ncurses-6.5-20250614.tgz
Further information about this software can be found on the open source
community website at https://invisible-island.net/ncurses/.
EXTENSIONS
insnstr, winsnstr, mvinsnstr, and mvwinsnstr's acceptance of negative n
values is an ncurses extension.
PORTABILITY
Applications employing ncurses extensions should condition their use on
the visibility of the NCURSES_VERSION preprocessor macro.
X/Open Curses Issue 4 describes these functions. It specifies no error
conditions for them.
SVr4 describes a successful return value only as “an integer value
other than ERR”.
Issue 4 distinguished insnstr and winsnstr from the other functions
documented above by stating they “do not perform wrapping”. This was
probably an error, since it makes this group of functions inconsistent.
No implementation of curses manifests this inconsistency, and Issue 7
removed the claim.
Issue 4 states that the entire string is inserted if n is less than 1.
This is probably an error, because it is inconsistent with other func‐
tions such as waddstr, and differs from the SVr4 curses and Solaris
xcurses implementations. Nevertheless, Issue 7 retains the language.
HISTORY
SVr3.1 (1987) introduced winsstr and winsnstr and their variants.
SEE ALSO
curs_ins_wstr(3X) describes comparable functions of the ncurses library
in its wide-character configuration (ncursesw).
curses(3X), curs_inch(3X), curs_ins_wstr(3X), curs_util(3X)
ncurses 6.5 2025-02-01 curs_insstr(3x)