mirror of
https://github.com/fish-shell/fish-shell.git
synced 2024-11-30 06:03:49 +08:00
1360 lines
39 KiB
C++
1360 lines
39 KiB
C++
/** \file screen.c High level library for handling the terminal screen
|
|
|
|
The screen library allows the interactive reader to write its
|
|
output to screen efficiently by keeping an inetrnal representation
|
|
of the current screen contents and trying to find the most
|
|
efficient way for transforming that to the desired screen content.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include <stdlib.h>
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
#include <errno.h>
|
|
#include <termios.h>
|
|
#include <sys/types.h>
|
|
|
|
#ifdef HAVE_SYS_TERMIOS_H
|
|
#include <sys/termios.h>
|
|
#endif
|
|
|
|
#include <unistd.h>
|
|
#include <wctype.h>
|
|
|
|
#if HAVE_NCURSES_H
|
|
#include <ncurses.h>
|
|
#else
|
|
#include <curses.h>
|
|
#endif
|
|
|
|
#if HAVE_TERMIO_H
|
|
#include <termio.h>
|
|
#endif
|
|
|
|
#if HAVE_TERM_H
|
|
#include <term.h>
|
|
#elif HAVE_NCURSES_TERM_H
|
|
#include <ncurses/term.h>
|
|
#endif
|
|
|
|
#include <wchar.h>
|
|
#include <time.h>
|
|
|
|
#include <assert.h>
|
|
#include <vector>
|
|
|
|
|
|
#include "fallback.h"
|
|
#include "common.h"
|
|
#include "util.h"
|
|
#include "wutil.h"
|
|
#include "output.h"
|
|
#include "highlight.h"
|
|
#include "screen.h"
|
|
#include "env.h"
|
|
|
|
/**
|
|
The number of characters to indent new blocks
|
|
*/
|
|
#define INDENT_STEP 4
|
|
|
|
/** A helper value for an invalid location */
|
|
#define INVALID_LOCATION (screen_data_t::cursor_t(-1, -1))
|
|
|
|
static void invalidate_soft_wrap(screen_t *scr);
|
|
|
|
/**
|
|
Ugly kludge. The internal buffer used to store output of
|
|
tputs. Since tputs external function can only take an integer and
|
|
not a pointer as parameter we need a static storage buffer.
|
|
*/
|
|
typedef std::vector<char> data_buffer_t;
|
|
static data_buffer_t *s_writeb_buffer=0;
|
|
|
|
static int s_writeb( char c );
|
|
|
|
/* Class to temporarily set s_writeb_buffer and the writer function in a scoped way */
|
|
class scoped_buffer_t {
|
|
data_buffer_t * const old_buff;
|
|
int (* const old_writer)(char);
|
|
|
|
public:
|
|
scoped_buffer_t(data_buffer_t *buff) : old_buff(s_writeb_buffer), old_writer(output_get_writer())
|
|
{
|
|
s_writeb_buffer = buff;
|
|
output_set_writer(s_writeb);
|
|
}
|
|
|
|
~scoped_buffer_t()
|
|
{
|
|
s_writeb_buffer = old_buff;
|
|
output_set_writer(old_writer);
|
|
}
|
|
};
|
|
|
|
/**
|
|
Tests if the specified narrow character sequence is present at the
|
|
specified position of the specified wide character string. All of
|
|
\c seq must match, but str may be longer than seq.
|
|
*/
|
|
static int try_sequence( const char *seq, const wchar_t *str )
|
|
{
|
|
int i;
|
|
|
|
for( i=0;; i++ )
|
|
{
|
|
if( !seq[i] )
|
|
return i;
|
|
|
|
if( seq[i] != str[i] )
|
|
return 0;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
Returns the number of columns left until the next tab stop, given
|
|
the current cursor postion.
|
|
*/
|
|
static size_t next_tab_stop( size_t in )
|
|
{
|
|
/*
|
|
Assume tab stops every 8 characters if undefined
|
|
*/
|
|
size_t tab_width = (init_tabs > 0 ? (size_t)init_tabs : 8);
|
|
return ( (in/tab_width)+1 )*tab_width;
|
|
}
|
|
|
|
// PCA for term256 support, let's just detect the escape codes directly
|
|
static int is_term256_escape(const wchar_t *str)
|
|
{
|
|
// An escape code looks like this: \x1b[38;5;<num>m
|
|
// or like this: \x1b[48;5;<num>m
|
|
|
|
// parse out the required prefix
|
|
int len = try_sequence("\x1b[38;5;", str);
|
|
if (! len) len = try_sequence("\x1b[48;5;", str);
|
|
if (! len) return 0;
|
|
|
|
// now try parsing out a string of digits
|
|
// we need at least one
|
|
if (! iswdigit(str[len])) return 0;
|
|
while (iswdigit(str[len])) len++;
|
|
|
|
// look for the terminating m
|
|
if (str[len++] != L'm') return 0;
|
|
|
|
// success
|
|
return len;
|
|
}
|
|
|
|
/* Whether we permit soft wrapping. If so, in some cases we don't explicitly move to the second physical line on a wrapped logical line; instead we just output it. */
|
|
static bool allow_soft_wrap(void)
|
|
{
|
|
// Should we be looking at eat_newline_glitch as well?
|
|
return !! auto_right_margin;
|
|
}
|
|
|
|
/**
|
|
Calculate the width of the specified prompt. Does some clever magic
|
|
to detect common escape sequences that may be embeded in a prompt,
|
|
such as color codes.
|
|
*/
|
|
static size_t calc_prompt_width_and_lines( const wchar_t *prompt, size_t *out_prompt_lines )
|
|
{
|
|
size_t res = 0;
|
|
size_t j, k;
|
|
*out_prompt_lines = 1;
|
|
|
|
for( j=0; prompt[j]; j++ )
|
|
{
|
|
if( prompt[j] == L'\x1b' )
|
|
{
|
|
/*
|
|
This is the start of an escape code. Try to guess it's width.
|
|
*/
|
|
size_t p;
|
|
int len=0;
|
|
bool found = false;
|
|
|
|
/*
|
|
Detect these terminfo color escapes with parameter
|
|
value 0..7, all of which don't move the cursor
|
|
*/
|
|
char * const esc[] =
|
|
{
|
|
set_a_foreground,
|
|
set_a_background,
|
|
set_foreground,
|
|
set_background,
|
|
}
|
|
;
|
|
|
|
/*
|
|
Detect these semi-common terminfo escapes without any
|
|
parameter values, all of which don't move the cursor
|
|
*/
|
|
char * const esc2[] =
|
|
{
|
|
enter_bold_mode,
|
|
exit_attribute_mode,
|
|
enter_underline_mode,
|
|
exit_underline_mode,
|
|
enter_standout_mode,
|
|
exit_standout_mode,
|
|
flash_screen,
|
|
enter_subscript_mode,
|
|
exit_subscript_mode,
|
|
enter_superscript_mode,
|
|
exit_superscript_mode,
|
|
enter_blink_mode,
|
|
enter_italics_mode,
|
|
exit_italics_mode,
|
|
enter_reverse_mode,
|
|
enter_shadow_mode,
|
|
exit_shadow_mode,
|
|
enter_standout_mode,
|
|
exit_standout_mode,
|
|
enter_secure_mode
|
|
}
|
|
;
|
|
|
|
for( p=0; p < sizeof esc / sizeof *esc && !found; p++ )
|
|
{
|
|
if( !esc[p] )
|
|
continue;
|
|
|
|
for( k=0; k<8; k++ )
|
|
{
|
|
len = try_sequence( tparm(esc[p],k), &prompt[j] );
|
|
if( len )
|
|
{
|
|
j += (len-1);
|
|
found = true;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
// PCA for term256 support, let's just detect the escape codes directly
|
|
if (! found) {
|
|
len = is_term256_escape(&prompt[j]);
|
|
if (len) {
|
|
j += (len - 1);
|
|
found = true;
|
|
}
|
|
}
|
|
|
|
|
|
for( p=0; p < (sizeof(esc2)/sizeof(char *)) && !found; p++ )
|
|
{
|
|
if( !esc2[p] )
|
|
continue;
|
|
/*
|
|
Test both padded and unpadded version, just to
|
|
be safe. Most versions of tparm don't actually
|
|
seem to do anything these days.
|
|
*/
|
|
len = maxi( try_sequence( tparm(esc2[p]), &prompt[j] ),
|
|
try_sequence( esc2[p], &prompt[j] ));
|
|
|
|
if( len )
|
|
{
|
|
j += (len-1);
|
|
found = true;
|
|
}
|
|
}
|
|
|
|
if( !found )
|
|
{
|
|
if( prompt[j+1] == L'k' )
|
|
{
|
|
const env_var_t term_name = env_get_string( L"TERM" );
|
|
if( !term_name.missing() && wcsstr( term_name.c_str(), L"screen" ) == term_name )
|
|
{
|
|
const wchar_t *end;
|
|
j+=2;
|
|
found = true;
|
|
end = wcsstr( &prompt[j], L"\x1b\\" );
|
|
if( end )
|
|
{
|
|
/*
|
|
You'd thing this should be
|
|
'(end-prompt)+2', in order to move j
|
|
past the end of the string, but there is
|
|
a 'j++' at the end of each lap, so j
|
|
should always point to the last menged
|
|
character, e.g. +1.
|
|
*/
|
|
j = (end-prompt)+1;
|
|
}
|
|
else
|
|
{
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
}
|
|
else if( prompt[j] == L'\t' )
|
|
{
|
|
res = next_tab_stop( res );
|
|
}
|
|
else if( prompt[j] == L'\n' )
|
|
{
|
|
res = 0;
|
|
*out_prompt_lines += 1;
|
|
}
|
|
else
|
|
{
|
|
/*
|
|
Ordinary decent character. Just add width.
|
|
*/
|
|
res += fish_wcwidth( prompt[j] );
|
|
}
|
|
}
|
|
return res;
|
|
}
|
|
|
|
static size_t calc_prompt_width(const wchar_t *prompt)
|
|
{
|
|
size_t ignored;
|
|
return calc_prompt_width_and_lines(prompt, &ignored);
|
|
}
|
|
|
|
static size_t calc_prompt_lines(const wchar_t *prompt)
|
|
{
|
|
// Hack for the common case where there's no newline at all
|
|
// I don't know if a newline can appear in an escape sequence,
|
|
// so if we detect a newline we have to defer to calc_prompt_width_and_lines
|
|
size_t result = 1;
|
|
if (wcschr(prompt, L'\n') != NULL)
|
|
{
|
|
calc_prompt_width_and_lines(prompt, &result);
|
|
}
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
Test if there is space between the time fields of struct stat to
|
|
use for sub second information. If so, we assume this space
|
|
contains the desired information.
|
|
*/
|
|
static int room_for_usec(struct stat *st)
|
|
{
|
|
int res = ((&(st->st_atime) + 2) == &(st->st_mtime) &&
|
|
(&(st->st_atime) + 4) == &(st->st_ctime));
|
|
return res;
|
|
}
|
|
|
|
/**
|
|
Stat stdout and stderr and save result.
|
|
|
|
This should be done before calling a function that may cause output.
|
|
*/
|
|
|
|
static void s_save_status( screen_t *s)
|
|
{
|
|
|
|
// PCA Let's not do this futimes stuff, because sudo dumbly uses the
|
|
// tty's ctime as part of its tty_tickets feature
|
|
// Disabling this should fix https://github.com/fish-shell/fish-shell/issues/122
|
|
#if 0
|
|
/*
|
|
This futimes call tries to trick the system into using st_mtime
|
|
as a tampering flag. This of course only works on systems where
|
|
futimes is defined, but it should make the status saving stuff
|
|
failsafe.
|
|
*/
|
|
struct timeval t[]=
|
|
{
|
|
{
|
|
time(0)-1,
|
|
0
|
|
}
|
|
,
|
|
{
|
|
time(0)-1,
|
|
0
|
|
}
|
|
}
|
|
;
|
|
|
|
/*
|
|
Don't check return value on these. We don't care if they fail,
|
|
really. This is all just to make the prompt look ok, which is
|
|
impossible to do 100% reliably. We try, at least.
|
|
*/
|
|
futimes( 1, t );
|
|
futimes( 2, t );
|
|
#endif
|
|
|
|
fstat( 1, &s->prev_buff_1 );
|
|
fstat( 2, &s->prev_buff_2 );
|
|
}
|
|
|
|
/**
|
|
Stat stdout and stderr and compare result to previous result in
|
|
reader_save_status. Repaint if modification time has changed.
|
|
|
|
Unfortunately, for some reason this call seems to give a lot of
|
|
false positives, at least under Linux.
|
|
*/
|
|
|
|
static void s_check_status( screen_t *s)
|
|
{
|
|
fflush( stdout );
|
|
fflush( stderr );
|
|
|
|
fstat( 1, &s->post_buff_1 );
|
|
fstat( 2, &s->post_buff_2 );
|
|
|
|
int changed = ( s->prev_buff_1.st_mtime != s->post_buff_1.st_mtime ) ||
|
|
( s->prev_buff_2.st_mtime != s->post_buff_2.st_mtime );
|
|
|
|
if (room_for_usec( &s->post_buff_1))
|
|
{
|
|
changed = changed || ( (&s->prev_buff_1.st_mtime)[1] != (&s->post_buff_1.st_mtime)[1] ) ||
|
|
( (&s->prev_buff_2.st_mtime)[1] != (&s->post_buff_2.st_mtime)[1] );
|
|
}
|
|
|
|
if( changed )
|
|
{
|
|
/*
|
|
Ok, someone has been messing with our screen. We will want
|
|
to repaint. However, we do not know where the cursor is. It
|
|
is our best bet that we are still on the same line, so we
|
|
move to the beginning of the line, reset the modelled screen
|
|
contents, and then set the modeled cursor y-pos to its
|
|
earlier value.
|
|
*/
|
|
|
|
int prev_line = s->actual.cursor.y;
|
|
write_loop( 1, "\r", 1 );
|
|
s_reset( s, false );
|
|
s->actual.cursor.y = prev_line;
|
|
}
|
|
}
|
|
|
|
/**
|
|
Appends a character to the end of the line that the output cursor is
|
|
on. This function automatically handles linebreaks and lines longer
|
|
than the screen width.
|
|
*/
|
|
static void s_desired_append_char( screen_t *s,
|
|
wchar_t b,
|
|
int c,
|
|
int indent,
|
|
size_t prompt_width )
|
|
{
|
|
int line_no = s->desired.cursor.y;
|
|
|
|
switch( b )
|
|
{
|
|
case L'\n':
|
|
{
|
|
int i;
|
|
/* Current line is definitely hard wrapped */
|
|
s->desired.line(s->desired.cursor.y).is_soft_wrapped = false;
|
|
s->desired.create_line(s->desired.line_count());
|
|
s->desired.cursor.y++;
|
|
s->desired.cursor.x=0;
|
|
for( i=0; i < prompt_width+indent*INDENT_STEP; i++ )
|
|
{
|
|
s_desired_append_char( s, L' ', 0, indent, prompt_width );
|
|
}
|
|
break;
|
|
}
|
|
|
|
case L'\r':
|
|
{
|
|
line_t ¤t = s->desired.line(line_no);
|
|
current.clear();
|
|
s->desired.cursor.x = 0;
|
|
break;
|
|
}
|
|
|
|
default:
|
|
{
|
|
int screen_width = common_get_width();
|
|
int cw = fish_wcwidth(b);
|
|
|
|
s->desired.create_line(line_no);
|
|
|
|
/*
|
|
Check if we are at the end of the line. If so, continue on the next line.
|
|
*/
|
|
if( (s->desired.cursor.x + cw) > screen_width )
|
|
{
|
|
/* Current line is soft wrapped (assuming we support it) */
|
|
s->desired.line(s->desired.cursor.y).is_soft_wrapped = true;
|
|
//fprintf(stderr, "\n\n1 Soft wrapping %d\n\n", s->desired.cursor.y);
|
|
|
|
line_no = (int)s->desired.line_count();
|
|
s->desired.add_line();
|
|
s->desired.cursor.y++;
|
|
s->desired.cursor.x=0;
|
|
for( size_t i=0; i < prompt_width; i++ )
|
|
{
|
|
s_desired_append_char( s, L' ', 0, indent, prompt_width );
|
|
}
|
|
}
|
|
|
|
line_t &line = s->desired.line(line_no);
|
|
line.append(b, c);
|
|
s->desired.cursor.x+= cw;
|
|
|
|
/* Maybe wrap the cursor to the next line, even if the line itself did not wrap. This avoids wonkiness in the last column. */
|
|
if (s->desired.cursor.x >= screen_width)
|
|
{
|
|
line.is_soft_wrapped = true;
|
|
s->desired.cursor.x = 0;
|
|
s->desired.cursor.y++;
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
The writeb function offered to tputs.
|
|
*/
|
|
static int s_writeb( char c )
|
|
{
|
|
s_writeb_buffer->push_back(c);
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
Write the bytes needed to move screen cursor to the specified
|
|
position to the specified buffer. The actual_cursor field of the
|
|
specified screen_t will be updated.
|
|
|
|
\param s the screen to operate on
|
|
\param b the buffer to send the output escape codes to
|
|
\param new_x the new x position
|
|
\param new_y the new y position
|
|
*/
|
|
static void s_move( screen_t *s, data_buffer_t *b, int new_x, int new_y )
|
|
{
|
|
if (s->actual.cursor.x == new_x && s->actual.cursor.y == new_y)
|
|
return;
|
|
|
|
int i;
|
|
int x_steps, y_steps;
|
|
|
|
char *str;
|
|
/*
|
|
debug( 0, L"move from %d %d to %d %d",
|
|
s->screen_cursor[0], s->screen_cursor[1],
|
|
new_x, new_y );
|
|
*/
|
|
scoped_buffer_t scoped_buffer(b);
|
|
|
|
y_steps = new_y - s->actual.cursor.y;
|
|
|
|
if( y_steps > 0 && (strcmp( cursor_down, "\n")==0))
|
|
{
|
|
/*
|
|
This is very strange - it seems some (all?) consoles use a
|
|
simple newline as the cursor down escape. This will of
|
|
course move the cursor to the beginning of the line as well
|
|
as moving it down one step. The cursor_up does not have this
|
|
behaviour...
|
|
*/
|
|
s->actual.cursor.x=0;
|
|
}
|
|
|
|
if( y_steps < 0 )
|
|
{
|
|
str = cursor_up;
|
|
}
|
|
else
|
|
{
|
|
str = cursor_down;
|
|
|
|
}
|
|
|
|
for( i=0; i<abs(y_steps); i++)
|
|
{
|
|
writembs(str);
|
|
}
|
|
|
|
|
|
x_steps = new_x - s->actual.cursor.x;
|
|
|
|
if( x_steps && new_x == 0 )
|
|
{
|
|
b->push_back('\r');
|
|
x_steps = 0;
|
|
}
|
|
|
|
if( x_steps < 0 )
|
|
{
|
|
str = cursor_left;
|
|
}
|
|
else
|
|
{
|
|
str = cursor_right;
|
|
}
|
|
|
|
for( i=0; i<abs(x_steps); i++)
|
|
{
|
|
writembs(str);
|
|
}
|
|
|
|
|
|
s->actual.cursor.x = new_x;
|
|
s->actual.cursor.y = new_y;
|
|
}
|
|
|
|
/**
|
|
Set the pen color for the terminal
|
|
*/
|
|
static void s_set_color( screen_t *s, data_buffer_t *b, int c )
|
|
{
|
|
scoped_buffer_t scoped_buffer(b);
|
|
|
|
unsigned int uc = (unsigned int)c;
|
|
set_color( highlight_get_color( uc & 0xffff, false ),
|
|
highlight_get_color( (uc>>16)&0xffff, true ) );
|
|
}
|
|
|
|
/**
|
|
Convert a wide character to a multibyte string and append it to the
|
|
buffer.
|
|
*/
|
|
static void s_write_char( screen_t *s, data_buffer_t *b, wchar_t c )
|
|
{
|
|
scoped_buffer_t scoped_buffer(b);
|
|
s->actual.cursor.x+=fish_wcwidth( c );
|
|
writech( c );
|
|
if (s->actual.cursor.x == s->actual_width && allow_soft_wrap())
|
|
{
|
|
s->soft_wrap_location.x = 0;
|
|
s->soft_wrap_location.y = s->actual.cursor.y + 1;
|
|
|
|
/* If auto_right_margin is set, then the cursor sticks to the right edge when it's in the rightmost column, so reflect that fact */
|
|
if (auto_right_margin)
|
|
s->actual.cursor.x--;
|
|
}
|
|
else
|
|
{
|
|
invalidate_soft_wrap(s);
|
|
}
|
|
}
|
|
|
|
/**
|
|
Send the specified string through tputs and append the output to
|
|
the specified buffer.
|
|
*/
|
|
static void s_write_mbs( data_buffer_t *b, char *s )
|
|
{
|
|
scoped_buffer_t scoped_buffer(b);
|
|
writembs( s );
|
|
}
|
|
|
|
/**
|
|
Convert a wide string to a multibyte string and append it to the
|
|
buffer.
|
|
*/
|
|
static void s_write_str( data_buffer_t *b, const wchar_t *s )
|
|
{
|
|
scoped_buffer_t scoped_buffer(b);
|
|
writestr( s );
|
|
}
|
|
|
|
/** Returns the length of the "shared prefix" of the two lines, which is the run of matching text and colors.
|
|
If the prefix ends on a combining character, do not include the previous character in the prefix.
|
|
*/
|
|
static size_t line_shared_prefix(const line_t &a, const line_t &b)
|
|
{
|
|
size_t idx, max = std::min(a.size(), b.size());
|
|
for (idx=0; idx < max; idx++)
|
|
{
|
|
wchar_t ac = a.char_at(idx), bc = b.char_at(idx);
|
|
if (fish_wcwidth(ac) < 1 || fish_wcwidth(bc) < 1)
|
|
{
|
|
/* Possible combining mark, return one index prior */
|
|
if (idx > 0) idx--;
|
|
break;
|
|
}
|
|
|
|
/* We're done if the text or colors are different */
|
|
if (ac != bc || a.color_at(idx) != b.color_at(idx))
|
|
break;
|
|
}
|
|
return idx;
|
|
}
|
|
|
|
/* We are about to output one or more characters onto the screen at the given x, y. If we are at the end of previous line, and the previous line is marked as soft wrapping, then tweak the screen so we believe we are already in the target position. This lets the terminal take care of wrapping, which means that if you copy and paste the text, it won't have an embedded newline. */
|
|
static bool perform_any_impending_soft_wrap(screen_t *scr, int x, int y)
|
|
{
|
|
if (x == scr->soft_wrap_location.x && y == scr->soft_wrap_location.y)
|
|
{
|
|
/* We can soft wrap; but do we want to? */
|
|
if (scr->desired.line(y - 1).is_soft_wrapped && allow_soft_wrap())
|
|
{
|
|
/* Yes. Just update the actual cursor; that will cause us to elide emitting the commands to move here, so we will just output on "one big line" (which the terminal soft wraps */
|
|
scr->actual.cursor = scr->soft_wrap_location;
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/* Make sure we don't soft wrap */
|
|
static void invalidate_soft_wrap(screen_t *scr)
|
|
{
|
|
scr->soft_wrap_location = INVALID_LOCATION;
|
|
}
|
|
|
|
/**
|
|
Update the screen to match the desired output.
|
|
*/
|
|
static void s_update( screen_t *scr, const wchar_t *left_prompt, const wchar_t *right_prompt )
|
|
{
|
|
const size_t left_prompt_width = calc_prompt_width( left_prompt );
|
|
const size_t right_prompt_width = calc_prompt_width( right_prompt );
|
|
|
|
int screen_width = common_get_width();
|
|
bool need_clear = scr->need_clear;
|
|
bool has_cleared_screen = false;
|
|
|
|
/* Figure out how many following lines we need to clear (probably 0) */
|
|
size_t actual_lines_before_reset = scr->actual_lines_before_reset;
|
|
scr->actual_lines_before_reset = 0;
|
|
|
|
data_buffer_t output;
|
|
|
|
scr->need_clear = false;
|
|
|
|
if( scr->actual_width != screen_width )
|
|
{
|
|
need_clear = true;
|
|
s_move( scr, &output, 0, 0 );
|
|
scr->actual_width = screen_width;
|
|
s_reset( scr, false, false /* don't clear prompt */);
|
|
}
|
|
|
|
/* Determine how many lines have stuff on them; we need to clear lines with stuff that we don't want */
|
|
const size_t lines_with_stuff = maxi(actual_lines_before_reset, scr->actual.line_count());
|
|
if (lines_with_stuff > scr->desired.line_count())
|
|
{
|
|
/* There are lines that we output to previously that will need to be cleared */
|
|
need_clear = true;
|
|
}
|
|
|
|
if( wcscmp( left_prompt, scr->actual_left_prompt.c_str() ) )
|
|
{
|
|
s_move( scr, &output, 0, 0 );
|
|
s_write_str( &output, left_prompt );
|
|
scr->actual_left_prompt = left_prompt;
|
|
scr->actual.cursor.x = (int)left_prompt_width;
|
|
}
|
|
|
|
for (size_t i=0; i < scr->desired.line_count(); i++)
|
|
{
|
|
const line_t &o_line = scr->desired.line(i);
|
|
line_t &s_line = scr->actual.create_line(i);
|
|
size_t start_pos = (i==0 ? left_prompt_width : 0);
|
|
int current_width = 0;
|
|
|
|
/* If this is the last line, maybe we should clear the screen */
|
|
const bool should_clear_screen_this_line = (need_clear && i + 1 == scr->desired.line_count() && clr_eos != NULL);
|
|
|
|
/* Note that skip_remaining is a width, not a character count */
|
|
size_t skip_remaining = start_pos;
|
|
|
|
if (! should_clear_screen_this_line) {
|
|
/* Compute how much we should skip. At a minimum we skip over the prompt. But also skip over the shared prefix of what we want to output now, and what we output before, to avoid repeatedly outputting it. */
|
|
const size_t shared_prefix = line_shared_prefix(o_line, s_line);
|
|
if (shared_prefix > 0)
|
|
{
|
|
int prefix_width = fish_wcswidth(&o_line.text.at(0), shared_prefix);
|
|
if (prefix_width > skip_remaining)
|
|
skip_remaining = prefix_width;
|
|
}
|
|
|
|
/* Don't skip over the last two characters in a soft-wrapped line, so that we maintain soft-wrapping */
|
|
if (o_line.is_soft_wrapped)
|
|
skip_remaining = mini(skip_remaining, (size_t)(scr->actual_width - 2));
|
|
}
|
|
|
|
/* Skip over skip_remaining width worth of characters */
|
|
size_t j = 0;
|
|
for ( ; j < o_line.size(); j++)
|
|
{
|
|
int width = fish_wcwidth(o_line.char_at(j));
|
|
if (skip_remaining < width)
|
|
break;
|
|
skip_remaining -= width;
|
|
current_width += width;
|
|
}
|
|
|
|
/* Skip over zero-width characters (e.g. combining marks at the end of the prompt) */
|
|
for ( ; j < o_line.size(); j++)
|
|
{
|
|
int width = fish_wcwidth(o_line.char_at(j));
|
|
if (width > 0)
|
|
break;
|
|
}
|
|
|
|
/* Maybe clear the screen before outputting. If we clear the screen after outputting, then we may erase the last character due to the sticky right margin. */
|
|
if (should_clear_screen_this_line) {
|
|
s_move( scr, &output, current_width, (int)i );
|
|
s_write_mbs(&output, clr_eos);
|
|
has_cleared_screen = true;
|
|
}
|
|
|
|
/* Now actually output stuff */
|
|
for ( ; j < o_line.size(); j++)
|
|
{
|
|
perform_any_impending_soft_wrap(scr, current_width, (int)i);
|
|
s_move( scr, &output, current_width, (int)i );
|
|
s_set_color( scr, &output, o_line.color_at(j) );
|
|
s_write_char( scr, &output, o_line.char_at(j) );
|
|
current_width += fish_wcwidth(o_line.char_at(j));
|
|
}
|
|
|
|
bool clear_remainder = false;
|
|
/* Clear the remainder of the line if we need to clear and if we didn't write to the end of the line. If we did write to the end of the line, the "sticky right edge" (as part of auto_right_margin) means that we'll be clearing the last character we wrote! */
|
|
if (has_cleared_screen)
|
|
{
|
|
/* Already cleared everything */
|
|
clear_remainder = false;
|
|
}
|
|
else if (need_clear && current_width < screen_width)
|
|
{
|
|
clear_remainder = true;
|
|
}
|
|
else if (right_prompt_width < scr->last_right_prompt_width)
|
|
{
|
|
clear_remainder = true;
|
|
}
|
|
else
|
|
{
|
|
int prev_width = (s_line.text.empty() ? 0 : fish_wcswidth(&s_line.text.at(0), s_line.text.size()));
|
|
clear_remainder = prev_width > current_width;
|
|
|
|
}
|
|
if (clear_remainder)
|
|
{
|
|
s_move( scr, &output, current_width, (int)i );
|
|
s_write_mbs( &output, clr_eol);
|
|
}
|
|
|
|
/* Output any rprompt if this is the first line. */
|
|
if (i == 0 && right_prompt_width > 0)
|
|
{
|
|
s_move( scr, &output, (int)(screen_width - right_prompt_width), (int)i );
|
|
s_set_color( scr, &output, 0xffffffff);
|
|
s_write_str( &output, right_prompt );
|
|
/* We output in the last column. Some terms (Linux) push the cursor further right, past the window. Others make it "stick." Since we don't really know which is which, issue a cr so it goes back to the left. */
|
|
s_write_str( &output, L"\r");
|
|
scr->actual.cursor.x = 0;
|
|
}
|
|
}
|
|
|
|
|
|
/* Clear remaining lines if we haven't done so already */
|
|
if (need_clear && ! has_cleared_screen)
|
|
{
|
|
/* Clear remaining lines individually */
|
|
for( size_t i=scr->desired.line_count(); i < lines_with_stuff; i++ )
|
|
{
|
|
s_move( scr, &output, 0, (int)i );
|
|
s_write_mbs( &output, clr_eol);
|
|
}
|
|
}
|
|
|
|
s_move( scr, &output, scr->desired.cursor.x, scr->desired.cursor.y );
|
|
s_set_color( scr, &output, 0xffffffff);
|
|
|
|
if( ! output.empty() )
|
|
{
|
|
write_loop( 1, &output.at(0), output.size() );
|
|
}
|
|
|
|
/* We have now synced our actual screen against our desired screen. Note that this is a big assignment! */
|
|
scr->actual = scr->desired;
|
|
scr->last_right_prompt_width = right_prompt_width;
|
|
}
|
|
|
|
/** Returns true if we are using a dumb terminal. */
|
|
static bool is_dumb(void)
|
|
{
|
|
return ( !cursor_up || !cursor_down || !cursor_left || !cursor_right );
|
|
}
|
|
|
|
struct screen_layout_t {
|
|
/* The left prompt that we're going to use */
|
|
wcstring left_prompt;
|
|
|
|
/* How much space to leave for it */
|
|
size_t left_prompt_space;
|
|
|
|
/* The right prompt */
|
|
wcstring right_prompt;
|
|
|
|
/* The autosuggestion */
|
|
wcstring autosuggestion;
|
|
|
|
/* Whether the prompts get their own line or not */
|
|
bool prompts_get_own_line;
|
|
};
|
|
|
|
/* Given a vector whose indexes are offsets and whose values are the widths of the string if truncated at that offset, return the offset that fits in the given width. Returns width_by_offset.size() - 1 if they all fit. The first value in width_by_offset is assumed to be 0. */
|
|
static size_t truncation_offset_for_width(const std::vector<size_t> &width_by_offset, size_t max_width)
|
|
{
|
|
assert(width_by_offset.size() > 0 && width_by_offset.at(0) == 0);
|
|
size_t i;
|
|
for (i=1; i < width_by_offset.size(); i++)
|
|
{
|
|
if (width_by_offset.at(i) > max_width)
|
|
break;
|
|
}
|
|
/* i is the first index that did not fit; i-1 is therefore the last that did */
|
|
return i - 1;
|
|
}
|
|
|
|
static screen_layout_t compute_layout(screen_t *s,
|
|
size_t screen_width,
|
|
const wcstring &left_prompt_str,
|
|
const wcstring &right_prompt_str,
|
|
const wcstring &commandline,
|
|
const wcstring &autosuggestion_str,
|
|
const int *indent)
|
|
{
|
|
screen_layout_t result = {};
|
|
|
|
/* Start by ensuring that the prompts themselves can fit */
|
|
const wchar_t *left_prompt = left_prompt_str.c_str();
|
|
const wchar_t *right_prompt = right_prompt_str.c_str();
|
|
const wchar_t *autosuggestion = autosuggestion_str.c_str();
|
|
|
|
size_t left_prompt_width = calc_prompt_width( left_prompt );
|
|
size_t right_prompt_width = calc_prompt_width( right_prompt );
|
|
|
|
if (left_prompt_width + right_prompt_width >= screen_width)
|
|
{
|
|
/* Nix right_prompt */
|
|
right_prompt = L"";
|
|
right_prompt_width = 0;
|
|
}
|
|
|
|
if (left_prompt_width + right_prompt_width >= screen_width)
|
|
{
|
|
/* Still doesn't fit, neuter left_prompt */
|
|
left_prompt = L"> ";
|
|
left_prompt_width = 2;
|
|
}
|
|
|
|
/* Now we should definitely fit */
|
|
assert(left_prompt_width + right_prompt_width < screen_width);
|
|
|
|
|
|
/* Convert commandline to a list of lines and their widths */
|
|
wcstring_list_t command_lines(1);
|
|
std::vector<size_t> line_widths(1);
|
|
for (size_t i=0; i < commandline.size(); i++)
|
|
{
|
|
wchar_t c = commandline.at(i);
|
|
if (c == L'\n')
|
|
{
|
|
/* Make a new line */
|
|
command_lines.push_back(wcstring());
|
|
line_widths.push_back(indent[i]*INDENT_STEP);
|
|
}
|
|
else
|
|
{
|
|
command_lines.back() += c;
|
|
line_widths.back() += fish_wcwidth(c);
|
|
}
|
|
}
|
|
const size_t first_command_line_width = line_widths.at(0);
|
|
|
|
/* If we have more than one line, ensure we have no autosuggestion */
|
|
if (command_lines.size() > 1)
|
|
{
|
|
autosuggestion = L"";
|
|
}
|
|
|
|
/* Compute the width of the autosuggestion at all possible truncation offsets */
|
|
std::vector<size_t> autosuggestion_truncated_widths;
|
|
autosuggestion_truncated_widths.reserve(1 + wcslen(autosuggestion));
|
|
size_t autosuggestion_total_width = 0;
|
|
for (size_t i=0; autosuggestion[i] != L'\0'; i++)
|
|
{
|
|
autosuggestion_truncated_widths.push_back(autosuggestion_total_width);
|
|
autosuggestion_total_width += fish_wcwidth(autosuggestion[i]);
|
|
}
|
|
|
|
/* Here are the layouts we try in turn:
|
|
|
|
1. Left prompt visible, right prompt visible, command line visible, autosuggestion visible
|
|
2. Left prompt visible, right prompt visible, command line visible, autosuggestion truncated (possibly to zero)
|
|
3. Left prompt visible, right prompt hidden, command line visible, autosuggestion hidden
|
|
4. Newline separator (left prompt visible, right prompt visible, command line visible, autosuggestion visible)
|
|
*/
|
|
|
|
bool done = false;
|
|
|
|
/* Case 1 */
|
|
if (! done && left_prompt_width + right_prompt_width + first_command_line_width + autosuggestion_total_width + 10 < screen_width)
|
|
{
|
|
result.left_prompt = left_prompt;
|
|
result.left_prompt_space = left_prompt_width;
|
|
result.right_prompt = right_prompt;
|
|
result.autosuggestion = autosuggestion;
|
|
done = true;
|
|
}
|
|
|
|
/* Case 2. Note that we require strict inequality so that there's always at least one space between the left edge and the rprompt */
|
|
if (! done && left_prompt_width + right_prompt_width + first_command_line_width < screen_width)
|
|
{
|
|
result.left_prompt = left_prompt;
|
|
result.left_prompt_space = left_prompt_width;
|
|
result.right_prompt = right_prompt;
|
|
|
|
/* Need at least two characters to show an autosuggestion */
|
|
size_t available_autosuggestion_space = screen_width - (left_prompt_width + right_prompt_width + first_command_line_width);
|
|
if (autosuggestion_total_width > 0 && available_autosuggestion_space > 2)
|
|
{
|
|
size_t truncation_offset = truncation_offset_for_width(autosuggestion_truncated_widths, available_autosuggestion_space - 2);
|
|
result.autosuggestion = wcstring(autosuggestion, truncation_offset);
|
|
result.autosuggestion.push_back(ellipsis_char);
|
|
}
|
|
done = true;
|
|
}
|
|
|
|
/* Case 3 */
|
|
if (! done && left_prompt_width + first_command_line_width < screen_width)
|
|
{
|
|
result.left_prompt = left_prompt;
|
|
result.left_prompt_space = left_prompt_width;
|
|
done = true;
|
|
}
|
|
|
|
/* Case 4 */
|
|
if (! done)
|
|
{
|
|
result.left_prompt = left_prompt;
|
|
result.left_prompt_space = left_prompt_width;
|
|
result.right_prompt = right_prompt;
|
|
result.prompts_get_own_line = true;
|
|
done = true;
|
|
}
|
|
|
|
assert(done);
|
|
return result;
|
|
}
|
|
|
|
|
|
void s_write( screen_t *s,
|
|
const wcstring &left_prompt,
|
|
const wcstring &right_prompt,
|
|
const wcstring &commandline,
|
|
size_t explicit_len,
|
|
const int *colors,
|
|
const int *indent,
|
|
size_t cursor_pos )
|
|
{
|
|
screen_data_t::cursor_t cursor_arr;
|
|
|
|
CHECK( s, );
|
|
CHECK( indent, );
|
|
|
|
/* Turn the command line into the explicit portion and the autosuggestion */
|
|
const wcstring explicit_command_line = commandline.substr(0, explicit_len);
|
|
const wcstring autosuggestion = commandline.substr(explicit_len);
|
|
|
|
/*
|
|
If we are using a dumb terminal, don't try any fancy stuff,
|
|
just print out the text. right_prompt not supported.
|
|
*/
|
|
if( is_dumb() )
|
|
{
|
|
const std::string prompt_narrow = wcs2string( left_prompt );
|
|
const std::string command_line_narrow = wcs2string( explicit_command_line );
|
|
|
|
write_loop( 1, "\r", 1 );
|
|
write_loop( 1, prompt_narrow.c_str(), prompt_narrow.size() );
|
|
write_loop( 1, command_line_narrow.c_str(), command_line_narrow.size() );
|
|
|
|
return;
|
|
}
|
|
|
|
s_check_status( s );
|
|
const size_t screen_width = common_get_width();
|
|
|
|
/* Completely ignore impossibly small screens */
|
|
if( screen_width < 4 )
|
|
{
|
|
return;
|
|
}
|
|
|
|
/* Compute a layout */
|
|
const screen_layout_t layout = compute_layout(s, screen_width, left_prompt, right_prompt, explicit_command_line, autosuggestion, indent);
|
|
|
|
/* Clear the desired screen */
|
|
s->desired.resize(0);
|
|
s->desired.cursor.x = s->desired.cursor.y = 0;
|
|
|
|
/* Append spaces for the left prompt */
|
|
for (size_t i=0; i < layout.left_prompt_space; i++)
|
|
{
|
|
s_desired_append_char( s, L' ', 0, 0, layout.left_prompt_space );
|
|
}
|
|
|
|
/* If overflowing, give the prompt its own line to improve the situation. */
|
|
size_t first_line_prompt_space = layout.left_prompt_space;
|
|
if (layout.prompts_get_own_line)
|
|
{
|
|
s_desired_append_char( s, L'\n', 0, 0, 0 );
|
|
first_line_prompt_space = 0;
|
|
}
|
|
|
|
/* Reconstruct the command line */
|
|
wcstring effective_commandline = explicit_command_line + layout.autosuggestion;
|
|
|
|
/* Output the command line */
|
|
size_t i;
|
|
for( i=0; i < effective_commandline.size(); i++ )
|
|
{
|
|
int color = colors[i];
|
|
|
|
if( i == cursor_pos )
|
|
{
|
|
color = 0;
|
|
}
|
|
|
|
if( i == cursor_pos )
|
|
{
|
|
cursor_arr = s->desired.cursor;
|
|
}
|
|
|
|
s_desired_append_char( s, effective_commandline.at(i), color, indent[i], first_line_prompt_space );
|
|
}
|
|
if( i == cursor_pos )
|
|
{
|
|
cursor_arr = s->desired.cursor;
|
|
}
|
|
|
|
s->desired.cursor = cursor_arr;
|
|
s_update( s, layout.left_prompt.c_str(), layout.right_prompt.c_str());
|
|
s_save_status( s );
|
|
}
|
|
|
|
|
|
void s_write_OLD( screen_t *s,
|
|
const wchar_t *left_prompt,
|
|
const wchar_t *right_prompt,
|
|
const wchar_t *commandline,
|
|
size_t explicit_len,
|
|
const int *c,
|
|
const int *indent,
|
|
size_t cursor_pos )
|
|
{
|
|
screen_data_t::cursor_t cursor_arr;
|
|
|
|
int current_line_width = 0, newline_count = 0, explicit_portion_width = 0;
|
|
size_t max_line_width = 0;
|
|
|
|
CHECK( s, );
|
|
CHECK( left_prompt, );
|
|
CHECK( right_prompt, );
|
|
CHECK( commandline, );
|
|
CHECK( c, );
|
|
CHECK( indent, );
|
|
|
|
/*
|
|
If we are using a dumb terminal, don't try any fancy stuff,
|
|
just print out the text. right_prompt not supported.
|
|
*/
|
|
if( is_dumb() )
|
|
{
|
|
char *prompt_narrow = wcs2str( left_prompt );
|
|
char *buffer_narrow = wcs2str( commandline );
|
|
|
|
write_loop( 1, "\r", 1 );
|
|
write_loop( 1, prompt_narrow, strlen( prompt_narrow ) );
|
|
write_loop( 1, buffer_narrow, strlen( buffer_narrow ) );
|
|
|
|
free( prompt_narrow );
|
|
free( buffer_narrow );
|
|
|
|
return;
|
|
}
|
|
|
|
size_t left_prompt_width = calc_prompt_width( left_prompt );
|
|
size_t right_prompt_width = calc_prompt_width( right_prompt );
|
|
const size_t screen_width = common_get_width();
|
|
|
|
s_check_status( s );
|
|
|
|
/*
|
|
Ignore prompts wider than the screen - only print a two
|
|
character placeholder...
|
|
|
|
It would be cool to truncate the prompt, but because it can
|
|
contain escape sequences, this is harder than you'd think.
|
|
*/
|
|
if( left_prompt_width >= screen_width )
|
|
{
|
|
left_prompt = L"> ";
|
|
left_prompt_width = 2;
|
|
|
|
right_prompt = L"";
|
|
right_prompt_width = 0;
|
|
}
|
|
|
|
/*
|
|
Completely ignore impossibly small screens
|
|
*/
|
|
if( screen_width < 4 )
|
|
{
|
|
return;
|
|
}
|
|
|
|
/*
|
|
Check if we are overflowing
|
|
*/
|
|
size_t last_char_that_fits = 0;
|
|
for( size_t i=0; commandline[i]; i++ )
|
|
{
|
|
if( commandline[i] == L'\n' )
|
|
{
|
|
if( current_line_width > max_line_width )
|
|
max_line_width = current_line_width;
|
|
current_line_width = indent[i]*INDENT_STEP;
|
|
newline_count++;
|
|
}
|
|
else
|
|
{
|
|
int width = fish_wcwidth(commandline[i]);
|
|
current_line_width += width;
|
|
if (i < explicit_len)
|
|
explicit_portion_width += width;
|
|
|
|
if (left_prompt_width + current_line_width < screen_width)
|
|
last_char_that_fits = i;
|
|
}
|
|
}
|
|
if( current_line_width > max_line_width )
|
|
max_line_width = current_line_width;
|
|
|
|
s->desired.resize(0);
|
|
s->desired.cursor.x = s->desired.cursor.y = 0;
|
|
|
|
/* If we cannot fit with the autosuggestion, but we can fit without it, truncate the autosuggestion. We limit this check to just one line to avoid confusion; not sure how well this would work with multiple lines */
|
|
wcstring truncated_autosuggestion_line;
|
|
if (newline_count == 0 && left_prompt_width + right_prompt_width + max_line_width >= screen_width && left_prompt_width + explicit_portion_width < screen_width)
|
|
{
|
|
assert(screen_width - left_prompt_width >= 1);
|
|
max_line_width = screen_width - left_prompt_width - right_prompt_width - 1;
|
|
truncated_autosuggestion_line = wcstring(commandline, 0, last_char_that_fits - right_prompt_width);
|
|
truncated_autosuggestion_line.push_back(ellipsis_char);
|
|
commandline = truncated_autosuggestion_line.c_str();
|
|
}
|
|
for( size_t i=0; i<left_prompt_width; i++ )
|
|
{
|
|
s_desired_append_char( s, L' ', 0, 0, left_prompt_width );
|
|
}
|
|
|
|
/*
|
|
If overflowing, give the prompt its own line to improve the
|
|
situation.
|
|
*/
|
|
if( max_line_width + left_prompt_width >= screen_width )
|
|
{
|
|
s_desired_append_char( s, L'\n', 0, 0, 0 );
|
|
left_prompt_width = 0;
|
|
}
|
|
|
|
size_t i;
|
|
for( i=0; commandline[i]; i++ )
|
|
{
|
|
int col = c[i];
|
|
|
|
if( i == cursor_pos )
|
|
{
|
|
col = 0;
|
|
}
|
|
|
|
if( i == cursor_pos )
|
|
{
|
|
cursor_arr = s->desired.cursor;
|
|
}
|
|
|
|
s_desired_append_char( s, commandline[i], col, indent[i], left_prompt_width );
|
|
}
|
|
if( i == cursor_pos )
|
|
{
|
|
cursor_arr = s->desired.cursor;
|
|
}
|
|
|
|
s->desired.cursor = cursor_arr;
|
|
s_update( s, left_prompt, right_prompt);
|
|
s_save_status( s );
|
|
}
|
|
|
|
void s_reset( screen_t *s, bool reset_cursor, bool reset_prompt )
|
|
{
|
|
CHECK( s, );
|
|
|
|
/* If we're resetting the cursor, we must also be resetting the prompt */
|
|
assert(! reset_cursor || reset_prompt);
|
|
|
|
/* If we are resetting the cursor, we're going to make a new line and leave junk behind. If we are not resetting the cursor, we need to remember how many lines we had output to, so we can clear the remaining lines in the next call to s_update. This prevents leaving junk underneath the cursor when resizing a window wider such that it reduces our desired line count. */
|
|
if (! reset_cursor) {
|
|
s->actual_lines_before_reset = s->actual.line_count();
|
|
}
|
|
|
|
int prev_line = s->actual.cursor.y;
|
|
|
|
if (reset_prompt) {
|
|
/* If the prompt is multi-line, we need to move up to the prompt's initial line. We do this by lying to ourselves and claiming that we're really below what we consider "line 0" (which is the last line of the prompt). This will cause is to move up to try to get back to line 0, but really we're getting back to the initial line of the prompt. */
|
|
const size_t prompt_line_count = calc_prompt_lines(s->actual_left_prompt.c_str());
|
|
assert(prompt_line_count >= 1);
|
|
prev_line += (prompt_line_count - 1);
|
|
|
|
/* Clear the prompt */
|
|
s->actual_left_prompt.clear();
|
|
}
|
|
|
|
s->actual.resize(0);
|
|
s->actual.cursor.x = 0;
|
|
s->actual.cursor.y = 0;
|
|
s->need_clear=true;
|
|
|
|
if( !reset_cursor )
|
|
{
|
|
/*
|
|
This should prevent reseting the cursor position during the
|
|
next repaint.
|
|
*/
|
|
write_loop( 1, "\r", 1 );
|
|
s->actual.cursor.y = prev_line;
|
|
}
|
|
fstat( 1, &s->prev_buff_1 );
|
|
fstat( 2, &s->prev_buff_2 );
|
|
}
|
|
|
|
screen_t::screen_t() :
|
|
desired(),
|
|
actual(),
|
|
actual_left_prompt(),
|
|
last_right_prompt_width(),
|
|
actual_width(0),
|
|
soft_wrap_location(INVALID_LOCATION),
|
|
need_clear(false),
|
|
actual_lines_before_reset(0),
|
|
prev_buff_1(), prev_buff_2(), post_buff_1(), post_buff_2()
|
|
{
|
|
}
|
|
|