Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > I

innwstr(3X)

ENHANCED CURSES
HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

innwstr, inwstr, mvinnwstr, mvinwstr, mvwinnwstr, mvwinwstr, winnwstr, winwstr — input a string of wide characters from a window

SYNOPSIS

#include <curses.h>

int innwstr(wchar_t *wstr, int n);

int inwstr(wchar_t *wstr);

int mvinnwstr(int y, int x, wchar_t *wstr, int n);

int mvinwstr(int y, int x, wchar_t *wstr);

int mvwinnwstr(WINDOW *win, int y, int x, wchar_t *wstr, int n);

int mvwinwstr(WINDOW *win, int y, int x, wchar_t *wstr);

int winnwstr(WINDOW *win, wchar_t *wstr, int n);

int winwstr(WINDOW *win, wchar_t *wstr);

DESCRIPTION

These functions place a string of wchar_t characters from the current or specified window into the array pointed to by wstr starting at the current or specified cursor position and ending at the end of the line.

These functions will only store the entire wide character sequence associated with a spacing complex character. If the array is large enough to contain at least one complete spacing complex character, the array is filled with complete characters. If the array is not large enough to contain any complete characters this is an error.

The innwstr(), mvinnwstr(), mvwinnwstr() and winnwstr() functions store at most n characters in the array pointed to by wstr.

RETURN VALUE

Upon successful completion, inwstr(), mvinwstr(), mvwinwstr() and winwstr() return OK.

Upon successful completion, innwstr(), mvinnwstr(), mvwinnwstr() and winnwstr() return the number of characters actually read into the string.

Otherwise, all these functions return ERR.

ERRORS

No errors are defined.

APPLICATION USAGE

Reading a line that overflows the array pointed to by wstr with inwstr(), mvinwstr(), mvwinwstr() or winwstr() causes undefined results. The use of innwstr(), mvinnwstr(), mvwinnwstr() or winnwstr(), respectively, is recommended.

These functions do not return rendition information.

SEE ALSO

<curses.h>.

CHANGE HISTORY

First released in X/Open Curses, Issue 4.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.