2 * Jexer - Java Text User Interface
4 * The MIT License (MIT)
6 * Copyright (C) 2017 Kevin Lamonte
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
23 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
24 * DEALINGS IN THE SOFTWARE.
26 * @author Kevin Lamonte [kevin.lamonte@gmail.com]
29 package jexer
.teditor
;
31 import java
.util
.ArrayList
;
32 import java
.util
.List
;
35 * A Line represents a single line of text on the screen, as a collection of
43 private ArrayList
<Word
> words
= new ArrayList
<Word
>();
46 * The current cursor position on this line.
51 * The current word that the cursor position is in.
53 private Word currentWord
;
56 * We use getDisplayLength() a lot, so cache the value.
58 private int displayLength
= -1;
61 * Get a (shallow) copy of the list of words.
63 * @return the list of words
65 public List
<Word
> getWords() {
66 return new ArrayList
<Word
>(words
);
70 * Get the on-screen display length.
72 * @return the number of cells needed to display this line
74 public int getDisplayLength() {
75 if (displayLength
!= -1) {
79 for (Word word
: words
) {
80 n
+= word
.getDisplayLength();
87 * Construct a new Line from an existing text string.
89 * @param str the text string
91 public Line(final String str
) {
92 currentWord
= new Word();
93 words
.add(currentWord
);
94 for (int i
= 0; i
< str
.length(); i
++) {
95 char ch
= str
.charAt(i
);
96 Word newWord
= currentWord
.addChar(ch
);
97 if (newWord
!= currentWord
) {
99 currentWord
= newWord
;
105 * Decrement the cursor by one. If at the first column, do nothing.
115 * Increment the cursor by one. If at the last column, do nothing.
117 public void right() {
118 if (cursorX
== getDisplayLength() - 1) {
125 * Go to the first column of this line.
132 * Go to the last column of this line.
139 * Delete the character under the cursor.
146 * Delete the character immediately preceeding the cursor.
148 public void backspace() {
153 * Replace or insert a character at the cursor, depending on overwrite
156 * @param ch the character to replace or insert
158 public void addChar(final char ch
) {