GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  IDN_COMPARENAMES (3)

NAME

idn_comparenames, idn_decodename2 - compare two internationzalized domain names

CONTENTS

Synopsis
Description
Examples

SYNOPSIS

#include <idn/api.h>

idn_result_t idn_comparenames(idn_action_t actions, const char *name1, const char *name2);

idn_result_t idn_comparenames2(idn_action_t actions1, const char *name1, idn_action_t actions2, const char *name2);

DESCRIPTION

The function idn_comparenames() encodes domain names name1 and name2 as idn_encodename() does, and then compares them. If they are equivalent, it returns idn_success. Otherwise, it returns idn_neq. When an error occurs in the encoding processes, the function returns the corresponding error code (see idn_result_tostring(3) for details).

The function idn_comparenames2() works same as idn_comparenames(), but it performs actions1 when it encodes name1 and it performs actions2 when it encodes name2 respectively.

In addition with action macros for idn_encodename() (e.g. IDN_UNICODECONV), the following macros are available for idn_comparenames() and idn_comparenames2().

IDN_COMPARE_REGIST Encode a domain name with IDNA2008 registration protocol, before comparison. Currently, its value is the same as IDN_ENCODE_REGIST.
IDN_COMPARE_LOOKUP Encode a domain name with IDNA2008 lookup protocol, before comparison. Currently, its value is the same as IDN_ENCODE_LOOKUP.

EXAMPLES

The program below shows an example of idn_comparenames().


idn_result_t r;
...
r = idn_comparenames(IDN_COMPARE_LOOKUP, name1, name2);
if (r == idn_success)
    fprintf(stderr, "’%s’ == ’%s’\n", name1, name2);
else if (r == idn_neq)
    fprintf(stderr, "’%s’ != ’%s’\n", name1, name2);
else
    fprintf(stderr, "error: %s\n", idn_result_tostring(r));
...


SEE ALSO

idncmp(1), libidnkit(3), idn_encodename(3), idn_nameinit(3), idn_result_tostring(3), idn.conf(5)
Search for    or go to Top of page |  Section 3 |  Main Index


--> IDN_COMPARENAMES (3) Sep 21, 2012

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.