It's a bit difficult to answer a question about the complexity of this code when it is written at a high level which abstracts away the details of the implementation. The Java documentation doesn't seem to give any guarantees in terms of the complexity of the append
function. As others have pointed out, the StringBuffer
class can (and should) be written so that the complexity of appending strings does not depend on the current length of the string held in StringBuffer
.
However, I suspect it is not that helpful to the person asking this question to simply say "your book is wrong!" - instead, let us see what assumptions are being made and make clear what the author was trying to say.
You can make the following assumptions:
- Creating a
new StringBuffer
is O(1)
- Getting the next string
w
in words
is O(1)
- Returning
sentence.toString
is at most O(n).
The question is really what is the order of sentence.append(w)
, and that depends on how it happens inside the StringBuffer
. The naive way is to do it like Shlemiel the Painter.
The silly way
Suppose you use a C-style null-terminated string for the contents of StringBuffer
. The way you find the end of such a string is by reading each character, one by one, until you find the null character - then to append a new string S, you can start copying characters from S to the StringBuffer
string (finishing with another null character). If you write append
this way, it is O(a + b), where a is the number of characters currently in the StringBuffer
, and b is the number of characters in the new word. If you loop over an array of words, and each time you have to read all the characters you just appended before appending the new word, then the complexity of the loop is O(n^2), where n is the total number of characters in all the words (also the number of characters in the final sentence).
A better way
On the other hand, suppose that the contents of StringBuffer
is still an array of characters, but we also store an integer size
which tells us how long the string is (number of characters). Now we no longer have to read every character in the StringBuffer
in order to find the end of the string; we can just look up index size
in the array, which is O(1) instead of O(a). Then the append
function now only depends on the number of characters being appended, O(b). In this case the complexity of the loop is O(n), where n is the total number of characters in all the words.
...We're not done yet!
Finally, there's one more aspect of the implementation that hasn't been covered yet, and that is the one actually brought up by the answer in the textbook - memory allocation. Each time you want to write more characters to your StringBuffer
, you're not guaranteed to have enough space in your character array to actually fit the new word in. If there isn't enough space, your computer needs to first allocate some more room in a clean section of memory, and then copy all the information in the old StringBuffer
array across, and then it can continue as before. Copying data like this will take O(a) time (where a is the number of characters to be copied).
In the worst case, you have to allocate more memory every time you add a new word. This basically takes us back to square one where the loop has O(n^2) complexity, and is what the book seems to suggest. If you assume that nothing crazy is happening (the words aren't getting longer at an exponential rate!), then you can probably reduce the number of memory allocations to something more like O(log(n)) by having the allocated memory grow exponentially. If that's the number of memory allocations, and memory allocations in general are O(a), then the total complexity attributed just to memory management in the loop is O(n log(n)). Since the appending work is O(n) and less than the complexity of the memory management, the total complexity of the function is O(n log(n)).
Again, the Java documentation doesn't help us in terms of how the capacity of the StringBuffer
grows, it just says "If the internal buffer overflows, it is automatically made larger". Depending on how it happens, you could end up with either O(n^2) or O(n log(n)) overall.
As an exercise left to the reader: Find an easy way to modify the function so that the overall complexity is O(n), by removing memory reallocation issues.