/*** *strxfrm.c - Transform a string using locale information * * Copyright (c) 1988-2001, Microsoft Corporation. All rights reserved. * *Purpose: * Transform a string using the locale information as set by * LC_COLLATE. * *Revision History: * 03-21-89 JCR Module created. * 06-20-89 JCR Removed _LOAD_DGROUP code * 02-27-90 GJF Fixed calling type, #include , fixed * copyright. * 10-02-90 GJF New-style function declarator. * 10-02-91 ETC Non-C locale support under _INTL switch. * 12-09-91 ETC Updated api; added multithread. * 12-18-91 ETC Don't convert output of LCMapString. * 08-18-92 KRS Activate NLS API. Fix behavior. * 09-02-92 SRW Get _INTL definition via ..\crt32.def * 12-11-92 SKS Need to handle count=0 in non-INTL code * 12-15-92 KRS Handle return value according to ANSI. * 01-18-93 CFW Removed unreferenced variable "dummy". * 03-10-93 CFW Remove UNDONE comment. * 04-06-93 SKS Replace _CRTAPI* with __cdecl * 09-15-93 CFW Use ANSI conformant "__" names. * 09-22-93 CFW Use __crtxxx internal NLS API wrapper. * 11-09-93 CFW Use LC_COLLATE code page for __crtxxx() conversion. * 09-06-94 CFW Remove _INTL switch. * 10-24-94 GJF Sped up C locale, multi-thread case. * 12-29-94 CFW Merge non-Win32. * 09-26-95 GJF New locking macro, and scheme, for functions which * reference the locale. * 10-11-95 BWT Fix NTSUBSET * 03-17-97 RDK Added error flag to __crtLCMapStringA. * 11-24-97 GJF Removed bogus codepage determination. * 01-12-98 GJF Use _lc_collate_cp codepage. * 07-16-98 GJF Revised multithread support based on threadlocinfo * struct. * 01-04-99 GJF Changes for 64-bit size_t. * 04-30-99 PML Minor cleanup as part of 64-bit merge. * 05-17-99 PML Remove all Macintosh support. * *******************************************************************************/ #include #include #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 _count 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 = result string * const char *_string2 = source string * size_t _count = max chars to move * * [If _count is 0, _string1 is permitted to be NULL.] * *Exit: * Length of the transformed string (not including the terminating * null). If the value returned is >= _count, the contents of the * _string1 array are indeterminate. * *Exceptions: * Non-standard: if OM/API error, return INT_MAX. * *******************************************************************************/ size_t __cdecl strxfrm ( char *_string1, const char *_string2, size_t _count ) { #ifdef _NTSUBSET_ if (_string1) strncpy(_string1, _string2, _count); return strlen(_string2); #else int dstlen; int retval = INT_MAX; /* NON-ANSI: default if OM or API error */ #ifdef _MT pthreadlocinfo ptloci; #endif if ( _count > INT_MAX ) return (size_t)retval; #ifdef _MT ptloci = _getptd()->ptlocinfo; if ( ptloci != __ptlocinfo ) ptloci = __updatetlocinfo(); if ( (ptloci->lc_handle[LC_COLLATE] == _CLOCALEHANDLE) && (ptloci->lc_collate_cp == _CLOCALECP) ) #else if ( (__lc_handle[LC_COLLATE] == _CLOCALEHANDLE) && (__lc_collate_cp == _CLOCALECP) ) #endif { strncpy(_string1, _string2, _count); return strlen(_string2); } /* Inquire size of dst string in BYTES */ #ifdef _MT if ( 0 == (dstlen = __crtLCMapStringA( ptloci->lc_handle[LC_COLLATE], #else if ( 0 == (dstlen = __crtLCMapStringA( __lc_handle[LC_COLLATE], #endif LCMAP_SORTKEY, _string2, -1, NULL, 0, #ifdef _MT ptloci->lc_collate_cp, #else __lc_collate_cp, #endif TRUE )) ) goto error_cleanup; retval = dstlen; /* if not enough room, return amount needed */ if ( dstlen > (int)_count ) goto error_cleanup; /* Map src string to dst string */ #ifdef _MT if ( 0 == __crtLCMapStringA( ptloci->lc_handle[LC_COLLATE], #else if ( 0 == __crtLCMapStringA( __lc_handle[LC_COLLATE], #endif LCMAP_SORTKEY, _string2, -1, _string1, (int)_count, #ifdef _MT ptloci->lc_collate_cp, #else __lc_collate_cp, #endif TRUE ) ) retval = INT_MAX; error_cleanup: return (size_t)retval; #endif /* _NTSUBSET_ */ }