Method to align floats on decimal point, where non significant zeroes are replaced by spaces (see FPAlign)

Mandatory parameters are:

• value: The number to align on decimal point
• dec: Number of decimal places (can be negative: see valid interval in Config::Controls.rounding_range)
• mode: Defines format type for decimal point alignment (defaults to FPAlign::DotZero)

Example:

require "tablo"

ar = [423.14159, 2.0000345, 0.0000234, 42.21, 7.9]
table = Tablo::Table.new(ar) do |t|
  t.add_column("Floats",
    body_formatter: ->(value : Tablo::CellType) {
      Tablo::Functions.fp_align(value.as(Float), 3, :dot_zero)
    }, &.itself)
end
puts table

+--------------+
|       Floats |
+--------------+
|      423.142 |
|        2.0   |
|        0.0   |
|       42.21  |
|        7.9   |
+--------------+

The .stretch method is designed to optimize the filling of a text zone, possibly multi-line, by inserting one or more filler characters (by default space) between each character of the initial string.

Mandatory parameters:

• text: The content of the cell (possibly multiline) to be stretched
• target_width: Width of column (or group or header cell)

Optional named parameters, with default values

• fill_char: Fill character for stretched text
• max_fill: Can be set to control the number of padding characters (fill_char) between each character in the stretched string
• prefix: String inserted in front of stretched text, left-aligned
  The area between braces can be reduced at will, to maximize stretching. See example below.
• suffix: Same as prefix, but right-aligned
• alignment: Justification of stretched text, excluding prefix and suffix

If constraints cannot be met (for example, prefix or suffix margins too large), returns text unchanged.

require "tablo"
table = Tablo::Table.new([1, 2, 3]) do |t|
  t.add_column("integer", &.itself)
  t.add_column("Float", &.**(0.5).round(2))
  t.add_group("Numbers", formatter: ->(value : Tablo::CellType, width : Int32) {
    Tablo::Functions.stretch(value.as(String), width, fill_char: '.', max_fill: 1,
      prefix: "<--{------} ", suffix: " {------}-->")
  })
end
puts table

In this example, we can see that the variable areas of the prefix and suffix have been reduced to maximize the stretch, which is nevertheless limited by the max_fill parameter to one character.

+-----------------------------+
| <----- N.u.m.b.e.r.s -----> |
+--------------+--------------+
|      integer |        Float |
+--------------+--------------+
|            1 |          1.0 |
|            2 |         1.41 |
|            3 |         1.73 |
+--------------+--------------+

And, without specifying max_fill:

+-----------------------------+
| <-- N..u..m..b..e..r..s --> |
+--------------+--------------+
|      integer |        Float |
+--------------+--------------+
|            1 |          1.0 |
|            2 |         1.41 |
|            3 |         1.73 |
+--------------+--------------+

Note that the alignment of stretched text is only respected if the prefix and suffix parameters are not absent or empty. Otherwise, the column alignment (defined or default) is applied.