---
name: "mbsinit"
section: "3"
platform: "macos"
package: "Libc"
version: "1752.120.2"
release: "macOS 26.5"
platforms: ["linux", "freebsd", "macos"]
url: "https://new.carta.tech/mbsinit"
---

# mbsinit(3)

determine conversion object status

## NAME

**mbsinit**, **mbsinit\_l** – determine conversion object status

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

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

*int*\

**mbsinit**(*const mbstate\_t \*ps*);

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

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

*int*\

**mbsinit\_l**(*const mbstate\_t \*ps*, *locale\_t loc*);

## DESCRIPTION

The **mbsinit**() function determines whether the *mbstate\_t* object pointed to by *ps* describes an initial conversion state.

While the **mbsinit**() function uses the current locale, the **mbsinit\_l**() function may be passed a locale directly. See [xlocale(3)](/xlocale/3.md) for more information.

## RETURN VALUES

The **mbsinit**() function returns non-zero if *ps* is NULL or describes an initial conversion state; otherwise, it returns zero.

## SEE ALSO

[mbrlen(3)](/mbrlen/3.md), [mbrtowc(3)](/mbrtowc/3.md), [mbsrtowcs(3)](/mbsrtowcs/3.md), [multibyte(3)](/multibyte/3.md), [wcrtomb(3)](/wcrtomb/3.md), [wcsrtombs(3)](/wcsrtombs/3.md), [xlocale(3)](/xlocale/3.md)

## STANDARDS

The **mbsinit**() function conforms to ISO/IEC 9899:1999 (“ISO C99”).