		/*    locale.c
		 *
		 *    Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999,
		 *    2000, 2001, 2002, 2003, 2005, by Larry Wall and others
		 *
		 *    You may distribute under the terms of either the GNU General Public
		 *    License or the Artistic License, as specified in the README file.
		 *
		 */
		
		/*
		 * A Elbereth Gilthoniel,
		 * silivren penna míriel
		 * o menel aglar elenath!
		 * Na-chaered palan-díriel
		 * o galadhremmin ennorath,
		 * Fanuilos, le linnathon
		 * nef aear, si nef aearon!
		 */
		
		/* utility functions for handling locale-specific stuff like what
		 * character represents the decimal point.
		 */
		
		#include "EXTERN.h"
		#define PERL_IN_LOCALE_C
		#include "perl.h"
		
		#ifdef I_LOCALE
		#  include <locale.h>
		#endif
		
		#ifdef I_LANGINFO
		#   include <langinfo.h>
		#endif
		
		#include "reentr.h"
		
		#if defined(USE_LOCALE_NUMERIC) || defined(USE_LOCALE_COLLATE)
		/*
		 * Standardize the locale name from a string returned by 'setlocale'.
		 *
		 * The standard return value of setlocale() is either
		 * (1) "xx_YY" if the first argument of setlocale() is not LC_ALL
		 * (2) "xa_YY xb_YY ..." if the first argument of setlocale() is LC_ALL
		 *     (the space-separated values represent the various sublocales,
		 *      in some unspecificed order)
		 *
		 * In some platforms it has a form like "LC_SOMETHING=Lang_Country.866\n",
		 * which is harmful for further use of the string in setlocale().
		 *
		 */
		STATIC char *
		S_stdize_locale(pTHX_ char *locs)
       11508    {
       11508        const char *s = strchr(locs, '=');
       11508        bool okay = TRUE;
		
       11508        if (s) {
      ######    	const char * const t = strchr(s, '.');
      ######    	okay = FALSE;
      ######    	if (t) {
      ######    	    const char * const u = strchr(t, '\n');
      ######    	    if (u && (u[1] == 0)) {
      ######    		const STRLEN len = u - s;
      ######    		Move(s + 1, locs, len, char);
      ######    		locs[len] = 0;
      ######    		okay = TRUE;
			    }
			}
		    }
		
       11508        if (!okay)
      ######    	Perl_croak(aTHX_ "Can't fix broken locale name \"%s\"", locs);
		
       11508        return locs;
		}
		#endif
		
		void
		Perl_set_numeric_radix(pTHX)
       10004    {
		#ifdef USE_LOCALE_NUMERIC
		# ifdef HAS_LOCALECONV
       10004        struct lconv* lc;
		
       10004        lc = localeconv();
       10004        if (lc && lc->decimal_point) {
       10004    	if (lc->decimal_point[0] == '.' && lc->decimal_point[1] == 0) {
        7981    	    SvREFCNT_dec(PL_numeric_radix_sv);
        7981    	    PL_numeric_radix_sv = Nullsv;
			}
			else {
        2023    	    if (PL_numeric_radix_sv)
         810    		sv_setpv(PL_numeric_radix_sv, lc->decimal_point);
			    else
        1213    		PL_numeric_radix_sv = newSVpv(lc->decimal_point, 0);
			}
		    }
		    else
      ######    	PL_numeric_radix_sv = Nullsv;
		# endif /* HAS_LOCALECONV */
		#endif /* USE_LOCALE_NUMERIC */
		}
		
		/*
		 * Set up for a new numeric locale.
		 */
		void
		Perl_new_numeric(pTHX_ const char *newnum)
        6016    {
		#ifdef USE_LOCALE_NUMERIC
		
        6016        if (! newnum) {
      ######    	Safefree(PL_numeric_name);
      ######    	PL_numeric_name = NULL;
      ######    	PL_numeric_standard = TRUE;
      ######    	PL_numeric_local = TRUE;
      ######    	return;
		    }
		
        6016        if (! PL_numeric_name || strNE(PL_numeric_name, newnum)) {
        6004    	Safefree(PL_numeric_name);
        6004    	PL_numeric_name = stdize_locale(savepv(newnum));
        6004    	PL_numeric_standard = ((*newnum == 'C' && newnum[1] == '\0')
					       || strEQ(newnum, "POSIX"));
        6004    	PL_numeric_local = TRUE;
        6004    	set_numeric_radix();
		    }
		
		#endif /* USE_LOCALE_NUMERIC */
		}
		
		void
		Perl_set_numeric_standard(pTHX)
        6536    {
		#ifdef USE_LOCALE_NUMERIC
		
        6536        if (! PL_numeric_standard) {
        2000    	setlocale(LC_NUMERIC, "C");
        2000    	PL_numeric_standard = TRUE;
        2000    	PL_numeric_local = FALSE;
        2000    	set_numeric_radix();
		    }
		
		#endif /* USE_LOCALE_NUMERIC */
		}
		
		void
		Perl_set_numeric_local(pTHX)
        2031    {
		#ifdef USE_LOCALE_NUMERIC
		
        2031        if (! PL_numeric_local) {
        2000    	setlocale(LC_NUMERIC, PL_numeric_name);
        2000    	PL_numeric_standard = FALSE;
        2000    	PL_numeric_local = TRUE;
        2000    	set_numeric_radix();
		    }
		
		#endif /* USE_LOCALE_NUMERIC */
		}
		
		/*
		 * Set up for a new ctype locale.
		 */
		void
		Perl_new_ctype(pTHX_ const char *newctype)
        5514    {
		#ifdef USE_LOCALE_CTYPE
		    dVAR;
        5514        int i;
		
     1417098        for (i = 0; i < 256; i++) {
     1411584    	if (isUPPER_LC(i))
      161812    	    PL_fold_locale[i] = toLOWER_LC(i);
     1249772    	else if (isLOWER_LC(i))
      163276    	    PL_fold_locale[i] = toUPPER_LC(i);
			else
     1086496    	    PL_fold_locale[i] = i;
		    }
		
		#endif /* USE_LOCALE_CTYPE */
        5514        PERL_UNUSED_ARG(newctype);
		}
		
		/*
		 * Set up for a new collation locale.
		 */
		void
		Perl_new_collate(pTHX_ const char *newcoll)
        5514    {
		#ifdef USE_LOCALE_COLLATE
		
        5514        if (! newcoll) {
      ######    	if (PL_collation_name) {
      ######    	    ++PL_collation_ix;
      ######    	    Safefree(PL_collation_name);
      ######    	    PL_collation_name = NULL;
			}
      ######    	PL_collation_standard = TRUE;
      ######    	PL_collxfrm_base = 0;
      ######    	PL_collxfrm_mult = 2;
      ######    	return;
		    }
		
        5514        if (! PL_collation_name || strNE(PL_collation_name, newcoll)) {
        5504    	++PL_collation_ix;
        5504    	Safefree(PL_collation_name);
        5504    	PL_collation_name = stdize_locale(savepv(newcoll));
        5504    	PL_collation_standard = ((*newcoll == 'C' && newcoll[1] == '\0')
						 || strEQ(newcoll, "POSIX"));
		
			{
			  /*  2: at most so many chars ('a', 'b'). */
			  /* 50: surely no system expands a char more. */
		#define XFRMBUFSIZE  (2 * 50)
        5504    	  char xbuf[XFRMBUFSIZE];
        5504    	  const Size_t fa = strxfrm(xbuf, "a",  XFRMBUFSIZE);
        5504    	  const Size_t fb = strxfrm(xbuf, "ab", XFRMBUFSIZE);
        5504    	  const SSize_t mult = fb - fa;
        5504    	  if (mult < 1)
      ######    	      Perl_croak(aTHX_ "strxfrm() gets absurd");
        5504    	  PL_collxfrm_base = (fa > (Size_t)mult) ? (fa - mult) : 0;
        5504    	  PL_collxfrm_mult = mult;
			}
		    }
		
		#endif /* USE_LOCALE_COLLATE */
		}
		
		/*
		 * Initialize locale awareness.
		 */
		int
		Perl_init_i18nl10n(pTHX_ int printwarn)
        4503    {
        4503        int ok = 1;
		    /* returns
		     *    1 = set ok or not applicable,
		     *    0 = fallback to C locale,
		     *   -1 = fallback to C locale failed
		     */
		
		#if defined(USE_LOCALE)
		
		#ifdef USE_LOCALE_CTYPE
        4503        char *curctype   = NULL;
		#endif /* USE_LOCALE_CTYPE */
		#ifdef USE_LOCALE_COLLATE
        4503        char *curcoll    = NULL;
		#endif /* USE_LOCALE_COLLATE */
		#ifdef USE_LOCALE_NUMERIC
        4503        char *curnum     = NULL;
		#endif /* USE_LOCALE_NUMERIC */
		#ifdef __GLIBC__
        4503        char *language   = PerlEnv_getenv("LANGUAGE");
		#endif
        4503        char *lc_all     = PerlEnv_getenv("LC_ALL");
        4503        char *lang       = PerlEnv_getenv("LANG");
        4503        bool setlocale_failure = FALSE;
		
		#ifdef LOCALE_ENVIRON_REQUIRED
		
		    /*
		     * Ultrix setlocale(..., "") fails if there are no environment
		     * variables from which to get a locale name.
		     */
		
		    bool done = FALSE;
		
		#ifdef LC_ALL
		    if (lang) {
			if (setlocale(LC_ALL, ""))
			    done = TRUE;
			else
			    setlocale_failure = TRUE;
		    }
		    if (!setlocale_failure) {
		#ifdef USE_LOCALE_CTYPE
			if (! (curctype =
			       setlocale(LC_CTYPE,
					 (!done && (lang || PerlEnv_getenv("LC_CTYPE")))
						    ? "" : Nullch)))
			    setlocale_failure = TRUE;
			else
			    curctype = savepv(curctype);
		#endif /* USE_LOCALE_CTYPE */
		#ifdef USE_LOCALE_COLLATE
			if (! (curcoll =
			       setlocale(LC_COLLATE,
					 (!done && (lang || PerlEnv_getenv("LC_COLLATE")))
						   ? "" : Nullch)))
			    setlocale_failure = TRUE;
			else
			    curcoll = savepv(curcoll);
		#endif /* USE_LOCALE_COLLATE */
		#ifdef USE_LOCALE_NUMERIC
			if (! (curnum =
			       setlocale(LC_NUMERIC,
					 (!done && (lang || PerlEnv_getenv("LC_NUMERIC")))
						  ? "" : Nullch)))
			    setlocale_failure = TRUE;
			else
			    curnum = savepv(curnum);
		#endif /* USE_LOCALE_NUMERIC */
		    }
		
		#endif /* LC_ALL */
		
		#endif /* !LOCALE_ENVIRON_REQUIRED */
		
		#ifdef LC_ALL
        4503        if (! setlocale(LC_ALL, ""))
      ######    	setlocale_failure = TRUE;
		#endif /* LC_ALL */
		
        4503        if (!setlocale_failure) {
		#ifdef USE_LOCALE_CTYPE
        4503    	if (! (curctype = setlocale(LC_CTYPE, "")))
      ######    	    setlocale_failure = TRUE;
			else
        4503    	    curctype = savepv(curctype);
		#endif /* USE_LOCALE_CTYPE */
		#ifdef USE_LOCALE_COLLATE
        4503    	if (! (curcoll = setlocale(LC_COLLATE, "")))
      ######    	    setlocale_failure = TRUE;
			else
        4503    	    curcoll = savepv(curcoll);
		#endif /* USE_LOCALE_COLLATE */
		#ifdef USE_LOCALE_NUMERIC
        4503    	if (! (curnum = setlocale(LC_NUMERIC, "")))
      ######    	    setlocale_failure = TRUE;
			else
        4503    	    curnum = savepv(curnum);
		#endif /* USE_LOCALE_NUMERIC */
		    }
		
        4503        if (setlocale_failure) {
      ######    	char *p;
      ######    	bool locwarn = (printwarn > 1 ||
					(printwarn &&
      ######    			 (!(p = PerlEnv_getenv("PERL_BADLANG")) || atoi(p))));
		
      ######    	if (locwarn) {
		#ifdef LC_ALL
		
      ######    	    PerlIO_printf(Perl_error_log,
			       "perl: warning: Setting locale failed.\n");
		
		#else /* !LC_ALL */
		
			    PerlIO_printf(Perl_error_log,
			       "perl: warning: Setting locale failed for the categories:\n\t");
		#ifdef USE_LOCALE_CTYPE
			    if (! curctype)
				PerlIO_printf(Perl_error_log, "LC_CTYPE ");
		#endif /* USE_LOCALE_CTYPE */
		#ifdef USE_LOCALE_COLLATE
			    if (! curcoll)
				PerlIO_printf(Perl_error_log, "LC_COLLATE ");
		#endif /* USE_LOCALE_COLLATE */
		#ifdef USE_LOCALE_NUMERIC
			    if (! curnum)
				PerlIO_printf(Perl_error_log, "LC_NUMERIC ");
		#endif /* USE_LOCALE_NUMERIC */
			    PerlIO_printf(Perl_error_log, "\n");
		
		#endif /* LC_ALL */
		
      ######    	    PerlIO_printf(Perl_error_log,
				"perl: warning: Please check that your locale settings:\n");
		
		#ifdef __GLIBC__
      ######    	    PerlIO_printf(Perl_error_log,
					  "\tLANGUAGE = %c%s%c,\n",
					  language ? '"' : '(',
					  language ? language : "unset",
					  language ? '"' : ')');
		#endif
		
      ######    	    PerlIO_printf(Perl_error_log,
					  "\tLC_ALL = %c%s%c,\n",
					  lc_all ? '"' : '(',
					  lc_all ? lc_all : "unset",
					  lc_all ? '"' : ')');
		
		#if defined(USE_ENVIRON_ARRAY)
			    {
      ######    	      char **e;
      ######    	      for (e = environ; *e; e++) {
      ######    		  if (strnEQ(*e, "LC_", 3)
					&& strnNE(*e, "LC_ALL=", 7)
					&& (p = strchr(*e, '=')))
      ######    		      PerlIO_printf(Perl_error_log, "\t%.*s = \"%s\",\n",
						    (int)(p - *e), *e, p + 1);
			      }
			    }
		#else
			    PerlIO_printf(Perl_error_log,
					  "\t(possibly more locale environment variables)\n");
		#endif
		
      ######    	    PerlIO_printf(Perl_error_log,
					  "\tLANG = %c%s%c\n",
					  lang ? '"' : '(',
					  lang ? lang : "unset",
					  lang ? '"' : ')');
		
      ######    	    PerlIO_printf(Perl_error_log,
					  "    are supported and installed on your system.\n");
			}
		
		#ifdef LC_ALL
		
      ######    	if (setlocale(LC_ALL, "C")) {
      ######    	    if (locwarn)
      ######    		PerlIO_printf(Perl_error_log,
		      "perl: warning: Falling back to the standard locale (\"C\").\n");
      ######    	    ok = 0;
			}
			else {
      ######    	    if (locwarn)
      ######    		PerlIO_printf(Perl_error_log,
		      "perl: warning: Failed to fall back to the standard locale (\"C\").\n");
      ######    	    ok = -1;
			}
		
		#else /* ! LC_ALL */
		
			if (0
		#ifdef USE_LOCALE_CTYPE
			    || !(curctype || setlocale(LC_CTYPE, "C"))
		#endif /* USE_LOCALE_CTYPE */
		#ifdef USE_LOCALE_COLLATE
			    || !(curcoll || setlocale(LC_COLLATE, "C"))
		#endif /* USE_LOCALE_COLLATE */
		#ifdef USE_LOCALE_NUMERIC
			    || !(curnum || setlocale(LC_NUMERIC, "C"))
		#endif /* USE_LOCALE_NUMERIC */
			    )
			{
			    if (locwarn)
				PerlIO_printf(Perl_error_log,
		      "perl: warning: Cannot fall back to the standard locale (\"C\").\n");
			    ok = -1;
			}
		
		#endif /* ! LC_ALL */
		
		#ifdef USE_LOCALE_CTYPE
      ######    	curctype = savepv(setlocale(LC_CTYPE, Nullch));
		#endif /* USE_LOCALE_CTYPE */
		#ifdef USE_LOCALE_COLLATE
      ######    	curcoll = savepv(setlocale(LC_COLLATE, Nullch));
		#endif /* USE_LOCALE_COLLATE */
		#ifdef USE_LOCALE_NUMERIC
      ######    	curnum = savepv(setlocale(LC_NUMERIC, Nullch));
		#endif /* USE_LOCALE_NUMERIC */
		    }
		    else {
		
		#ifdef USE_LOCALE_CTYPE
        4503        new_ctype(curctype);
		#endif /* USE_LOCALE_CTYPE */
		
		#ifdef USE_LOCALE_COLLATE
        4503        new_collate(curcoll);
		#endif /* USE_LOCALE_COLLATE */
		
		#ifdef USE_LOCALE_NUMERIC
        4503        new_numeric(curnum);
		#endif /* USE_LOCALE_NUMERIC */
		
		    }
		
		#endif /* USE_LOCALE */
		
		#ifdef USE_PERLIO
		    {
		      /* Set PL_utf8locale to TRUE if using PerlIO _and_
			 any of the following are true:
			 - nl_langinfo(CODESET) contains /^utf-?8/i
			 - $ENV{LC_ALL}   contains /^utf-?8/i
			 - $ENV{LC_CTYPE} contains /^utf-?8/i
			 - $ENV{LANG}     contains /^utf-?8/i
			 The LC_ALL, LC_CTYPE, LANG obey the usual override
			 hierarchy of locale environment variables.  (LANGUAGE
			 affects only LC_MESSAGES only under glibc.) (If present,
			 it overrides LC_MESSAGES for GNU gettext, and it also
			 can have more than one locale, separated by spaces,
			 in case you need to know.)
			 If PL_utf8locale and PL_unicode (set by -C or by $ENV{PERL_UNICODE})
		         are true, perl.c:S_parse_body() will turn on the PerlIO :utf8 layer
			 on STDIN, STDOUT, STDERR, _and_ the default open discipline.
		      */
        4503    	 bool utf8locale = FALSE;
        4503    	 char *codeset = NULL;
		#if defined(HAS_NL_LANGINFO) && defined(CODESET)
        4503    	 codeset = nl_langinfo(CODESET);
		#endif
        4503    	 if (codeset)
        4503    	      utf8locale = (ibcmp(codeset,  "UTF-8", 5) == 0 ||
		 			    ibcmp(codeset,  "UTF8",  4) == 0);
		#if defined(USE_LOCALE)
			 else { /* nl_langinfo(CODESET) is supposed to correctly
				 * interpret the locale environment variables,
				 * but just in case it fails, let's do this manually. */ 
      ######    	      if (lang)
      ######    		   utf8locale = (ibcmp(lang,     "UTF-8", 5) == 0 ||
					         ibcmp(lang,     "UTF8",  4) == 0);
		#ifdef USE_LOCALE_CTYPE
      ######    	      if (curctype)
      ######    		   utf8locale = (ibcmp(curctype,     "UTF-8", 5) == 0 ||
					         ibcmp(curctype,     "UTF8",  4) == 0);
		#endif
      ######    	      if (lc_all)
      ######    		   utf8locale = (ibcmp(lc_all,   "UTF-8", 5) == 0 ||
					         ibcmp(lc_all,   "UTF8",  4) == 0);
			 }
		#endif /* USE_LOCALE */
        4503    	 if (utf8locale)
      ######    	      PL_utf8locale = TRUE;
		    }
		    /* Set PL_unicode to $ENV{PERL_UNICODE} if using PerlIO.
		       This is an alternative to using the -C command line switch
		       (the -C if present will override this). */
		    {
        4503    	 const char *p = PerlEnv_getenv("PERL_UNICODE");
        4503    	 PL_unicode = p ? parse_unicode_opts(&p) : 0;
		    }
		#endif
		
		#ifdef USE_LOCALE_CTYPE
        4503        Safefree(curctype);
		#endif /* USE_LOCALE_CTYPE */
		#ifdef USE_LOCALE_COLLATE
        4503        Safefree(curcoll);
		#endif /* USE_LOCALE_COLLATE */
		#ifdef USE_LOCALE_NUMERIC
        4503        Safefree(curnum);
		#endif /* USE_LOCALE_NUMERIC */
        4503        return ok;
		}
		
		/* Backwards compatibility. */
		int
		Perl_init_i18nl14n(pTHX_ int printwarn)
      ######    {
      ######        return init_i18nl10n(printwarn);
		}
		
		#ifdef USE_LOCALE_COLLATE
		
		/*
		 * mem_collxfrm() is a bit like strxfrm() but with two important
		 * differences. First, it handles embedded NULs. Second, it allocates
		 * a bit more memory than needed for the transformed data itself.
		 * The real transformed data begins at offset sizeof(collationix).
		 * Please see sv_collxfrm() to see how this is used.
		 */
		
		char *
		Perl_mem_collxfrm(pTHX_ const char *s, STRLEN len, STRLEN *xlen)
      569651    {
      569651        char *xbuf;
      569651        STRLEN xAlloc, xin, xout; /* xalloc is a reserved word in VC */
		
		    /* the first sizeof(collationix) bytes are used by sv_collxfrm(). */
		    /* the +1 is for the terminating NUL. */
		
      569651        xAlloc = sizeof(PL_collation_ix) + PL_collxfrm_base + (PL_collxfrm_mult * len) + 1;
      569651        New(171, xbuf, xAlloc, char);
      569651        if (! xbuf)
      ######    	goto bad;
		
      569651        *(U32*)xbuf = PL_collation_ix;
      569651        xout = sizeof(PL_collation_ix);
     1139302        for (xin = 0; xin < len; ) {
     1106000    	SSize_t xused;
		
     1675651    	for (;;) {
     1106000    	    xused = strxfrm(xbuf + xout, s + xin, xAlloc - xout);
     1106000    	    if (xused == -1)
      ######    		goto bad;
     1106000    	    if ((STRLEN)xused < xAlloc - xout)
      569651    		break;
      536349    	    xAlloc = (2 * xAlloc) + 1;
      536349    	    Renew(xbuf, xAlloc, char);
      536349    	    if (! xbuf)
      ######    		goto bad;
			}
		
      569651    	xin += strlen(s + xin) + 1;
      569651    	xout += xused;
		
			/* Embedded NULs are understood but silently skipped
			 * because they make no sense in locale collation. */
		    }
		
      569651        xbuf[xout] = '\0';
      569651        *xlen = xout - sizeof(PL_collation_ix);
      569651        return xbuf;
		
		  bad:
      ######        Safefree(xbuf);
      ######        *xlen = 0;
      ######        return NULL;
		}
		
		#endif /* USE_LOCALE_COLLATE */
		
		/*
		 * Local variables:
		 * c-indentation-style: bsd
		 * c-basic-offset: 4
		 * indent-tabs-mode: t
		 * End:
		 *
		 * ex: set ts=8 sts=4 sw=4 noet:
		 */
