Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Unicode::RecursiveDownUsereContributed Perl DocuUnicode::RecursiveDowngrade(3)

NAME
       Unicode::RecursiveDowngrade - Turn off the UTF-8	flags inside of
       complex variable

SYNOPSIS
	use Unicode::RecursiveDowngrade;

	$rd = Unicode::RecursiveDowngrade->new;
	$var = {
	    foo	  => 'bar',
	    baz	  => [
		'qux',
		'quux',
	    ],
	    corge => \$grault,
	};
	$unflagged = $rd->downgrade($var);

DESCRIPTION
       Unicode::RecursiveDowngrade will	turn off the UTF-8 flag	inside of
       complex variable	in a lump.  In spite of	your intention,	some modules
       turn it on every	elements of returned variable.	You may	be hard	up for
       turn them off if	you don't need any UTF-8 flags in your variable.  This
       module will fix it up easily.

       Sometime	I think	about the UTF-8	flag is	not stead.  But	some
       "XML::Parser" based modules will	turn it	on.  For example,
       "XML::Simple" is	really simple way to parse XMLs, but this module
       returns a simple	hashref	including flagged values.  This	hashref	is
       very hard to use, isn't it?

METHODS
       o   new

	   "new()" is a	constructor method.

       o   filter

	   You can set some filter to "filter()" accessor. The values of
	   downgraded will be passed this filter function.  You	have to	set a
	   code	reference to this accessor.  Like this:

	    use	Unicode::RecursiveDowngrade;
	    use	Unicode::Japanese;

	    $rd	= Unicode::RecursiveDowngrade->new;
	    $rd->filter(sub { Unicode::Japanese->new(shift, 'utf8')->euc });
	    $unflagged = $rd->downgrade($var);

	   the passed subref will be called inside "downgrade()" method.

       o   downgrade

	   "downgrade()" returns a turned off variable of argument.

VARIABLES
       o   $Unicode::RecursiveDowngrade::DowngradeFunc

	   This	variable has a downgrade function for "downgrade()" method.
	   You can override the	variable for some other	way.

AUTHOR
       Koichi Taniguchi	<taniguchi@livedoor.jp>

COPYRIGHT
       Copyright (c) 2005 Koichi Taniguchi. Japan. All rights reserved.

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

SEE ALSO
       utf8

perl v5.32.0			  2008-03-06	Unicode::RecursiveDowngrade(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | VARIABLES | AUTHOR | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Unicode::RecursiveDowngrade&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help