Renamed CuttableString to more generic String2.
[svjatoslav_commons.git] / src / main / java / eu / svjatoslav / commons / string / String2.java
1 /*
2  * Svjatoslav Commons - shared library of common functionality.
3  * Copyright ©2012-2014, Svjatoslav Agejenko, svjatoslav@svjatoslav.eu
4  * 
5  * This program is free software; you can redistribute it and/or
6  * modify it under the terms of version 3 of the GNU Lesser General Public License
7  * or later as published by the Free Software Foundation.
8  */
9
10 package eu.svjatoslav.commons.string;
11
12 import java.util.Vector;
13
14 public class String2 {
15
16         private final Vector<Character> chars = new Vector<Character>();
17
18         public String2(final String value) {
19                 for (final Character c : value.toCharArray())
20                         chars.add(c);
21         }
22
23         public String2 addPrefix(final String prefix) {
24                 int j = 0;
25                 for (final char c : prefix.toCharArray())
26                         chars.insertElementAt(c, j++);
27
28                 return this;
29         }
30
31         public String2 addSuffix(final String suffix) {
32                 for (final char c : suffix.toCharArray())
33                         chars.add(c);
34
35                 return this;
36         }
37
38         /**
39          * Cut given amount of characters from the left of the string. Return cutted
40          * part.
41          */
42         public String cutLeft(final int cutAmount) {
43
44                 int actualCutAmount = cutAmount;
45
46                 if (actualCutAmount > getLength())
47                         actualCutAmount = getLength();
48
49                 final String result = getSubString(0, actualCutAmount);
50
51                 chars.subList(0, actualCutAmount).clear();
52
53                 return result;
54         }
55
56         public void enforceLength(final int targetLength) {
57                 if (getLength() > targetLength)
58                         chars.subList(targetLength, getLength()).clear();
59                 else if (getLength() < targetLength) {
60                         final int charactersToAdd = targetLength - getLength();
61                         for (int i = 0; i < charactersToAdd; i++)
62                                 chars.add(' ');
63                 }
64         }
65
66         public int getLength() {
67                 return chars.size();
68         }
69
70         public String getSubString(final int startInclusive, final int endExclusive) {
71                 final char[] charArray = new char[endExclusive - startInclusive];
72
73                 int j = 0;
74                 for (int i = startInclusive; i < endExclusive; i++) {
75                         charArray[j] = chars.get(i);
76                         j++;
77                 }
78                 return new String(charArray);
79         }
80
81         public boolean isEmpty() {
82                 return chars.size() == 0;
83         }
84
85         @Override
86         public String toString() {
87                 return getSubString(0, chars.size());
88         }
89 }