Middle (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / String functions

Middle and UNICODE
Miscellaneous

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Middle (Function)

In french: Milieu

Extracts:

a substring from a string starting at a specified position.
part of a buffer starting at a specified position.

Note: The same functionality can be obtained with operator [[]].

Example

// Extract characters
Middle("Eponine", 2, 3)   // Returns "pon"
Middle("Eponine", 2)    // Returns "ponine"
Middle("Eponine", 50)    // Returns ""
Middle("Eponine", 2, 50)   // Returns "ponine"
// Equivalent to 
// MyString is string = Eponine
// MyString = MyString[[2,50]]

MyString is string = "Antananarivo - Madagascar"
Middle(MyString, 10, 7)   // Returns "ivo - M"

// Extract bytes
MyBuffer is Buffer = "Antananarivo - Madagascar"
Middle(MyBuffer, 10, 7) // Returns "ivo - M"

Syntax

Extracting a substring from a string Hide the details

<Result> = Middle(<Initial string> , <Start position> [, <Length>])

<Result>: Character string

Part of <Initial string>.
Empty string ("") if <Start position> is greater than the length of <Initial string>.
EOT if <Start position> and/or <Length> are negative. A WLanguage error occurs (non-fatal error). To get more details on the error, use ErrorInfo.

<Initial string>: Character string

Character string containing the substring to extract. This string is not modified.

<Start position>: Integer

Position of the first character to extract.
If <Start position> is null, the extraction starts at the beginning of the string.

<Length>: Optional integer

Number of characters to extract.
If this parameter is not specified or is greater than the number of characters after <Start position>, the string is returned from <Start position>.

Extracting part of a buffer Hide the details

<Result> = Middle(<Initial buffer> , <Start position> [, <Size>])

<Result>: Character string

Part of <Initial buffer>.
Empty string ("") if <Start position> is greater than the length of <Initial buffer>.
EOT if <Start position> and/or <Size> are negative. A WLanguage error occurs (non-fatal error). To get more details on the error, use ErrorInfo.
Buffer invalid if <Buffer initial> contains a string in Unicode format.

<Initial buffer>: Buffer

Buffer containing the part to extract. This buffer is not modified.

<Start position>: Integer

Position of first byte to extract.
If <Start position> is null, the extraction starts at the beginning of the buffer.

<Size>: Optional integer

Number of bytes to extract.
If this parameter is not specified or is greater than the number of characters after <Start position>, the string is returned from <Start position>.

Remarks

Middle and UNICODE

If the string passed as a parameter is an ANSI string, the result will be an ANSI string.

If the string passed in parameter is in Unicode format, the result will be in Unicode format.

Reminder In Unicode, each character occupies two bytes of memory. The memory size of a Unicode string is therefore twice the number of characters actually contained in the string.

The fist character in the string is at index 1.

Note If the result on an ANSI string is assigned to a Unicode string (and vice versa), the conversion will be implicitly performed.

For more details, see Unicode management.

Miscellaneous

The same feature can be obtained with the [[]] operator.

Component: wd300vm.dll