4D v16.3
Substring
- 4D Language Reference
-
- String
-
- Character Reference Symbols
- 4D Transformation Tags
- Change string
- Char
- Character code
- CONVERT FROM TEXT
- Convert to text
- Delete string
- Get localized string
- GET TEXT KEYWORDS
- Insert string
- Length
- Lowercase
- Match regex
- Num
- Position
- Replace string
- String
- Substring
- Uppercase
- _o_Convert case
- _o_ISO to Mac
- _o_Mac to ISO
- _o_Mac to Win
- _o_Win to Mac
Substring
| Substring ( source ; firstChar {; numChars} ) -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| source | String |
|
String from which to get substring | |||||
| firstChar | Longint |
|
Position of first character | |||||
| numChars | Longint |
|
Number of characters to get | |||||
| Function result | String |
|
Substring of source | |||||
The Substring command returns the portion of source defined by firstChar and numChars.
The firstChar parameter points to the first character in the string to return, and numChars specifies how many characters to return.
If firstChar plus numChars is greater than the number of characters in the string, or if numChars is not specified, Substring returns the last character(s) in the string, starting with the character specified by firstChar. If firstChar is greater than the number of characters in the string, Substring returns an empty string ("").
Warning: When you use this command in a multi-style context, you need to convert any Window end-of-line characters ('\r\n') into single ('\r') characters in order for processing to be valid. This is due to the mechanism which normalizes 4D line endings to ensure multi-platform compatibility for texts. For more information, refer to Automatic normalization of line endings.
This example illustrates the use of Substring. The results, described in the comments, are assigned to the variable vsResult.
vsResult:=Substring("08/04/62";4;2) ` vsResult gets "04"
vsResult:=Substring("Emergency";1;6) ` vsResult gets "Emerge"
vsResult:=Substring(var;2) ` vsResult gets all characters except ` the firstThe following project method appends the paragraphs found in the text (passed as first parameter) to a string or text array (the pointer of which is passed as second parameter):
` EXTRACT PARAGRAPHS
` EXTRACT PARAGRAPHS ( text ; Pointer )
` EXTRACT PARAGRAPHS ( Text to parse ; -> Array of ¶s )
C_TEXT($1)
C_POINTER($2)
$vlElem:=Size of array($2->)
Repeat
$vlElem:=$vlElem+1
INSERT IN ARRAY($2->;$vlElem)
$vlPos:=Position(Char(Carriage return);$1)
If($vlPos>0)
$2->{$vlElem}:=Substring($1;1;$vlPos-1)
$1:=Substring($1;$vlPos+1)
Else
$2->{$vlElem}:=$1
End if
Until($1="")
Product: 4D
Theme: String
Number:
12
Created: < 4D v6
4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)
