Scroll to navigation

idna(3tcl) Tcl Bundled Packages idna(3tcl) 





NAME


tcl::idna - Support for normalization of Internationalized Domain
    Names






SYNOPSIS


package require tcl::idna 1.0
tcl::idna decode hostname
tcl::idna encode hostname
tcl::idna puny decode string ?case?
tcl::idna puny encode string ?case?
tcl::idna version








DESCRIPTION


This package provides an implementation of the punycode scheme
    used in Internationalised Domain Names, and some access commands. (See RFC
    3492 for a description of punycode.)



  

  
This command takes the name of a host that potentially contains
      punycode-encoded character sequences, hostname, and returns the
      hostname as might be displayed to the user. Note that there are often
      UNICODE characters that have extremely similar glyphs, so care should be
      taken with displaying hostnames to users.

  

  
This command takes the name of a host as might be displayed to the user,
      hostname, and returns the version of the hostname with characters
      not permitted in basic hostnames encoded with punycode.

  

  
This command provides direct access to the basic punycode encoder and
      decoder. It supports two subcommands:







  

  
This command decodes the punycode-encoded string, string, and
      returns the result. If case is provided, it is a boolean to make
      the case be folded to upper case (if case is true) or lower case
      (if case is false) during the decoding process; if omitted, no case
      transformation is applied.

  

  
This command encodes the string, string, and returns the
      punycode-encoded version of the string. If case is provided, it is
      a boolean to make the case be folded to upper case (if case is
      true) or lower case (if case is false) during the encoding process;
      if omitted, no case transformation is applied.







  

  
This returns the version of the tcl::idna package.








EXAMPLE


This is an example of how punycoding of a string works:






package require tcl::idna
puts [tcl::idna puny encode "abc→def"]
#    prints: abcdef-kn2c
puts [tcl::idna puny decode "abcdef-kn2c"]
#    prints: abc→def








SEE ALSO


http(3tcl), cookiejar(3tcl)






KEYWORDS


internet, www







  

    0.1
    http