Programmer Guide/Command Reference/LINELENGTH: Difference between revisions
From STX Wiki
Jump to navigationJump to search
(initial import) |
No edit summary |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
{{PG_StringCommands}} | |||
The <code>LINELENGTH</code> command returns the length of its arguments, all concatenated and separated by one space character from one another. | |||
<var>var</var> := LINELENGTH <var>arg<sub>1</sub></var> ... <var>arg<sub>n</sub></var> | |||
The following example returns 5 (3 arguments of 1 character each, plus 2 whitespace characters, one separating "a" from "b", the other separating "b" from "c": | |||
#a := linelength a b c | |||
This also returns 5 (3 arguments of 1 character each, plus 2 whitespace characters, one separating "a" from "b", the other separating "b" from "c": | |||
#a := linelength a b c | |||
This also also returns 5 - due to quoting, there is only one argument with the value of "a b c" | |||
#a := linelength 'a b c' | |||
This returns 6 - there is exactly one quoted argument, and under quotes, each whitespace character counts: | |||
#a := linelength 'a b c' | |||
< | Compare this with the <code>[[Programmer_Guide/Command_Reference/LENGTH|LENGTH]]</code> command returning the length of its first argument only: | ||
#len := length hello world | |||
// | // returns 5 (length of "hello") | ||
#len := linelength hello world | #len := length hello world | ||
// returns 11 (length of "hello", plus one delimiting character, | |||
// plus length of "world") | |||
#len := linelength hello world | |||
Latest revision as of 10:25, 4 March 2016
The LINELENGTH command returns the length of its arguments, all concatenated and separated by one space character from one another.
var := LINELENGTH arg1 ... argn
The following example returns 5 (3 arguments of 1 character each, plus 2 whitespace characters, one separating "a" from "b", the other separating "b" from "c":
#a := linelength a b c
This also returns 5 (3 arguments of 1 character each, plus 2 whitespace characters, one separating "a" from "b", the other separating "b" from "c":
#a := linelength a b c
This also also returns 5 - due to quoting, there is only one argument with the value of "a b c"
#a := linelength 'a b c'
This returns 6 - there is exactly one quoted argument, and under quotes, each whitespace character counts:
#a := linelength 'a b c'
Compare this with the LENGTH command returning the length of its first argument only:
// returns 5 (length of "hello") #len := length hello world // returns 11 (length of "hello", plus one delimiting character, // plus length of "world") #len := linelength hello world
