---
name: "URI::_punycode"
section: "3pm"
platform: "linux"
package: "perl-uri"
version: "5.40-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/URI::_punycode"
---

# URI::\_punycode(3pm)

encodes Unicode string in Punycode

## NAME

URI::\_punycode - encodes Unicode string in Punycode

## SYNOPSIS

```
  use strict;
  use warnings;
  use utf8;
  use URI::_punycode qw(encode_punycode decode_punycode);
  # encode a unicode string
  my $punycode = encode_punycode('http://☃.net'); # http://.net-xc8g
  $punycode = encode_punycode('bücher'); # bcher-kva
  $punycode = encode_punycode('他们为什么不说中文'); # ihqwcrb4cv8a8dqg056pqjye
  # decode a punycode string back into a unicode string
  my $unicode = decode_punycode('http://.net-xc8g'); # http://☃.net
  $unicode = decode_punycode('bcher-kva'); # bücher
  $unicode = decode_punycode('ihqwcrb4cv8a8dqg056pqjye'); # 他们为什么不说中文
```

## DESCRIPTION

URI::\_punycode is a module to encode / decode Unicode strings into Punycode \<https://tools.ietf.org/html/rfc3492\>, an efficient encoding of Unicode for use with IDNA \<https://tools.ietf.org/html/rfc5890\>.

## FUNCTIONS

All functions throw exceptions on failure. You can `"catch"` them with Syntax::Keyword::Try or Try::Tiny. The following functions are exported by default.

### encode\_punycode

```
  my $punycode = encode_punycode('http://☃.net');  # http://.net-xc8g
  $punycode = encode_punycode('bücher'); # bcher-kva
  $punycode = encode_punycode('他们为什么不说中文') # ihqwcrb4cv8a8dqg056pqjye
```

Takes a Unicode string (UTF8-flagged variable) and returns a Punycode encoding for it.

### decode\_punycode

```
  my $unicode = decode_punycode('http://.net-xc8g'); # http://☃.net
  $unicode = decode_punycode('bcher-kva'); # bücher
  $unicode = decode_punycode('ihqwcrb4cv8a8dqg056pqjye'); # 他们为什么不说中文
```

Takes a Punycode encoding and returns original Unicode string.

## AUTHOR

Tatsuhiko Miyagawa \<*miyagawa@bulknews.net*\> is the author of IDNA::Punycode which was the basis for this module.

## SEE ALSO

IDNA::Punycode, RFC 3492 \<https://tools.ietf.org/html/rfc3492\>, RFC 5891 \<https://tools.ietf.org/html/rfc5891\>

## COPYRIGHT AND LICENSE

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