// Copyright 2026 International Digital Economy Academy
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

///|
/// Writes the string representation of an object to the StringBuilder.
#alias(write)
#alias(write_string_interpolation)
pub fn[T : Show] StringBuilder::write_object(
  self : StringBuilder,
  obj : T,
) -> Unit {
  obj.output(self)
}

///|
/// Writes characters from an iterator to the StringBuilder. 
///
/// Parameters:
///
/// * `self` : The StringBuilder to write to.
/// * `iter` : An iterator yielding characters to write.
///
/// Example:
///
/// ```mbt check
/// test {
///   let sb = StringBuilder()
///   let chars = "Hello🤣".iter()
///   sb.write_iter(chars)
///   @test.assert_eq(sb.to_string(), "Hello🤣")
/// }
/// ```
pub fn StringBuilder::write_iter(
  self : StringBuilder,
  iter : Iter[Char],
) -> Unit {
  for ch in iter {
    self.write_char(ch)
  }
}

///|
/// Writes a StringView to the StringBuilder.
/// 
/// This is more efficient than converting the StringView to a String first,
/// as it directly writes the viewed portion without creating intermediate strings.
/// 
/// Parameters:
///
/// * `self` : The StringBuilder to write to.
/// * `view` : The StringView to write.
///
/// Example:
///
/// ```mbt check
/// test {
///   let sb = StringBuilder()
///   let str = "Hello, world!"
///   let view = str[7:12] // "world"
///   sb.write_stringview(view)
///   @test.assert_eq(sb.to_string(), "world")
/// }
/// ```
pub fn StringBuilder::write_stringview(
  self : StringBuilder,
  view : StringView,
) -> Unit {
  self.write_view(view)
}