cc.strings

Various utilities for working with strings and text.

See also

• textutils For additional string related utilities.

Changes

• New in version 1.95.0

wrap(text [, width])Source

Wraps a block of text, so that each line fits within the given width.

This may be useful if you want to wrap text before displaying it to a monitor or printer without using print.

Parameters

1. text string The string to wrap.
2. width? number The width to constrain to, defaults to the width of the terminal.

Returns

1. { string... } The wrapped input string as a list of lines.

Usage

• Wrap a string and write it to the terminal.

  term.clear()
  local lines = require "cc.strings".wrap("This is a long piece of text", 10)
  for i = 1, #lines do
    term.setCursorPos(1, i)
    term.write(lines[i])
  end
  

ensure_width(line [, width])Source

Makes the input string a fixed width. This either truncates it, or pads it with spaces.

Parameters

1. line string The string to normalise.
2. width? number The width to constrain to, defaults to the width of the terminal.

Returns

1. string The string with a specific width.

Usage

• require "cc.strings".ensure_width("a short string", 20)

• require "cc.strings".ensure_width("a rather long string which is truncated", 20)