append(String str)API中文说明

叁歲伎倆 2022-05-18 09:14 180阅读 0赞

/\*\*append(String str)API中文说明 
  public AbstractStringBuilder append(String str) \{ 
        if (str == null) str = "null"; 
        int len = str.length(); 
        ensureCapacityInternal(count + len); 
        str.getChars(0, len, value, count); 
        count += len; 
        return this; 
    \} 
     \* Appends the specified string to this character sequence. 
       将一个特定的字符串追加到当前的字符序列当中 
     \* 
     \* The characters of the \{@code String\} argument are appended, in 
       参数String中那些字符会挨个的被追加到字符序列中 
     \* order, increasing the length of this sequence by the length of the 
       这会增加当前字符序列的长度,增加的长度为参数的长度 
     \* argument. If \{@code str\} is \{@code null\}, then the four 
       如果参数是null的话,那么四个 
     \* characters \{@code "null"\} are appended. 
       字符null会被追加到当前字符序列当中 
     \* 
     \* Let n be the length of this character sequence just prior to 
       在执行append方法之前,假定n是这个字符串序列的长度, 
     \* execution of the \{@code append\} method. Then the character at 
       那么,在新字符序列中索引k对应的字符等于旧字符序列中的索引k对应的字符 
     \* index k in the new character sequence is equal to the character 
     \* at index k in the old character sequence, if k is less 
       如果k比n小的话 
     \* than n; otherwise, it is equal to the character at index 
       反之,如果k比n大的话,那么新字符序列中索引k对应的字符等于参数str中索引k-n对应的字符 
     \* k-n in the argument \{@code str\}. 
     \* 
     \* @param   str   a string. 
     \* @return  a reference to this object. 
     \*/ 
    
     注: 
        设旧序列的长度为n 
        设新序列的键为k 
        这里还有一个添加序列 
        k值是从0开始的,递1增的 
        当k<n时 
        新序列\[k\]=旧序列\[k\] 
        当k>=n是 
        新序列\[k\]=添加列\[k-n\]