Python の「help()」出力のスラッシュはメソッド シグネチャにとって何を意味しますか?

メソッド署名の Python ヘルプ出力のスラッシュについて

Python の help() 関数を使用すると、メソッドの出力にスラッシュが表示される場合があります署名。この記事では、この記号の意味をわかりやすく説明し、その重要性についての洞察を提供します。

位置限定パラメータ

スラッシュ (/) は、位置限定パラメータの終わりを示します。メソッド シグネチャ内。これらはキーワード引数として渡すことができないパラメータです。つまり、適切な順序で指定する必要があります。 Python 3.8 より前では、位置のみのパラメーターは C API に制限されていました。

例: contains メソッド

たとえば、ヘルプ範囲オブジェクトの __contains__ メソッドの出力のスラッシュは、キー引数が次の方法でのみ提供できることを示します。 Position:

>>> help(range.__contains__)
...
__contains__(self, key, /)
    Return key in self.
...

これは、key 引数はposition: range(5).__contains__(3) で渡す必要があるため、range(5).__contains__(key=3) などの構文が無効であることを意味します。 .

議論クリニックのドキュメント

議論クリニックのドキュメントでさらに詳しく説明されています。

引数クリニックですべてのパラメータを位置専用としてマークするには、最後のパラメータの後の行に / を単独で追加し、パラメータ行と同じようにインデントします。

Python FAQ と PEP 570

最近、Python FAQ でも位置のみについて取り上げられました。パラメータ:

関数の引数リスト内のスラッシュは、その前のパラメータが位置のみであることを示します。

さらに、PEP 570 は、位置のみのパラメータの構文を Python に成文化しました。バージョン 3.8 の言語仕様。

位置限定の利点パラメータ

位置のみのパラメータを使用すると、次のような利点があります。

• より明確な API: パラメータの順序付けが強制され、コードが読みやすくなり、コードが読みやすくなり、コードが読みやすくなり、コードが読みやすくなります。エラー。
• 一貫性の向上: C のみのモジュールの Pure-Python 実装は、より一貫性があり、保守しやすくなります。
• パフォーマンス: 位置のみのパラメーターに必要な処理が少なくなり、コードの実行速度が向上します。

以上がPython の「help()」出力のスラッシュはメソッド シグネチャにとって何を意味しますか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。