Truncate (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

String management functions

Character string management functions

CommonLength

Complete

CompleteDir

Constants for managing character strings

Handling Unicode in character strings

Handling character strings

MatchRegularExpression

NumToFinancialWritingChinese

Serialization constants

StringDeleteDuplicate

SystemIntegerToInteger

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Truncate (Function)

In french: Tronque

Truncates the right part of a string or buffer. You can specify:

the number of characters of the truncated string.
the number of characters to be removed.

Versions 21 and later

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

This function is now available in Apple Watch mode.

This function is now available in Universal Windows 10 App mode.

Versions 25 and later

This function is now available in browser code.

New in version 25

This function is now available in browser code.

Example

sString is string = " Turlututu"

// Truncate the string to 9 characters
Trace(Truncate(sString, 9)) // Displays " Turlutut"
Trace(Truncate(sString, 9, numberOfCharactersToStore)) // Displays " Turlutut"

// Truncate the string to 4 characters
Trace(Truncate(sString, 4, numberOfCharactersToDelete))
// Displays " Turlu"

Syntax

<Result> = Truncate(<Source> , <Number of characters> [, <Truncate method>])

<Result>: Character string

Truncated string.
EOT if <Number of characters> is negative. A WLanguage error occurs (non-fatal error). To get the details of the error, use ErrorInfo.

<Source>: Character string or Buffer

Element to use: String or buffer. This element is not modified.

<Number of characters>: Integer

Corresponds to:
the number of characters that must be kept in the <Result> string (if the numberOfCharactersToStore constant is used).
the number of characters or bytes that must be removed from <Source> (if the numberOfCharactersToDelete constant is used).

<Truncate method>: Optional Boolean constant

Truncate method to use:
Versions 18 and later
numberOfCharactersToStore
(Default value)
New in version 18
numberOfCharactersToStore
(Default value)
numberOfCharactersToStore
(Default value) <Number of characters> corresponds to the number of characters that must be kept in the <Result> string.
Versions 18 and later
numberOfCharactersToDelete
New in version 18
numberOfCharactersToDelete
numberOfCharactersToDelete <Number of characters> corresponds to the number of characters that must be removed from <Source>.

Business / UI classification: Neutral code

Component: wd270vm.dll