1 | /* |
---|
2 | FUNCTION |
---|
3 | <<strxfrm_l>>---transform string |
---|
4 | |
---|
5 | INDEX |
---|
6 | strxfrm_l |
---|
7 | |
---|
8 | SYNOPSIS |
---|
9 | #include <string.h> |
---|
10 | size_t strxfrm_l(char *restrict <[s1]>, const char *restrict <[s2]>, |
---|
11 | size_t <[n]>, locale_t <[locale]>); |
---|
12 | |
---|
13 | DESCRIPTION |
---|
14 | This function transforms the string pointed to by <[s2]> and |
---|
15 | places the resulting string into the array pointed to by |
---|
16 | <[s1]>. The transformation is such that if the <<strcmp>> |
---|
17 | function is applied to the two transformed strings, it returns |
---|
18 | a value greater than, equal to, or less than zero, |
---|
19 | correspoinding to the result of a <<strcoll>> function applied |
---|
20 | to the same two original strings. |
---|
21 | |
---|
22 | No more than <[n]> characters are placed into the resulting |
---|
23 | array pointed to by <[s1]>, including the terminating null |
---|
24 | character. If <[n]> is zero, <[s1]> may be a null pointer. If |
---|
25 | copying takes place between objects that overlap, the behavior |
---|
26 | is undefined. |
---|
27 | |
---|
28 | (NOT Cygwin:) The current implementation of <<strxfrm_l>> simply copies |
---|
29 | the input and does not support any language-specific transformations. |
---|
30 | |
---|
31 | If <[locale]> is LC_GLOBAL_LOCALE or not a valid locale object, the |
---|
32 | behaviour is undefined. |
---|
33 | |
---|
34 | RETURNS |
---|
35 | The <<strxfrm_l>> function returns the length of the transformed string |
---|
36 | (not including the terminating null character). If the value returned |
---|
37 | is <[n]> or more, the contents of the array pointed to by |
---|
38 | <[s1]> are indeterminate. |
---|
39 | |
---|
40 | PORTABILITY |
---|
41 | <<strxfrm_l>> is POSIX-1.2008. |
---|
42 | |
---|
43 | <<strxfrm_l>> requires no supporting OS subroutines. |
---|
44 | |
---|
45 | QUICKREF |
---|
46 | strxfrm_l ansi pure |
---|
47 | */ |
---|
48 | |
---|
49 | #include <string.h> |
---|
50 | |
---|
51 | size_t |
---|
52 | strxfrm_l (char *__restrict s1, const char *__restrict s2, size_t n, |
---|
53 | struct __locale_t *locale) |
---|
54 | { |
---|
55 | size_t res; |
---|
56 | res = 0; |
---|
57 | while (n-- > 0) |
---|
58 | { |
---|
59 | if ((*s1++ = *s2++) != '\0') |
---|
60 | ++res; |
---|
61 | else |
---|
62 | return res; |
---|
63 | } |
---|
64 | while (*s2) |
---|
65 | { |
---|
66 | ++s2; |
---|
67 | ++res; |
---|
68 | } |
---|
69 | |
---|
70 | return res; |
---|
71 | } |
---|