LengthToString (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

String management functions

Formatting according to the languages used

Constants for managing character strings

Functions for managing character strings

HTMLToRTF

HTMLToText

Handling Unicode in character strings

Handling character strings

MatchRegularExpression

NumToFinancialWritingChinese

Serialization constants

SystemIntegerToInteger

Formatting according to the languages used

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

LengthToString (Function)

In french: TailleVersChaîne

Converts a size in bytes to a string with human-readable units such as kilobytes, megabytes or terabytes. This function is used to format the result returned by fSize, FTPSize, etc.

Versions 15 and later

This function is now available for Android applications.

This function is now available for Java applications.

New in version 15

This function is now available for Android applications.

This function is now available for Java applications.

This function is now available for Android applications.

This function is now available for Java applications.

Versions 17 and later

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 21 and later

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

This function is now available in browser code.

New in version 21

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

This function is now available in browser code.

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

This function is now available in browser code.

Versions 26 and later

This function is now available for Apple Watch applications.

New in version 26

This function is now available for Apple Watch applications.

Example

nSize is int = 123596900
Info(LengthToString(nSize)) // Displays "117.87 MB"
Info(LengthToString(nSize, sizeKB)) // Displays "120700.10 KB"
Info(LengthToString(nSize, sizeGB)) // Displays "0.12 GB"

Syntax

<Result> = LengthToString(<Size to convert> [, <Display format>])

<Result>: Character string

Conversion result. This result has 2 digits after the decimal point.
Empty string ("") if an error occurred.

<Size to convert>: Integer

Size to convert (in bytes).

<Display format>: Optional Integer constant

By default, the string is returned in the most readable unit. The following constants are used to force the use of a specific unit:
sizeB Size converted to bytes.
sizeKB Size converted to kilobytes.
sizeMB Size converted to megabytes.
sizeGB Size converted to gigabytes.
sizeTB Size converted to terabytes.

Remarks

Formatting according to the languages used

The formatting of the result depends on the characteristics of the languages defined in the project description ("Language" tab). You can change the file size units and/or the decimal separator.

Business / UI classification: Neutral code

Component: wd260std.dll