CharArrayWriter (Java Platform SE 8)

java.lang.Object
- java.io.Writer
- - java.io.CharArrayWriter

すべての実装されたインタフェース:

Closeable、Flushable、Appendable、AutoCloseable
```
public class CharArrayWriter
extends Writer
```
Writerとして使用する文字バッファを実装します。ストリームに文字が書き込まれるに従って、バッファは自動的に大きくなります。 toCharArray()やtoString()を使ってデータを取り出すことができます。
ノート: このクラスでclose()を呼び出しても、何も変化はありません。ストリームを閉じたあとにこのクラスのメソッドを呼び出しても、IOExceptionは生成されません。

導入されたバージョン:

JDK1.1

フィールドのサマリー

フィールド
修飾子と型フィールド説明

protected char[] buf
データが格納されるバッファです。

protected int count
バッファの中の文字数です。
- クラス java.io.Writerから継承されたフィールド
  lock

フィールド
修飾子と型	フィールド	説明
`protected char[]`	`buf`	データが格納されるバッファです。
`protected int`	`count`	バッファの中の文字数です。

コンストラクタのサマリー

コンストラクタ
コンストラクタ	説明
`CharArrayWriter()`	CharArrayWriterを新しく作成します。
`CharArrayWriter(int initialSize)`	指定された初期サイズでCharArrayWriterを新しく作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`CharArrayWriter`	`append(char c)`	指定された文字をこのライターに追加します。
`CharArrayWriter`	`append(CharSequence csq)`	指定された文字シーケンスをこのライターに追加します。
`CharArrayWriter`	`append(CharSequence csq, int start, int end)`	指定された文字シーケンスのサブシーケンスをこのライターに追加します。
`void`	`close()`	ストリームを閉じます。
`void`	`flush()`	ストリームをフラッシュします。
`void`	`reset()`	メモリー割当て済みのバッファを廃棄せずに再使用できるように、バッファをリセットします。
`int`	`size()`	バッファの現在のサイズを返します。
`char[]`	`toCharArray()`	入力データのコピーを返します。
`String`	`toString()`	入力データを文字列に変換します。
`void`	`write(char[] c, int off, int len)`	バッファに文字を書き込みます。
`void`	`write(int c)`	バッファに単一の文字を書き込みます。
`void`	`write(String str, int off, int len)`	文字列の一部をバッファに書き込みます。
`void`	`writeTo(Writer out)`	バッファの内容を別の文字ストリームに書き込みます。

クラス java.io.Writerから継承されたメソッド
write, write

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - buf
```
protected char[] buf
```
    データが格納されるバッファです。
  - count
```
protected int count
```
    バッファの中の文字数です。
- コンストラクタの詳細
  - CharArrayWriter
```
public CharArrayWriter()
```
    CharArrayWriterを新しく作成します。
  - CharArrayWriter
```
public CharArrayWriter(int initialSize)
```
    指定された初期サイズでCharArrayWriterを新しく作成します。
    
    パラメータ:
    
    initialSize - バッファの初期サイズを指定するint。
    
    例外:
    
    IllegalArgumentException - initialSizeが負の値の場合
- メソッドの詳細
  - write
```
public void write(int c)
```
    バッファに単一の文字を書き込みます。
    
    オーバーライド:
    
    write、クラスWriter
    
    パラメータ:
    
    c - 書き込まれる文字を指定するint
  - write
```
public void write(char[] c,
                  int off,
                  int len)
```
    バッファに文字を書き込みます。
    
    定義:
    
    write、クラスWriter
    
    パラメータ:
    
    c - 書き込まれるデータ
    
    off - データ内の開始オフセット
    
    len - 書き込む文字数
  - write
```
public void write(String str,
                  int off,
                  int len)
```
    文字列の一部をバッファに書き込みます。
    
    オーバーライド:
    
    write、クラスWriter
    
    パラメータ:
    
    str - 書き込まれる文字列
    
    off - 文字の読込み開始オフセット
    
    len - 書き込む文字数
  - writeTo
```
public void writeTo(Writer out)
             throws IOException
```
    バッファの内容を別の文字ストリームに書き込みます。
    
    パラメータ:
    
    out - 書込み先の出力ストリーム
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - append
```
public CharArrayWriter append(CharSequence csq)
```
    指定された文字シーケンスをこのライターに追加します。
    このメソッドをout.append(csq)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。
```
     out.write(csq.toString()) 
```
    文字シーケンスcsqに対するtoStringの指定に応じて、シーケンス全体が追加されないこともあります。たとえば、文字バッファのtoStringメソッドを呼び出した場合、返されるサブシーケンスの内容はそのバッファの位置とリミットによって決まります。
    定義:
    
    append、インタフェースAppendable
    
    オーバーライド:
    
    append、クラスWriter
    
    パラメータ:
    
    csq - 追加する文字シーケンス。 csqがnullの場合は、このライターに「null」という4文字が追加される。
    
    戻り値:
    
    このライター
    
    導入されたバージョン:
    
    1.5
  - append
```
public CharArrayWriter append(CharSequence csq,
                              int start,
                              int end)
```
    指定された文字シーケンスのサブシーケンスをこのライターに追加します。
    csqがnullでないときに、このメソッドをout.append(csq, start, end)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。
```
     out.write(csq.subSequence(start, end).toString()) 
```
    定義:
    
    append、インタフェースAppendable
    
    オーバーライド:
    
    append、クラスWriter
    
    パラメータ:
    
    csq - サブシーケンスの追加元の文字シーケンス。 csqがnullの場合は、csqに「null」という4文字が含まれているかのように文字が追加される。
    
    start - サブシーケンスの最初の文字のインデックス
    
    end - サブシーケンスの最後の文字のあとに続く文字のインデックス
    
    戻り値:
    
    このライター
    
    例外:
    
    IndexOutOfBoundsException - startまたはendが負の値の場合、startがendよりも大きい場合、あるいはendがcsq.length()よりも大きい場合
    
    導入されたバージョン:
    
    1.5
  - append
```
public CharArrayWriter append(char c)
```
    指定された文字をこのライターに追加します。
    このメソッドをout.append(c)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。
```
     out.write(c) 
```
    定義:
    
    append、インタフェースAppendable
    
    オーバーライド:
    
    append、クラスWriter
    
    パラメータ:
    
    c - 追加する16ビット文字
    
    戻り値:
    
    このライター
    
    導入されたバージョン:
    
    1.5
  - reset
```
public void reset()
```
    メモリー割当て済みのバッファを廃棄せずに再使用できるように、バッファをリセットします。
  - toCharArray
```
public char[] toCharArray()
```
    入力データのコピーを返します。
    
    戻り値:
    
    この入力データからコピーされた文字の配列。
  - size
```
public int size()
```
    バッファの現在のサイズを返します。
    
    戻り値:
    
    バッファの現在のサイズを表すint。
  - toString
```
public String toString()
```
    入力データを文字列に変換します。
    
    オーバーライド:
    
    toString、クラスObject
    
    戻り値:
    
    文字列。
  - flush
```
public void flush()
```
    ストリームをフラッシュします。
    
    定義:
    
    flush、インタフェースFlushable
    
    定義:
    
    flush、クラスWriter
  - close
```
public void close()
```
    ストリームを閉じます。このメソッドの内容は以降も要求されるので、バッファは解放されません。ノート: このクラスのこのメソッドを呼び出しても、何の効果もありません。
    
    定義:
    
    close、インタフェースCloseable
    
    定義:
    
    close、インタフェースAutoCloseable
    
    定義:
    
    close、クラスWriter

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスCharArrayWriter

フィールドのサマリー

クラス java.io.Writerから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.io.Writerから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

buf

count

コンストラクタの詳細

CharArrayWriter

CharArrayWriter

メソッドの詳細

write

write

write

writeTo

append

append

append

reset

toCharArray

size

toString

flush

close