Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
idn_comparenames(3)	    Library Functions Manual	     idn_comparenames(3)

NAME
     idn_comparenames,	idn_decodename2  - compare two internationzalized domain
     names

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_compare-
     names2().

	 IDN_COMPARE_REGIST
		Encode a domain name with IDNA2008 registration protocol, before
		comparison.  Currently, its value is the same as IDN_ENCODE_REG-
		IST.

	 IDN_COMPARE_LOOKUP
		Encode	a domain name with IDNA2008 lookup protocol, before com-
		parison.  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_re-
     sult_tostring(3), idn.conf(5)

				  Sep 21, 2012		     idn_comparenames(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=idn_comparenames2&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help