.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Catalyst::Plugin::Unicode 3pm"
.TH Catalyst::Plugin::Unicode 3pm "2021-01-04" "perl v5.32.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Catalyst::Plugin::Unicode \- Unicode aware Catalyst (old style)
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 3
\&    # DO NOT USE THIS \- Use Catalyst::Plugin::Unicode::Encoding instead
\&    #                   which is both more correct, and handles more cases.
\&    use Catalyst qw[Unicode];
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
On request, decodes all params from \s-1UTF\-8\s0 octets into a sequence of
logical characters. On response, encodes body into \s-1UTF\-8\s0 octets.
.PP
Note that this plugin tries to autodetect if your response is encoded into
characters before trying to encode it into a byte stream. This is \fBbad\fR
as sometimes it can guess wrongly and cause problems.
.PP
As an example, latin1 characters such as é (e\-accute) will not actually
cause the output to be encoded as utf8.
.PP
Using Catalyst::Plugin::Unicode::Encoding is much more recommended,
and that also does additional things (like decoding file upload filenames
and request parameters which this plugin does not).
.PP
This plugin should be considered deprecated, but is maintained as a large
number of applications are using it already.
.SH "OVERLOADED METHODS"
.IX Header "OVERLOADED METHODS"
.IP "finalize" 4
.IX Item "finalize"
Encodes body into \s-1UTF\-8\s0 octets.
.IP "prepare_parameters" 4
.IX Item "prepare_parameters"
Decodes parameters into a sequence of logical characters.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
utf8, Catalyst.
.SH "AUTHORS"
.IX Header "AUTHORS"
Christian Hansen, \f(CW\*(C`<ch@ngmedia.com>\*(C'\fR
.PP
Marcus Ramberg, \f(CW\*(C`<mramberg@pcan.org>\*(C'\fR
.PP
Jonathan Rockway \f(CW\*(C`<jrockway@cpan.org>\*(C'\fR
.PP
Tomas Doran, (t0m) \f(CW\*(C`<bobtfish@bobtfish.net>\*(C'\fR
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 2005 \- 2009
the Catalyst::Plugin::Unicode \*(L"\s-1AUTHORS\*(R"\s0
as listed above.
.SH "LICENSE"
.IX Header "LICENSE"
This library is free software . You can redistribute it and/or modify
it under the same terms as perl itself.