/*** *xstrxfrm.c - Transform a string using locale information * * Copyright (c) Microsoft Corporation. All rights reserved. * *Purpose: * Transform a string using the locale information as set by * LC_COLLATE. * *******************************************************************************/ #include #include #include /* for _Collvec */ #include #include #include #include #include #include #include #include /*** *size_t _Strxfrm() - Transform a string using locale information * *Purpose: * Transform the string pointer to by _string2 and place the * resulting string into the array pointer to by _string1. * No more than _end1 - _string1 characters are place into the * resulting string (including the null). * * The transformation is such that if strcmp() is applied to * the two transformed strings, the return value is equal to * the result of strcoll() applied to the two original strings. * Thus, the conversion must take the locale LC_COLLATE info * into account. * [ANSI] * * The value of the following expression is the size of the array * needed to hold the transformation of the source string: * * 1 + strxfrm(NULL,string,0) * * NOTE: Currently, the C libraries support the "C" locale only. * Thus, _Strxfrm() simply resolves to strncpy()/strlen(). * *Entry: * char *_string1 = pointer to beginning of result string * char *_end1 = pointer past end of result string * const char *_string2 = pointer to beginning of source string * const char *_end2 = pointer past end of source string * const _Collvec *ploc = pointer to locale info * *Exit: * Length of the transformed string. * If the value returned is too big, the contents of the * _string1 array are indeterminate. * *Exceptions: * Non-standard: if OM/API error, return INT_MAX. * *******************************************************************************/ _CRTIMP2_PURE size_t __CLRCALL_PURE_OR_CDECL _Strxfrm ( char *_string1, char *_end1, const char *_string2, const char *_end2, const _Collvec *ploc ) { size_t _n1 = _end1 - _string1; size_t _n2 = _end2 - _string2; int dstlen; size_t retval = (size_t)-1; /* NON-ANSI: default if OM or API error */ UINT codepage; const wchar_t *locale_name; if (ploc == 0) { locale_name = ___lc_locale_name_func()[LC_COLLATE]; codepage = ___lc_collate_cp_func(); } else { locale_name = ploc->_LocaleName; codepage = ploc->_Page; } if ((locale_name == NULL) && (codepage == _CLOCALECP)) { if (_n2 <= _n1) { memcpy(_string1, _string2, _n2); } retval=_n2; } else { /* Inquire size of dst string in BYTES */ if (0 != (dstlen = __crtLCMapStringA(NULL, locale_name, LCMAP_SORTKEY, _string2, (int)_n2, NULL, 0, codepage, TRUE))) { retval = dstlen; /* if not enough room, return amount needed */ if (dstlen <= (int)(_n1)) { /* Map src string to dst string */ __crtLCMapStringA(NULL, locale_name, LCMAP_SORTKEY, _string2, (int)_n2, _string1, (int)_n1, codepage, TRUE); } } } return (size_t)retval; }