STRING::LENGTH 1g 2023 laplante@plcb.ca GOWEB — Get String Length

title: “STRING::LENGTH” version: “1.0.0” date: 2023 author: “laplante@plcb.ca” section: “1g”

category: “GOWEB/STRING”

Name

string::length Get String Length

Synopsis

string::length(expression[, error: bool, byte: bool])
length(expression[, error: bool, byte: bool])

Description

The length function returns the length of a string.

• By default, it returns the length in characters.
• If the byte parameter is set to true, it returns the length in bytes.

Parameters

• byte (bool, optional) — If set to true, the function returns the length in bytes instead of characters.
• error (bool, optional) — Optional variable to capture an error if the input is invalid.

Examples

res={{
    length("Hello"); "\n";
    length("Héllo"); "\n";         // accented character counts as 1 char but 2 bytes
    length("Héllo", , true); "\n"; // length in bytes
}}.

Returns:

res=5
5
6

Author

laplante@plcb.ca

See Also

• string::isascii
  
• String functions
  
• Index
  

Version

• 1.0.0 — 2023 — Initial version