blocks|key|4605711|text|将其更改为属性方法。|type|unstyled|depth|inlineStyleRanges|entityRanges|data|4605712|entityMap^0|0^^$0|@$1|2|3|4|5|6|7|D|8|@]|9|@]|A|$]]|$1|B|3|-4|5|6|7|E|8|@]|9|@]|A|$]]]|C|$]]

Change it into a property method.

blocks|key|4605737|text|属性文档字符串上的PEP+224被拒绝了(很久以前)，所以这对我来说也是一个问题，有时我不知道是选择一个类属性还是实例属性--第二个属性可以有一个文档字符串。|type|unstyled|depth|inlineStyleRanges|entityRanges|offset|length|data|4605738|entityMap|0|LINK|mutability|MUTABLE|url|http://www.python.org/dev/peps/pep-0224/^0|9|7|0|0^^$0|@$1|2|3|4|5|6|7|L|8|@]|9|@$A|M|B|N|1|O]]|C|$]]|$1|D|3|-4|5|6|7|P|8|@]|9|@]|C|$]]]|E|$F|$5|G|H|I|C|$J|K]]]]

The <a href="http://www.python.org/dev/peps/pep-0224/" rel="nofollow noreferrer">PEP 224</a> on attribute docstrings was rejected (long time ago), so this is a problem for me as well, sometimes I don't know to choose a class attribute or an instance property -- the second can have a docstring.

blocks|key|4605759|text|如下所示：|type|unstyled|depth|inlineStyleRanges|entityRanges|data|4605760|class+MP3FileInfo(FileInfo):
++++"""Store+ID3v1.0+MP3+tags."""

++++@property+
++++def+tagDataMap(self):
++++++++"""This+function+computes+map+of+tags.

++++++++The+amount+of+work+necessary+to+compute+is+quite+large,+therefore
++++++++we+memoize+the+result.

++++++++"""
++++++++...|code-block|syntax|javascript|4605761|但是请注意，如果属性只有一行描述，那么您确实不应该创建单独的文档字符串。相反，您可以使用|4605762|class+MP3FileInfo(FileInfo):
++++"""Store+ID3v1.0+MP3+tags.

++++Here+are+the+attributes:
++++++++tagDataMap+--+contains+a+map+of+tags

++++"""

++++tagDataMap+=+...|4605763|entityMap^0|0|0|0|0^^$0|@$1|2|3|4|5|6|7|M|8|@]|9|@]|A|$]]|$1|B|3|C|5|D|7|N|8|@]|9|@]|A|$E|F]]|$1|G|3|H|5|6|7|O|8|@]|9|@]|A|$]]|$1|I|3|J|5|D|7|P|8|@]|9|@]|A|$E|F]]|$1|K|3|-4|5|6|7|Q|8|@]|9|@]|A|$]]]|L|$]]

Do it like this:

<pre><code>class MP3FileInfo(FileInfo):
 """Store ID3v1.0 MP3 tags."""

 @property 
 def tagDataMap(self):
 """This function computes map of tags.

 The amount of work necessary to compute is quite large, therefore
 we memoize the result.

 """
 ...
</code></pre>

Note though you really shouldn't make a separate docstring if the attribute has only a one-line description. Instead, use 

<pre><code>class MP3FileInfo(FileInfo):
 """Store ID3v1.0 MP3 tags.

 Here are the attributes:
 tagDataMap -- contains a map of tags

 """

 tagDataMap = ...
</code></pre>

Following sample is taken from "Dive into python" book.

<pre><code>class MP3FileInfo(FileInfo):
 "store ID3v1.0 MP3 tags"
 tagDataMap = ...
</code></pre>

This sample shows documenting the MP3FileInfo, but how can I add help to MP3FileInfo. tagDataMap

Documenting class attribute

翻译质量差，导致语言生硬或混乱。

没有提供实际的解决方法或示例。

解答不清晰，无法理解或解决问题。

页面排版不美观，阅读体验差。

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

以下示例取自"Dive into python“一书。class MP3FileInfo(FileInfo):    "store ID3v1.0 MP3 tags"    tagDataMap = ...此示例显示了MP3FileInfo文档，但如何向MP3FileInfo添加帮助。tagDataMap

问记录类属性
EN

Stack Overflow用户

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

问记录类属性EN