Functions

Functions WebDev/*nix assorted functions & hacks

Classes add_autoloader_path($path) ascii_table($array, ....) Extend with .. this makes no sense html.class.php image.class.php model.class.php MyImage.class.php MyImage2.class.php reco-X-bject_old.class.php (old) recobject.class.php Request class Sqlite worst_ever($class) ZipFolder 14 found

auth

Name:
Category: Classes
Body:

<?php

/*
Todo
- to hopefully facilitate the outlines boolean behaviour, and also allow coloring lines, without chopping of parts of escape codes later,
  - pre-create the shorter versions of the lines as well,
  - or render them on the fly when printing/outputting?
- align right/center
- alternating bg colors, best for inlines=false
- choice of ascii/utf8 lines

class ascii_table {

public $keys = true;
    public $outlines = true;
    public $inlines = true;
    public string $colorCodesPattern = "/\e\[[0-9;]+m/"; // use this to not count escape sequences in the string length
    
    // define a ton of undefined properties
    public array $array;
    public string $table;
    public string $outline; // rename this
    public array $column_widths;
    public array $row_heights;
    public string $first_outline;
    public string $first_outline_double;
    public string $last_outline;
    public string $last_outline_double;
    public string $header_border;
    public string $vertical_border;
    public string $vertical_border_double;
    public string $out;

public function __construct(array $array, $keys = true, $outlines=true, $inlines=true) {
        $this->array    = $array;
        $this->keys     = $keys;
        $this->outlines = $outlines;
        $this->inlines  = $inlines;
        reset($this->array);
    }

public function render($return=false) {
        if (count($this->array) === 0) {
            $this->table = "+--------------+\n+ Empty array! +\n+--------------+\n";
            $this->print_or_return($return);
        }
        
        // fixme: broken for single-dim arrays >.<
        // if (! is_array(current($this->array))) {
        //     $this->array = array_map(function($a){return array($a);}, $this->array);
        // }
        // if ($this->keys and is_string(key(current($this->array)))) {
        //     $keys = array_keys(current($this->array));
        //     array_unshift($this->array, array_combine($keys, $keys));
        // }

// store maximum widths/heights for each column/row
        $this->get_max_dimensions();
        
        // line styles, eventually this can go to some methods too
        $this->outline = '├─';
        foreach ($this->column_widths as $key) $this->outline .= str_repeat('─', $key).'─┼─';
        $this->outline = $this->outlines ? substr($this->outline, 0, -6)."┤\n" : substr($this->outline, 2, -3)."\n";
        $this->first_outline = str_replace(['┼', '├', '┤'], ['┬', '┌', '┐'], $this->outline);
        $this->first_outline_double = str_replace(['┬', '┌', '─', '┐'], ['╦', '╔', '═', '╗'], $this->first_outline);
        $this->last_outline  = str_replace(['┼', '├', '┤'], ['┴', '└', '┘'], $this->outline);
        $this->last_outline_double = str_replace(['┴', '└', '─', '┘'], ['╩', '╚', '═', '╝'], $this->last_outline);
        $this->header_border = str_replace(['┼', '├', '─', '┤'], ['╬', '╠', '═', '╣'], $this->outline);
        $this->vertical_border = '│';
        $this->vertical_border_double = '║';
        
        // start of output string
        // header?
        if ($this->keys) {
            $this->out = $this->print_header();
        }else{
            $this->out = $this->outlines ? $this->first_outline : '';
        }

foreach ($this->array as $r => $row) {
            $this->out .= $this->print_row($r, $row);
            if ($r < count($this->array)-1) $this->out .= $this->outlines ? $this->outline : substr($this->outline, 1, -2)."\n";
        }
        if ($this->outlines) $this->out .= $this->last_outline;
        $this->table = $this->out;
        $this->print_or_return($return);
    }

public function print_header() {
        $keys = array_keys(current($this->array));
        $out  = $this->outlines ? $this->first_outline_double . $this->vertical_border_double .' ' : ' ';
        foreach ($keys as $key) {
            $out .= $key . str_repeat(' ', $this->column_widths[$key] - $this->mb_bw_strlen($key)) ." $this->vertical_border_double ";
        }
        if (! $this->outlines) $out = substr($out, 0, -2);
        $out .= "\n".($this->outlines ? $this->header_border : substr($this->header_border, 1, -2)."\n");
        return $out;
    }

public function print_row($r, $row) {
        // here, instead of looping through fields, first loop over the max _height_ of the row
        // then print each nth line of each field (and the field delimiters)
        // Also, re-set the escape-codes array
        $escapes = [];
        $out = '';
        for ($i = 0; $i < $this->row_heights[$r]; $i++) {
            $out .= $this->outlines ? "│ " : ' ';
            foreach ($row as $key => $value) {
                $bits = explode("\n", trim($value));
                $bit  = $bits[$i] ?? '';
                if (strlen($bit)) {
                    // maybe echo escape codes from the previous line in this cell
                    if (isset($escapes[$key])) $out .= $escapes[$key];
                    $mblen = $this->mb_bw_strlen($bit);
                    $out .= $bit;
                    // if there were escape codes on this line, and the last one is not an \e[0m,
                    //   - they go to the next line too
                    if (preg_match_all($this->colorCodesPattern, $bit, $matches) and end($matches)!=="\e[0m") {
                        if (! isset($escapes[$key])) $escapes[$key] = ''; // prevent undefined index
                        foreach($matches[0] as $ec) {
                            if ($ec === "\e[0m") {
                                $escapes[$key] = '';
                            }else{
                                $escapes[$key] .= $ec;
                            }
                        }
                    }
                    // - and close with our own \e[0m
                    if (! empty($escapes[$key])) $out .= "\e[0m";
                    $out .= str_repeat(' ', $this->column_widths[$key] - $mblen).' │ ';
                }else{
                    $out .= str_repeat(' ', $this->column_widths[$key]).' │ ';
                }
            }
            $out = substr($out, 0, $this->outlines ? -1 : -3)."\n"; // strip that last "padding-space"
        }
        return $out;
    }

public function get_max_dimensions() {
        $this->column_widths = array();
        $this->row_heights = array();
        // store the maximum column width per column in column_widths, and the max cell height per row in row_heights
        if ($this->keys) {
            foreach(array_keys(current($this->array)) as $key) $this->column_widths[$key] = strlen($key);
        }
        foreach ($this->array as $r => $row) {
            $this->row_heights[$r] = 1;
            foreach ($row as $key => $value) {
                $this->array[$r][$key] = $value = str_replace("\r", "", $value);
                if (is_array($value)) {
                    $sub_array = new self($value, $this->keys, false, $this->inlines); // recursing, disabling outlines
                    $this->array[$r][$key] = $value = $sub_array->render(true);
                }
                $longest_line = 0;
                $value_lines  = explode("\n", trim($value));
                foreach ($value_lines as $value_line) {
                    $longest_line = max($this->mb_bw_strlen($value_line), $longest_line);
                }
                $this->column_widths[$key] = max($longest_line, $this->column_widths[$key] ?? 0);
                $this->row_heights[$r]   = max($this->row_heights[$r], count($value_lines));
            }
        }
    }

// return the length of $str without the ansi color sequences, and accounting for multibyte utf8 characters
    public function mb_bw_strlen($str) {
        return mb_strlen(preg_replace($this->colorCodesPattern, '', $str), 'UTF-8');
    }

function print_or_return($return) {
        if ($return) {
            return $this->table;
        }else{
            echo $this->table;
        }

}
}

Footer

~~Functions~~ WebDev/nix assorted functions & hacks Search* find all Array - Bash - Classes - Config - DateTime - Debug - dotjs - File - foooo - Git - HTML - Images - Javascript - Linux - Math - Misc - MySQL - OS X - Reading - Redis - Shell scripts - snippets - SQL - Strings - Tampermonkey - TextMate - Web - \(^o^)/ Fun! - _Misc hacks - _Pages
Classes add_autoloader_path($path) ascii_table($array, ....) Extend with .. this makes no sense html.class.php image.class.php model.class.php MyImage.class.php MyImage2.class.php reco-X-bject_old.class.php (old) recobject.class.php Request class Sqlite worst_ever($class) ZipFolder 14 found auth	Name: Category: Classes Body: <?php /* Todo - to hopefully facilitate the outlines boolean behaviour, and also allow coloring lines, without chopping of parts of escape codes later, - pre-create the shorter versions of the lines as well, - or render them on the fly when printing/outputting? - align right/center - alternating bg colors, best for inlines=false - choice of ascii/utf8 lines */ class ascii_table { public $keys = true; public $outlines = true; public $inlines = true; public string $colorCodesPattern = "/\e\[[0-9;]+m/"; // use this to not count escape sequences in the string length // define a ton of undefined properties public array $array; public string $table; public string $outline; // rename this public array $column_widths; public array $row_heights; public string $first_outline; public string $first_outline_double; public string $last_outline; public string $last_outline_double; public string $header_border; public string $vertical_border; public string $vertical_border_double; public string $out; public function __construct(array $array, $keys = true, $outlines=true, $inlines=true) { $this->array = $array; $this->keys = $keys; $this->outlines = $outlines; $this->inlines = $inlines; reset($this->array); } public function render($return=false) { if (count($this->array) === 0) { $this->table = "+--------------+\n+ Empty array! +\n+--------------+\n"; $this->print_or_return($return); } // fixme: broken for single-dim arrays >.< // if (! is_array(current($this->array))) { // $this->array = array_map(function($a){return array($a);}, $this->array); // } // if ($this->keys and is_string(key(current($this->array)))) { // $keys = array_keys(current($this->array)); // array_unshift($this->array, array_combine($keys, $keys)); // } // store maximum widths/heights for each column/row $this->get_max_dimensions(); // line styles, eventually this can go to some methods too $this->outline = '├─'; foreach ($this->column_widths as $key) $this->outline .= str_repeat('─', $key).'─┼─'; $this->outline = $this->outlines ? substr($this->outline, 0, -6)."┤\n" : substr($this->outline, 2, -3)."\n"; $this->first_outline = str_replace(['┼', '├', '┤'], ['┬', '┌', '┐'], $this->outline); $this->first_outline_double = str_replace(['┬', '┌', '─', '┐'], ['╦', '╔', '═', '╗'], $this->first_outline); $this->last_outline = str_replace(['┼', '├', '┤'], ['┴', '└', '┘'], $this->outline); $this->last_outline_double = str_replace(['┴', '└', '─', '┘'], ['╩', '╚', '═', '╝'], $this->last_outline); $this->header_border = str_replace(['┼', '├', '─', '┤'], ['╬', '╠', '═', '╣'], $this->outline); $this->vertical_border = '│'; $this->vertical_border_double = '║'; // start of output string // header? if ($this->keys) { $this->out = $this->print_header(); }else{ $this->out = $this->outlines ? $this->first_outline : ''; } foreach ($this->array as $r => $row) { $this->out .= $this->print_row($r, $row); if ($r < count($this->array)-1) $this->out .= $this->outlines ? $this->outline : substr($this->outline, 1, -2)."\n"; } if ($this->outlines) $this->out .= $this->last_outline; $this->table = $this->out; $this->print_or_return($return); } public function print_header() { $keys = array_keys(current($this->array)); $out = $this->outlines ? $this->first_outline_double . $this->vertical_border_double .' ' : ' '; foreach ($keys as $key) { $out .= $key . str_repeat(' ', $this->column_widths[$key] - $this->mb_bw_strlen($key)) ." $this->vertical_border_double "; } if (! $this->outlines) $out = substr($out, 0, -2); $out .= "\n".($this->outlines ? $this->header_border : substr($this->header_border, 1, -2)."\n"); return $out; } public function print_row($r, $row) { // here, instead of looping through fields, first loop over the max _height_ of the row // then print each nth line of each field (and the field delimiters) // Also, re-set the escape-codes array $escapes = []; $out = ''; for ($i = 0; $i < $this->row_heights[$r]; $i++) { $out .= $this->outlines ? "│ " : ' '; foreach ($row as $key => $value) { $bits = explode("\n", trim($value)); $bit = $bits[$i] ?? ''; if (strlen($bit)) { // maybe echo escape codes from the previous line in this cell if (isset($escapes[$key])) $out .= $escapes[$key]; $mblen = $this->mb_bw_strlen($bit); $out .= $bit; // if there were escape codes on this line, and the last one is not an \e[0m, // - they go to the next line too if (preg_match_all($this->colorCodesPattern, $bit, $matches) and end($matches)!=="\e[0m") { if (! isset($escapes[$key])) $escapes[$key] = ''; // prevent undefined index foreach($matches[0] as $ec) { if ($ec === "\e[0m") { $escapes[$key] = ''; }else{ $escapes[$key] .= $ec; } } } // - and close with our own \e[0m if (! empty($escapes[$key])) $out .= "\e[0m"; $out .= str_repeat(' ', $this->column_widths[$key] - $mblen).' │ '; }else{ $out .= str_repeat(' ', $this->column_widths[$key]).' │ '; } } $out = substr($out, 0, $this->outlines ? -1 : -3)."\n"; // strip that last "padding-space" } return $out; } public function get_max_dimensions() { $this->column_widths = array(); $this->row_heights = array(); // store the maximum column width per column in column_widths, and the max cell height per row in row_heights if ($this->keys) { foreach(array_keys(current($this->array)) as $key) $this->column_widths[$key] = strlen($key); } foreach ($this->array as $r => $row) { $this->row_heights[$r] = 1; foreach ($row as $key => $value) { $this->array[$r][$key] = $value = str_replace("\r", "", $value); if (is_array($value)) { $sub_array = new self($value, $this->keys, false, $this->inlines); // recursing, disabling outlines $this->array[$r][$key] = $value = $sub_array->render(true); } $longest_line = 0; $value_lines = explode("\n", trim($value)); foreach ($value_lines as $value_line) { $longest_line = max($this->mb_bw_strlen($value_line), $longest_line); } $this->column_widths[$key] = max($longest_line, $this->column_widths[$key] ?? 0); $this->row_heights[$r] = max($this->row_heights[$r], count($value_lines)); } } } // return the length of $str without the ansi color sequences, and accounting for multibyte utf8 characters public function mb_bw_strlen($str) { return mb_strlen(preg_replace($this->colorCodesPattern, '', $str), 'UTF-8'); } function print_or_return($return) { if ($return) { return $this->table; }else{ echo $this->table; } } }
Footer