---
name: "curs_in_wch"
section: "3x"
platform: "macos"
package: "ncurses"
version: "79"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/curs_in_wch/3x"
---

# curs\_in\_wch(3x)

extract a complex character and rendition from a window

## NAME

**in\_wch**, **mvin\_wch**, **mvwin\_wch**, **win\_wch** - extract a complex character and rendition from a window

## SYNOPSIS

**#include \<curses.h\>**

**int in\_wch(cchar\_t \****wcval***);**\
 **int mvin\_wch(int** *y***, int** *x***, cchar\_t \****wcval***);**\
 **int mvwin\_wch(WINDOW \****win***, int** *y***, int** *x***, cchar\_t \****wcval***);**\
 **int win\_wch(WINDOW \****win***, cchar\_t \****wcval***);**

## DESCRIPTION

These functions extract the complex character and rendition from the current position in the named window into the **cchar\_t** object referenced by wcval.

## RETURN VALUE

No errors are defined in the XSI Curses standard. This implementation checks for null pointers, returns ERR in that case. Also, the *mv* routines check for error moving the cursor, returning ERR in that case. Otherwise they return OK

Functions with a "mv" prefix first perform a cursor movement using **wmove**, and return an error if the position is outside the window, or if the window pointer is null.

## NOTES

Note that all of these routines may be macros.

## PORTABILITY

These functions are described in the XSI Curses standard, Issue 4.

## SEE ALSO

**curses**(3X), **curs\_inch**(3X).