組み込み定数¶
組み込み名前空間にはいくつかの定数があります。定数の一覧:
- False¶
bool型の偽値です。Falseへの代入は不正で、SyntaxErrorを送出します。
- True¶
bool型の真値です。Trueへの代入は不正で、SyntaxErrorを送出します。
- None¶
関数にデフォルト引数が渡されなかった場合など、値が存在しないことを表すためによく使われるオブジェクトです。
Noneへの代入は不正で、SyntaxErrorを送出します。NoneはNoneType型の唯一のインスタンスです。
- NotImplemented¶
二項演算の特殊メソッド (例えば
__eq__()、__lt__()、__add__()、__rsub__()など) が、 もう一方の型に対する演算を実装していないことを示すために返すべき特殊な値です。 インプレースの二項演算の特殊メソッド (例えば__imul__()、__iand__()など) も、同じ目的でこの値を返せます。 真偽値として評価してはいけません。NotImplementedはtypes.NotImplementedType型の唯一のインスタンスです。注釈
二項演算 (またはインプレース演算) のメソッドが
NotImplementedを返した場合、 インタープリタはもう一方の型に定義された対の演算を試みます (演算子によっては別の代替手段を試みます)。 すべての試行がNotImplementedを返した場合、インタープリタは適切な例外を送出します。 誤ってNotImplementedを返すと、誤解を招くエラーメッセージが表示されたり、NotImplementedの値が Python コードに返されたりします。例として 算術演算の実装 を参照してください。
注意
NotImplementedとNotImplementedErrorは互いに置き換えられません。 この定数は、上で説明した用途にのみ使ってください。 例外の正しい使い方についてはNotImplementedErrorを参照してください。バージョン 3.9 で変更:
NotImplementedを真偽値として評価することは非推奨となりました。バージョン 3.14 で変更:
NotImplementedを真偽値として評価すると、TypeErrorが送出されるようになりました。 以前はTrueと評価され、Python 3.9 以降ではDeprecationWarningも発生していました。
- Ellipsis¶
省略を示すリテラル "
..." と同じオブジェクトで、何かが省略されていることを示すためによく使われます。Ellipsisには代入できますが、...に代入するとSyntaxErrorが送出されます。Ellipsisはtypes.EllipsisType型の唯一のインスタンスです。
注釈
名前 None 、 False 、 True 、 __debug__ は再代入できない (これらに対する代入は、たとえ属性名としてであっても SyntaxError が送出されます) ので、これらは「真の」定数であると考えられます。
site モジュールで追加される定数¶
site モジュール (-S コマンドラインオプションが指定されない限り、スタートアップ時に自動的にインポートされます) は組み込み名前空間にいくつかの定数を追加します。それらは対話的インタープリタシェルで有用ですが、プログラム中では使うべきではありません。
- quit(code=None)¶
- exit(code=None)¶
表示すると "Use quit() or Ctrl-D (i.e. EOF) to exit" のようなメッセージを表示するオブジェクトです。 対話型インタープリタで直接入力するか、関数として呼び出すと、指定した終了コードで
SystemExitを送出します。
- help
表示すると "Type help() for interactive help, or help(object) for help about object." というメッセージを表示するオブジェクトです。 対話型インタープリタで直接入力すると、組み込みヘルプシステムを起動します (
help()を参照してください)。
- license¶
表示されたときに "Type license() to see the full license text" というメッセージを表示し、呼び出されたときには完全なライセンスのテキストをページャのような形式で (1画面分づつ) 表示するオブジェクトです。