Magnus Håkansson > Decode-Source > Decode::Source

Download:
Decode-Source-1.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.01   Source  

NAME ^

Decode::Source - Run scripts written in encodings other than utf-8

SYNOPSIS ^

    use Decode::Source "iso-8859-1";
       ... code written in ISO-8859-1 ...
    use Decode::Source "cp-850";
       ... code written in DOS codepage 850 ...
    no Decode::Source;
        ... code written in US-ASCII ...

ABSTRACT ^

Use alternative encodings/charsets for your program code. Perl 5.8 or higher is required for use of this module.

DESCRIPTION ^

This code is so far only tested on Win32 platforms!

Decode::Source makes it possible to write perl programs in any script or encoding supported by the Encode module. Variable names can contain non-ASCII characters, just as when you use the use utf8 pragma. All theese characters, both in identifiers and string literals, will be decoded to perl's internal utf-8 form, before execution.

The syntax are similar to use utf8 and no utf8, but Decode::Source also takes an optional argument with source encoding. This argument can be any argument that Encode's decode function accept as a valid encoding. See also Encode.

EXAMPLE ^

  use Decode::Source "windows-1252";
  
  $åke   = ["Åke Braun", "08-555 55 55"];
  $örjan = ["Örjan Älg", "08-555 55 54"];

  binmode STDOUT, ":encodings(cp850)";
  
  printf "Name: %-20s   Phone: %12s\n", @$_ for $åke, $örjan;

SEE ALSO ^

Encode, Encode::Supported, utf8

AUTHOR ^

Magnus Håkansson, <mailto:magnus@mbox604.swipnet.se>

COPYRIGHT AND LICENSE ^

Copyright 2003 by Magnus Håkansson

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

syntax highlighting: