The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

mbsrtowcs (3)
  • mbsrtowcs (3) ( Solaris man: Библиотечные вызовы )
  • >> mbsrtowcs (3) ( FreeBSD man: Библиотечные вызовы )
  • mbsrtowcs (3) ( Русские man: Библиотечные вызовы )
  • mbsrtowcs (3) ( Linux man: Библиотечные вызовы )
  • mbsrtowcs (3) ( POSIX man: Библиотечные вызовы )

  • BSD mandoc
     

    NAME

    
    
    mbsrtowcs
    
     
    mbsnrtowcs
    
     - convert a character string to a wide-character string (restartable)
    
     
    

    LIBRARY

    Lb libc
    
     
    

    SYNOPSIS

       #include <wchar.h>
    size_t Fo mbsrtowcs Fa wchar_t * restrict dst const char ** restrict src size_t len Fa mbstate_t * restrict ps Fc Ft size_t Fo mbsnrtowcs Fa wchar_t * restrict dst const char ** restrict src size_t nms Fa size_t len mbstate_t * restrict ps Fc  

    DESCRIPTION

    The mbsrtowcs ();
    function converts a sequence of multibyte characters pointed to indirectly by Fa src into a sequence of corresponding wide characters and stores at most Fa len of them in the Vt wchar_t array pointed to by Fa dst , until it encounters a terminating null character ('\0' )

    If Fa dst is NULL no characters are stored.

    If Fa dst is not NULL the pointer pointed to by Fa src is updated to point to the character after the one that conversion stopped at. If conversion stops because a null character is encountered, Fa *src is set to NULL

    The Vt mbstate_t argument, Fa ps , is used to keep track of the shift state. If it is NULL mbsrtowcs ();
    uses an internal, static Vt mbstate_t object, which is initialized to the initial conversion state at program startup.

    The mbsnrtowcs ();
    function behaves identically to mbsrtowcs (,);
    except that conversion stops after reading at most Fa nms bytes from the buffer pointed to by Fa src .  

    RETURN VALUES

    The mbsrtowcs ();
    and mbsnrtowcs ();
    functions return the number of wide characters stored in the array pointed to by Fa dst if successful, otherwise it returns Po Vt size_t Pc Ns -1 .  

    ERRORS

    The mbsrtowcs ();
    and mbsnrtowcs ();
    functions will fail if:

    Bq Er EILSEQ
    An invalid multibyte character sequence was encountered.
    Bq Er EINVAL
    The conversion state is invalid.

     

    SEE ALSO

    mbrtowc(3), mbstowcs(3), multibyte(3), wcsrtombs(3)  

    STANDARDS

    The mbsrtowcs ();
    function conforms to St -isoC-99 .

    The mbsnrtowcs ();
    function is an extension to the standard.


     

    Index

    NAME
    LIBRARY
    SYNOPSIS
    DESCRIPTION
    RETURN VALUES
    ERRORS
    SEE ALSO
    STANDARDS


    Поиск по тексту MAN-ов: 




    Спонсоры:
    Inferno Solutions
    Ideco
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2021 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру