StrConv Function | |
-- todo --
Converts character expressions between single-byte, double-byte, UNICODE, and locale-specific representations.
Namespace:
XSharp.VFP
Assembly:
XSharp.VFP (in XSharp.VFP.dll) Version: 2.21
Syntax FUNCTION StrConv(
cExpression,
nConversionSetting,
nRegionalIdentifier,
nRegionalIDType
) AS STRING CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static string StrConv(
Usual cExpression = default,
Usual nConversionSetting = default,
Usual nRegionalIdentifier = default,
Usual nRegionalIDType = default
)
Request Example
View SourceParameters
- cExpression (Optional)
- Type: Usual
Specifies the character expression that STRCONV( ) converts.
- nConversionSetting (Optional)
- Type: Usual
Specifies the type of conversion.
The table in the remarks section lists the values of nConversionSetting and the type of conversion performed.
- nRegionalIdentifier (Optional)
- Type: Usual
Specifies the Locale ID, code page, or FontCharSet value to use for the conversion. If nRegionalIDType is omitted,
the Locale ID is used for the conversion. If nRegionalIdentifier is omitted, the system locale ID is used by default.
If nRegionalIdentifier is invalid or not supported on the machine, the error "Invalid locale ID" is generated.
- nRegionalIDType (Optional)
- Type: Usual
Specifies if a Locale ID, code page, or FontCharSet is used for the conversion.
The nRegionalIdentifier parameter, described above, is used to specify the actual Locale ID, code page,or FontCharSet used for the conversion.
Return Value
Type:
String
Character data type. STRCONV( ) returns the converted character expression.
Remarks nRegionalIdentifier | Language |
---|
1029 | Czech |
1031 | German |
1033 | English (Default) |
1034 | Spanish |
1036 | French |
1040 | Italian |
1045 | Polish |
1046 | Portuguese (Brazil) |
2070 | Portuguese (Portugal) |
nRegionalIDType | Description |
---|
0 | (Default) Specifies that the nRegionalIdentifier parameter is a Locale ID value. |
1 | Specifies that nRegionalIdentifier is a code page value. |
2 | Specifies that nRegionalIdentifier is a FontCharSet value. |
X# disregards invalid characters or incorrect length in base 64- and hexBinary- encoded strings.
This function is useful for manipulating double-byte character sets for languages such as Hiragana and Katakana.
nConversionSetting | Conversion |
---|
1 |
Converts single-byte characters in cExpression to double-byte characters.
Supported for Locale ID only (specified with the nRegionalIdentifier or nRegionalIDType parameters).
|
2 | Converts double-byte characters in cExpression to single-byte characters. |
3 | Converts double-byte Katakana characters in cExpression to double-byte Hiragana characters. |
4 | Converts double-byte Hiragana characters in cExpression to double-byte Katakana characters. |
5 | Converts double-byte characters to UNICODE (wide characters). |
6 | Converts UNICODE (wide characters) to double-byte characters. |
7 | Converts cExpression to locale-specific lowercase. |
8 | Converts cExpression to locale-specific uppercase. |
9 | Converts double-byte characters in cExpression to UTF-8 |
10 | Converts Unicode characters in cExpression to UTF-8 |
11 | Converts UTF-8 characters in cExpression to double-byte characters. |
12 | Converts UTF-8 characters in cExpression to UNICODE characters. |
13 | Converts single-byte characters in cExpression to encoded base64 binary. |
14 | Converts base64 encoded data in cExpression to original unencoded data. |
15 | Converts single-byte characters in cExpression to encoded hexBinary. |
16 | Converts single-byte characters in cExpression to decoded hexBinary. |
See Also