Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】bytearray::__new__()メソッドの使い方

__new__メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__new__メソッドは、Pythonにおいて新しいbytearrayオブジェクトを生成するメソッドです。bytearrayは、変更可能なバイトのシーケンスを表現し、一度作成された後も内容を自由に書き換えられる点が特徴です。

このメソッドは、引数の種類に応じて多様な方法でbytearrayのインスタンスを初期化します。具体的には、以下のような引数を受け取ることができます。

  • 整数: 指定されたサイズのバイト配列を生成し、すべての要素をゼロで埋めます。例えば、bytearray(10)は10バイトのゼロ埋め配列を作成します。
  • イテラブル: 0から255の範囲の整数を含むイテラブル(リストやタプルなど)を渡すと、その整数の並びを要素とするbytearrayを生成します。
  • 文字列: 文字列を渡す場合は、エンコーディング(例: 'utf-8')を指定する必要があります。文字列をそのエンコーディングでバイト列に変換し、bytearrayとして初期化します。
  • 既存のバイトオブジェクト: 別のbytesオブジェクトやbytearrayオブジェクトを渡すと、その内容をコピーした新しいbytearrayインスタンスを作成します。

__new__メソッドは、実際にオブジェクトのメモリを確保し、初期値を設定して、その新しいbytearrayインスタンスを返します。これにより、ネットワーク通信で受け取ったバイナリデータの加工や、ファイルから読み込んだデータを部分的に書き換えるといった、バイトレベルでの柔軟なデータ操作が求められる状況でbytearrayを効果的に活用できます。

構文(syntax)

1bytearray("文字列データ", "utf-8")

引数(parameters)

source: int | bytes | bytearray | memoryview | Iterable[int] | str | None = None, encoding: str | None = None, errors: str = 'strict'

  • source: int | bytes | bytearray | memoryview | Iterable[int] | str | None = None: 新しいbytearrayオブジェクトの初期化に使用するソースデータ。整数、バイト列、bytearray、memoryview、整数シーケンス、文字列、またはNoneを指定できます。
  • encoding: str | None = None: sourceが文字列の場合に使用されるエンコーディング。
  • errors: str = 'strict': sourceが文字列で、エンコーディングエラーが発生した場合の処理方法。

戻り値(return)

bytearray

bytearrayオブジェクトを生成して返します。

関連コンテンツ