io

Immutable fixed-size string type that supports unicode.

^{part of SuperZIG/io library.}

^{🔥 Built for power. Designed for speed. Ready for production. 🔥}

• Features 🌟

  • 🌍 Unicode Support

    Properly handles Unicode, preserving character integrity, including complex grapheme clusters like emojis and modifiers.

  • ⚡ Blazing Fast Performance

    Matches the speed of Zig’s standard library and outperforms competitors in benchmarks.

  • 🛡️ Rock-Solid Stability

    Every function is rigorously tested, making the library safe, reliable, and ready for production.

  • 🏗️ Optimized for Scalability

    Designed with efficiency in mind, avoiding unnecessary allocations while maintaining flexibility.

• 📖 Table of Contents

  🔹 🚀 Quick Start – A quick guide to get you started with the library.

  🔹 🎇 API Reference – Detailed documentation of available functions.

• Quick Start 🚀

  If you have not already added the library to your project, please review the installation guide for more information.

    const Viewer = @import("io").Viewer;
  

  Now let’s create our container, but before that we need to define the data type used to store the values, for example:

  If you are going to deal with (utf8, utf16, ..) encoding, you can use (u8, u16, ..) as the data type.

    const view = try Viewer(u8).init("Hello 👨‍🏭!");
  

  Then you can use it just like the example below with full flexibility.

    // Get the length of the viewer.
    _ = view.len();             // 👉 18
  

    // Get the visual length of the viewer.
    _ = view.vlen();            // 👉 8
  

    // Get a byte at a specific index.
    _ = view.charAt(0);         // 👉 'H'
  

    // Get a character at a specific visual position.
    _ = view.atVisual(6);       // 👉 "👨‍🏭"
  

    // Find the position of a substring.
    _ = view.find("👨‍🏭");       // 👉 6
  

    // Check if the viewer includes a specific substring.
    _ = view.includes("👨‍🏭");   // 👉 true
  

    // and much more . . !
  

• API 🎇

  • 🍃 Fields

    Field	Type	Description
    m_src	[]const u8	The immutable unicode encoded chars.
    m_len	usize	The number of written chars.

  • ✨ Initialization

    Function	Description
    init	Initializes a Viewer instance with anytype.
    initEmpty	Initializes a new empty Viewer instance.
    initWithChar	Initializes a new Viewer instance with the specified initial char.
    initWithSlice	Initializes a new Viewer instance with the specified initial chars.
    initWithSelf	Initializes a new Viewer instance with the specified initial Viewer.

  • 📏 Data

    Function	Description
    size	Returns the number of chars that can be written.
    len	Returns the total number of written chars.
    vlen	Returns the total number of visual characters.
    src	Returns a slice containing only the written part.
    sub	Returns a sub-slice of the Viewer.
    charAt	Returns a character at the specified index.
    atVisual	Returns a character at the specified visual position.
    iterator	Creates an iterator for traversing the Unicode chars.

  • 🔍 Find

    Function	Description
    find	Finds the position of the first occurrence of the target slice.
    findVisual	Finds the visual position of the first occurrence of the target slice.
    findLast	Finds the position of the last occurrence of the target slice.
    findLastVisual	Finds the visual position of the last occurrence of the target slice.
    includes	Returns true if the Viewer instance contains the target slice.
    startsWith	Returns true if the Viewer instance starts with the target slice.
    endsWith	Returns true if the Viewer instance ends with the target slice.

  • ✅ Check

    Function	Description
    isEqual	Returns true if the Viewer instance equals the given target slice.
    isEmpty	Returns true if the Viewer instance is empty.

  • 🔄 Split

    Function	Description
    split	Splits the written portion into substrings separated by the specified delimiters.
    splitAll	Splits the written portion into all substrings separated by the specified delimiters.
    splitToSelf	Splits the written portion into substrings separated by the specified delimiters, returning the substring at the specified index as a new Viewer instance.
    splitAllToSelf	Splits the written portion into all substrings separated by the specified delimiters, returning an array of new Viewer instances.

  • 🔄 Utils

    Function	Description
    clone	Returns a deep copy of the Viewer instance.
    clear	Clears the contents of the Viewer.
    print	Prints the contents of the Viewer instance to the standard writer.
    printTo	Prints the contents of the Viewer instance to the given writer.
    printWithNewline	Prints the contents of the Viewer instance to the standard writer and adds a newline.

• 🔗 Related

  • Unicode

    Utility functions for Unicode codepoints and grapheme clusters.

  • Chars

    Utility functions for char arrays.

  • String

    Managed dynamic-size string type that supports unicode.

  • Buffer

    Mutable fixed-size string type that supports unicode.

  • uString

    Unmanaged dynamic-size string type that supports unicode.

This site is open source. Improve this page.