1stringprep_4i(3)                    libidn                    stringprep_4i(3)
2
3
4

NAME

6       stringprep_4i - API function
7

SYNOPSIS

9       #include <stringprep.h>
10
11       int  stringprep_4i(uint32_t  *  ucs4,  size_t * len, size_t maxucs4len,
12       Stringprep_profile_flags flags, const Stringprep_profile * profile);
13

ARGUMENTS

15       uint32_t * ucs4
16                   input/output array with string to prepare.
17
18       size_t * len
19                   on input, length of input array with Unicode  code  points,
20                   on exit, length of output array with Unicode code points.
21
22       size_t maxucs4len
23                   maximum length of input/output array.
24
25       Stringprep_profile_flags flags
26                   a Stringprep_profile_flags value, or 0.
27
28       const Stringprep_profile * profile
29                   pointer to Stringprep_profile to use.
30

DESCRIPTION

32       Prepare the input UCS-4 string according to the stringprep profile, and
33       write back the result to the input string.
34
35       The input is not required to be zero terminated ( ucs4 [ len  ]  =  0).
36       The  output  will  not  be  zero  terminated  unless  ucs4 [ len ] = 0.
37       Instead, see stringprep_4zi() if your input is zero  terminated  or  if
38       you want the output to be.
39
40       Since the stringprep operation can expand the string,  maxucs4len indi‐
41       cate how large the buffer holding the string is.   This  function  will
42       not read or write to code points outside that size.
43
44       The  flags are one of Stringprep_profile_flags values, or 0.
45
46       The   profile  contain  the Stringprep_profile instructions to perform.
47       Your application can define new profiles, possibly re-using the generic
48       stringprep  tables  that always will be part of the library, or use one
49       of the currently supported profiles.
50
51       Return value: Returns STRINGPREP_OK iff successful, or an Stringprep_rc
52       error code.
53

REPORTING BUGS

55       Report bugs to <bug-libidn@gnu.org>.
56       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
57       GNU Libidn home page: http://www.gnu.org/software/libidn/
58
59

61       Copyright © 2002-2016 Simon Josefsson.
62       Copying  and  distribution  of this file, with or without modification,
63       are permitted in any medium  without  royalty  provided  the  copyright
64       notice and this notice are preserved.
65

SEE ALSO

67       The  full  documentation  for libidn is maintained as a Texinfo manual.
68       If the info and libidn programs are properly installed  at  your  site,
69       the command
70
71              info libidn
72
73       should  give  you access to the complete manual.  As an alternative you
74       may obtain the manual from:
75
76              http://www.gnu.org/software/libidn/manual/
77
78libidn                               1.34                     stringprep_4i(3)
Impressum