strxfrm
- Updated2023-02-21
- 2 minute(s) read
strxfrm
size_t strxfrm (char targetString[], const char sourceString[], size_t maxChars);
Purpose
Transforms the specified number of characters, including the terminating ASNII NUL byte, from a source string to a target string. If copying takes place between two objects that overlap, the behavior is undefined. If maxChars is zero, the source string is permitted to be a NULL pointer.
 |
Note The transformation is such that if the strcmp function is applied to two transformed strings, it returns a value greater than, equal to, or less than zero corresponding to the result of the strcoll function applied to the same two original strings. |
Parameters
| Input | ||
| Name | Type | Description |
| sourceString | const char [] | Contains a pointer to the NUL-terminated source string from which a specified amount of characters is transformed and copied into the target string. |
| maxChars | size_t | Specifies the maximum number of characters that are copied from the source string into the target string. If the value entered into this parameter is zero, the source string is permitted to be a NULL pointer. |
| Output | ||
| Name | Type | Description |
| targetString | char [] | Contains the target string to which the specified number of characters from the source string is transformed and copied. |
Return Value
| Name | Type | Description |
| transformedLength | size_t | Contains the length of the source string, not including the terminating ASCII NUL byte. |
Additional Information
Library: ANSI C Library
Include file: ansi_c.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later