# $Id: API.pod,v 1.11 2002/02/28 02:21:00 m-kasahr Exp $
#
# Copyright (c) 2001 Japan Network Information Center.  All rights reserved.
#  
# By using this file, you agree to the terms and conditions set forth bellow.
# 
#                      LICENSE TERMS AND CONDITIONS 
# 
# The following License Terms and Conditions apply, unless a different
# license is obtained from Japan Network Information Center ("JPNIC"),
# a Japanese association, Fuundo Bldg., 1-2 Kanda Ogawamachi, Chiyoda-ku,
# Tokyo, Japan.
# 
# 1. Use, Modification and Redistribution (including distribution of any
#    modified or derived work) in source and/or binary forms is permitted
#    under this License Terms and Conditions.
# 
# 2. Redistribution of source code must retain the copyright notices as they
#    appear in each source code file, this License Terms and Conditions.
# 
# 3. Redistribution in binary form must reproduce the Copyright Notice,
#    this License Terms and Conditions, in the documentation and/or other
#    materials provided with the distribution.  For the purposes of binary
#    distribution the "Copyright Notice" refers to the following language:
#    "Copyright (c) Japan Network Information Center.  All rights reserved."
# 
# 4. Neither the name of JPNIC may be used to endorse or promote products
#    derived from this Software without specific prior written approval of
#    JPNIC.
# 
# 5. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY JPNIC
#    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
#    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
#    PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL JPNIC BE LIABLE
#    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
#    CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
#    SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
#    BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
#    WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
#    OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
#    ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
# 
# 6. Indemnification by Licensee
#    Any person or entities using and/or redistributing this Software under
#    this License Terms and Conditions shall defend indemnify and hold
#    harmless JPNIC from and against any and all judgements damages,
#    expenses, settlement liabilities, cost and other liabilities of any
#    kind as a result of use and redistribution of this Software or any
#    claim, suite, action, litigation or proceeding by any third party
#    arising out of or relates to this License Terms and Conditions.
# 
# 7. Governing Law, Jurisdiction and Venue
#    This License Terms and Conditions shall be governed by and and
#    construed in accordance with the law of Japan. Any person or entities
#    using and/or redistributing this Software under this License Terms and
#    Conditions hereby agrees and consent to the personal and exclusive
#    jurisdiction and venue of Tokyo District Court of Japan.
#

__END__

=head1 NAME

MDN::API - libmdn Υɥᥤ̾Ѵ᥽åɤ Perl ؤΥ󥿡ե

=head1 SYNOPSIS

  use MDN::API;

  $idn_domain_name = MDN::API->encode($local_domain_name);
  $local_domain_name = MDN::API->decode($idn_domain_name);

=head1 DESCRIPTION

C<MDN::ResConf> ϡmDNkit °Ƥ libmdn Ȥ¿ɥᥤ
̾饤֥Υɥᥤ̾Ѵ᥽åɤФơPerl Υ֥
󥿡ե󶡤ޤ

Υ⥸塼 libmdn Ф롢٥Ѵ󥿡ե
ޤlibmdn  (: C</usr/local/etc/mdn.conf>) ˽äɥᥤ
̾Υ󥳡ɤ䥨󥳡ɤԤȤǤޤ

=head1 饹᥽å

Υ⥸塼ϥ֥ȥ󥿡ե󶡤櫓Ǥޤ
C<MDN::> ¾Υ⥸塼ȤΰθơؿϤ٤ƥ饹
᥽åɤȤƸƤӽФ褦ˤʤäƤޤ

        MDN::API->encode($domain_name);  # 
        MDN::API::encode($domain_name);  # 

=over 4

=item encode_name($from [, @actions...])

C<@actions> ˽äƥɥᥤ̾ C<$from> 򥨥󥳡ɤ̤֤ޤ

C<@actions> γǤϡʸǤ

    'localconv'     륨󥳡ǥ󥰤ʸ UTF-8 Ѵ
    'delimmap'      ʶڤʸԥꥪ ('.') Ѵ
    'localmap'      ʥޥåԥ
    'nameprep'      NAMEPREP μ¹ (ޥåԥ󥰡ػʸ
                    ̤ƥɥݥȤθ)
    'idnconv'       UTF-8 ʸ ACE Ѵ

    'encode_app'    'localconv', 'delimmap', 'localmap', 'nameprep',
                    'idnconv' ¹ԡ@actions άϤꤷ
                    Ȥˤʤ

C<@actions> Ǥνˤ餺 C<'localconv'>
C<'delimmap'>C<'localmap'>C<'nameprep'>C<'idnconv'> ν֤
¹Ԥޤ

顼ȯȤϡC<undef> ֤ޤ

=item decode_name($from [, @actions...])

C<@actions> ˽äƥɥᥤ̾ C<$from> ǥɤ̤֤ޤ
C<encode_name> ȿФư򤷤ޤ

C<@actions> γǤϡʸǤ

    'idnconv'       ACE ʸ UTF-8 Ѵ
    'nameprep'      NAMEPREP νѤޤʸ󤫤ɤθ
                    ѤޤʸǤʤСACE Ѵ롣
    'localconv'     UTF-8 ʸ륨󥳡ǥ󥰤Ѵ

    'decode_app'    'idnconv', 'nameprep', 'localconv' ¹
                    @actions άϤꤷȤˤʤޤ

C<@actions> Ǥνˤ餺 C<'idnconv'>
C<'nameprep'>C<'localconv'> ν֤Ǽ¹Ԥޤ

顼ȯȤϡC<undef> ֤ޤ

=item enable($on_off)

libmdn ˤä󶡤Ƥ¿ɥᥤ̾бͭޤ
̵ޤ
C<$on_off> ʤб̵ˤʤꡢʳʤͭˤʤޤ
Υ᥽åɤƤӽФʤС¿ɥᥤ̾бͭˤ뤫
ɤȽˡĶѿ C<MDN_DISABLE> Ѥޤ
ѿƤС̵ˤʤޤ

̵줿֤ǤϡѴ᥽å (C<encode_name()> 
C<decode_name()>) ñϤ줿ʸΥԡѴ̤Ȥ
֤Ƥޤ

=item lasterror()

Υ⥸塼ǰֺǸȯ顼Υ顼åʸ
֤ޤ

=item local_to_utf8($from)

C<encode_name($from, 'localconv')> Ǥ

=item utf8_to_local($from)

C<decode_name($from, 'localconv')> Ǥ

=item delimiter_map($from)

C<encode_name($from, 'delimmap')> Ǥ

=item local_map($from)

C<encode_name($from, 'localmap')> Ǥ

=item nameprep($from)

C<encode_name($from, 'nameprep')> Ǥ

=item nameprep_check($from)

C<decode_name($from, 'nameprep')> Ǥ

=item utf8_to_idn($from)

C<encode_name($from, 'idnconv')> Ǥ

=item idn_to_utf8($from)

C<decode_name($from, 'idnconv')> Ǥ

=item local_to_idn($from)

C<encode_name($from)> Ǥ

=item idn_to_local($from)

C<decode_name($from)> Ǥ

=back

=head1 ߴ

С 2.4 顢C<encode_name()>  C<decode_name()> ᥽å
ˤơʸ C<'nameprep'> ̤ƥɥݥȤθԤ
褦ˤʤޤ
ʸ C<'unascheck'>  C<unassigned_check()> ᥽åɤϡ
ޤ

=head1 Unicode ʸμ갷˴ؤ

L<MDN::UTF8> ΡUnicode ʸμ갷˴ؤơפιɤߤ

=head1 SEE ALSO

L<mdn.conf(5)>, L<MDN::ResConf>, L<MDN::UTF8>

MDN 饤֥ͽ

=cut