mirror of
https://github.com/QB64-Phoenix-Edition/QB64pe.git
synced 2024-07-04 04:50:22 +00:00
aeb9c0668b
Note: Many files were removed (not yet existing/empty pages). The parser will try to download them on demand and will auto-generate text for missing pages (eg. most _gl pages).
47 lines
1.5 KiB
Plaintext
47 lines
1.5 KiB
Plaintext
{{QBDLDATE:05-20-2022}}
|
|
{{QBDLTIME:23:16:15}}
|
|
The '''RSET''' statement right-justifies a string according to length of the string expression.
|
|
|
|
|
|
{{PageSyntax}}
|
|
:: RSET string_variable = string_expression
|
|
|
|
|
|
|
|
* If the ''string_expression'' is longer than a fixed length string variable the value is truncated from the right side in [[LSET]] or RSET.
|
|
* If the ''string_expression'' is smaller than the fixed length, spaces will occupy the extra positions in the string.
|
|
* RSET can be used with a [[FIELD]] or [[TYPE]] string definition to set the buffer position before a [[PUT]].
|
|
|
|
|
|
''Example:''
|
|
{{CodeStart}}
|
|
{{Cl|CLS}}
|
|
{{Cl|DIM}} thestring {{Cl|AS}} {{Cl|STRING}} * 10
|
|
{{Cl|PRINT}} "12345678901234567890"
|
|
{{Cl|RSET}} thestring = "Hello!"
|
|
{{Cl|PRINT}} thestring
|
|
anystring$ = {{Cl|SPACE$}}(20)
|
|
{{Cl|RSET}} anystring$ = "Hello again!"
|
|
{{Cl|PRINT}} anystring$
|
|
{{Cl|RSET}} thestring = "Over ten characters long"
|
|
{{Cl|PRINT}} thestring
|
|
{{CodeEnd}}
|
|
{{OutputStart}}
|
|
12345678901234567890
|
|
Hello!
|
|
Hello Again!
|
|
Over ten c
|
|
{{OutputEnd}}
|
|
|
|
:''Explanation:'' Notice how "Hello!" ends at the tenth position because the length of ''thestring'' is 10. When we used SPACE$(20) the length of ''anystring$'' became 20 so "Hello Again!" ended at the 20th position. That is right-justified. The last line "Over ten c" is truncated as it didn't fit into ''thestring'''s length of only 10 characters.
|
|
|
|
|
|
''See also:''
|
|
* [[RTRIM$]], [[FIELD]]
|
|
* [[LSET]], [[LTRIM$]]
|
|
* [[PUT]], [[GET]]
|
|
|
|
|
|
{{PageNavigation}}
|
|
|