Module:StringBuilder/doc: Difference between revisions

no edit summary
(Created page with "== `StringBuilder` Module Documentation == The `StringBuilder` module provides functionality to efficiently build and manipulate strings in Lua. === Constructor === '''`StringBuilder.new()`''' Creates a new `StringBuilder` object. * '''Returns:''' `StringBuilder` object. === Methods === '''`StringBuilder:append(...)`''' Appends strings or values to the `StringBuilder` buffer. * '''Parameters:''' * `...`: One or more values to append to the buffer. '''`StringB...")
 
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
== `StringBuilder` Module Documentation ==
== StringBuilder Module Documentation ==


The `StringBuilder` module provides functionality to efficiently build and manipulate strings in Lua.
The `StringBuilder` module provides functionality to efficiently build and manipulate strings in Lua.
Line 5: Line 5:
=== Constructor ===
=== Constructor ===


'''`StringBuilder.new()`'''
====StringBuilder.new()====


Creates a new `StringBuilder` object.
Creates a new `StringBuilder` object.
Line 13: Line 13:
=== Methods ===
=== Methods ===


'''`StringBuilder:append(...)`'''
====StringBuilder:append(...)====


Appends strings or values to the `StringBuilder` buffer.
Appends strings or values to the `StringBuilder` buffer.
Line 20: Line 20:
   * `...`: One or more values to append to the buffer.
   * `...`: One or more values to append to the buffer.


'''`StringBuilder:toString()`'''
====StringBuilder:appendLine(...)====
 
Appends strings or values followed by a newline (`\n`) to the `StringBuilder` buffer.
 
* '''Parameters:'''
  * `...`: One or more values to append to the buffer.
 
====StringBuilder:clear()====
 
Clears the contents of the `StringBuilder` buffer.
 
* '''Usage:''' Call this method to reset the `StringBuilder` buffer to an empty state.
 
====StringBuilder:toString()====


Converts the `StringBuilder` buffer into a concatenated string.
Converts the `StringBuilder` buffer into a concatenated string.
Line 27: Line 40:


=== Example Usage ===
=== Example Usage ===
To use the `StringBuilder` module in your Lua scripts, follow these examples:


<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 36: Line 51:
-- Append strings and values to the StringBuilder buffer
-- Append strings and values to the StringBuilder buffer
sb:append("Hello, ")
sb:append("Hello, ")
sb:append("world!")
  :append("world!")
sb:append(123)
sb:append(123)
-- Append a new line and more content
sb:appendLine("This is a new line.")


-- Convert StringBuilder buffer to a string
-- Convert StringBuilder buffer to a string
Line 43: Line 61:


-- Output the result
-- Output the result
print(result)  -- Output: "Hello, world!123"
print(result)  -- Output: "Hello, world!123\nThis is a new line."
</syntaxhighlight>
</syntaxhighlight>
1,048

edits