Difference between revisions of "SPACE$"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>Stylin
(updated to new blueprint, added descriptions and example)
Line 1: Line 1:
The '''SPACE$''' function is used to insert a specified [[INTEGER]] number of spaces into a [[STRING]] value or variable.
+
The {{KW|SPACE$}} function returns a {{KW|STRING}} consisting of a number of space characters.
  
  
 
+
{{PageSyntax}}
::::::''Syntax:'' SPACE$(number_of_spaces%)
+
:<code>''result$'' = {{KW|SPACE$}}( {{Parameter|count%}} )</code>
 
 
  
  
 +
{{PageDescription}}
 +
<!-- Stylin -->
 +
* {{Parameter|count%}} is the number of space characters to repeat.
 +
* If {{Parameter|count%}} is negative, an [[ERROR Codes|illegal function call]] error is thrown.
 +
<!-- /Stylin -->
 
* Can be used in any string value using the + concatenation operator.
 
* Can be used in any string value using the + concatenation operator.
 
* Semicolons or + can be used in a screen [[PRINT]] or [[PRINT (file statement)]].
 
* Semicolons or + can be used in a screen [[PRINT]] or [[PRINT (file statement)]].
Line 12: Line 16:
  
  
 +
{{PageExamples}}
 +
{{CodeStart}}{{Cl|FOR...NEXT|FOR}} count% = 0 {{Cl|FOR...NEXT|TO}} 3
 +
    {{Cl|PRINT}} "abc" + {{Cl|SPACE$}}( count% ) + "def"
 +
{{Cl|FOR...NEXT|NEXT}} count%
 +
{{CodeEnd}}
 +
{{OutputStart}}abcdef
 +
abc def
 +
abc  def
 +
abc  def
 +
{{OutputEnd}}
  
  
''See also:'' [[STRING$]], [[SPC]], [[TAB]]
+
{{PageSeeAlso}}
 
+
* {{KW|STRING$}}
 
+
* {{KW|SPC}}, {{KW|TAB}}
 
 
 
 
==Navigation:==
 
  
[[Keyword_Reference_-_Alphabetical|Go to Keyword Reference - Alphabetical]]
 
  
[[Keyword Reference - By usage|Go to Keyword Reference - By usage]]
+
{{PageNavigation}}

Revision as of 21:04, 28 February 2010

The SPACE$ function returns a STRING consisting of a number of space characters.


Syntax

result$ = SPACE$( count% )


Description

  • count% is the number of space characters to repeat.
  • If count% is negative, an illegal function call error is thrown.
  • Can be used in any string value using the + concatenation operator.
  • Semicolons or + can be used in a screen PRINT or PRINT (file statement).
  • Spaces are often used to erase previous text PRINTs from the screen.


Examples

FOR count% = 0 TO 3 PRINT "abc" + SPACE$( count% ) + "def" NEXT count%

abcdef abc def abc def abc def


See also



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page