[Java StringBuffer] length(), capacity(), ensureCapacity(), setLength(), trimToSize() – 길이와 버퍼 관리

StringBuffer는 가변적인 문자열을 다루기 때문에 내부적으로 버퍼(capacity)를 사용합니다.
따라서 문자열의 길이(length)와 버퍼 용량(capacity)을 구분해서 관리해야 하며, 이를 위한 다양한 메서드가 제공됩니다.

 

1. length() – 현재 문자열 길이

public synchronized int length()

• 실제 문자열의 길이를 반환

StringBuffer sb = new StringBuffer("Hello");
System.out.println(sb.length()); // 5

👉 문자열 "Hello"의 길이는 5.

 

2. capacity() – 버퍼 용량 확인

public synchronized int capacity()

• 내부 버퍼의 총 크기를 반환 (현재 문자열보다 클 수 있음)

StringBuffer sb = new StringBuffer("Hello");
System.out.println(sb.capacity()); // 기본 21 (16 + "Hello".length())

👉 StringBuffer는 여유 공간을 확보해두기 때문에 실제 길이보다 용량이 큽니다.

 

3. ensureCapacity() – 버퍼 확장 예약

public synchronized void ensureCapacity(int minimumCapacity)

• 최소한 minimumCapacity 이상의 용량을 확보
• 현재 용량이 부족하면 (기존 용량 × 2 + 2) 또는 minimumCapacity 중 더 큰 값으로 확장

StringBuffer sb = new StringBuffer();
System.out.println("초기 용량: " + sb.capacity()); // 16

sb.ensureCapacity(50);
System.out.println("확보 후 용량: " + sb.capacity()); // 50 이상

👉 대량의 문자열을 추가할 예정이라면 미리 용량을 확보해 성능 저하를 줄일 수 있습니다.

 

4. setLength() – 문자열 길이 강제 조정

public synchronized void setLength(int newLength)

• 문자열 길이를 newLength로 강제로 설정
• 줄이면 문자열이 잘리고, 늘리면 \u0000(널 문자)로 채워짐

StringBuffer sb = new StringBuffer("Hello World");
sb.setLength(5);
System.out.println(sb.toString()); // Hello

👉 문자열을 잘라내거나 초기화할 때 유용합니다.

 

5. trimToSize() – 버퍼 최적화

public synchronized void trimToSize()

• 현재 문자열 길이에 맞게 버퍼 용량을 줄임

StringBuffer sb = new StringBuffer(100);
sb.append("Java");
System.out.println("용량: " + sb.capacity()); // 100 이상

sb.trimToSize();
System.out.println("최적화 후 용량: " + sb.capacity()); // 4

👉 불필요하게 큰 버퍼를 줄여 메모리를 절약할 수 있습니다.

 

6. 정리

• length() → 문자열 실제 길이
• capacity() → 내부 버퍼 용량
• ensureCapacity(n) → 최소 용량 확보 (성능 최적화)
• setLength(n) → 길이 강제 조정 (잘라내거나 늘림)
• trimToSize() → 불필요한 버퍼 제거

 

🔑 한 줄 정리
👉 StringBuffer는 문자열 길이와 버퍼 용량을 따로 관리하므로, 상황에 맞게 최적화 메서드를 활용해야 한다!