Programmer Guide/Command Reference/LINELENGTH: Difference between revisions

From STX Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}} The <code>LINELENGTH</code> command returns the length of its arguments, all concatenated and separated by one space character from one another.
{{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>
  <var>var</var> := LINELENGTH <var>arg<sub>1</sub></var> ... <var>arg<sub>n</sub></var>


// returns 5 (3 arguments of 1 character each, plus 2
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":
// whitespace characters, one separating "a" from "b", the
// other separating "b" from "c"
  #a := linelength a b c
  #a := linelength a b c
 
// also returns 5 (3 arguments of 1 character each, plus 2
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":
// whitespace characters, one separating "a" from "b", the
// other separating "b" from "c"
  #a := linelength  a    b      c
  #a := linelength  a    b      c
 
// returns 5 - due to quoting, the first argument now is "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'
  #a := linelength 'a b c'
 
// returns 6 - there is exactly one quoted argument, and under
This returns 6 - there is exactly one quoted argument, and under quotes, each whitespace character counts:
// quotes, each whitespace character counts
  #a := linelength 'a  b c'
  #a := linelength 'a  b c'


Line 22: Line 19:


  // returns 5 (length of "hello")
  // returns 5 (length of "hello")
  #len := linelength hello world
  #len := length hello world
 
  // returns 11 (length of "hello", plus one delimiting character,
  // returns 11 (length of "hello", plus one delimiting character,
  // plus length of "world")
  // plus length of "world")
  #len := linelength hello 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

Navigation menu

Personal tools