Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

stringprep_ucs4_to_utf8 (3)

Name

stringprep_ucs4_to_utf8 - API function

Synopsis

#include <stringprep.h>

char  *  stringprep_ucs4_to_utf8(const  uint32_t  *  str,  ssize_t len,
size_t * items_read, size_t * items_written);

Description

libidn                                              stringprep_ucs4_to_utf8(3)



NAME
       stringprep_ucs4_to_utf8 - API function

SYNOPSIS
       #include <stringprep.h>

       char  *  stringprep_ucs4_to_utf8(const  uint32_t  *  str,  ssize_t len,
       size_t * items_read, size_t * items_written);

ARGUMENTS
       const uint32_t * str
                   a UCS-4 encoded string

       ssize_t len the maximum length of  str to use. If  len <  0,  then  the
                   string is terminated with a 0 character.

       size_t * items_read
                   location to store number of characters read read, or NULL.

       size_t * items_written
                   location  to  store  number  of bytes written or NULL.  The
                   value here stored does not include the trailing 0 byte.

DESCRIPTION
       Convert a string from a 32-bit fixed width representation as UCS-4.  to
       UTF-8. The result will be terminated with a 0 byte.

       Return  value: a pointer to a newly allocated UTF-8 string.  This value
       must be deallocated by the caller.  If an error occurs,  NULL  will  be
       returned.

REPORTING BUGS
       Report bugs to <bug-libidn@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GNU Libidn home page: http://www.gnu.org/software/libidn/


COPYRIGHT
       Copyright (C) 2002-2016 Simon Josefsson.
       Copying  and  distribution  of this file, with or without modification,
       are permitted in any medium  without  royalty  provided  the  copyright
       notice and this notice are preserved.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libidn   |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       The  full  documentation  for libidn is maintained as a Texinfo manual.
       If the info and libidn programs are properly installed  at  your  site,
       the command

              info libidn

       should  give  you access to the complete manual.  As an alternative you
       may obtain the manual from:

              http://www.gnu.org/software/libidn/manual/

NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from
       https://ftp.gnu.org/gnu/libidn/libidn-1.34.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/libidn.



libidn                               1.34
                                                    stringprep_ucs4_to_utf8(3)