查看“可调用对象列表/core.utils.petal”的源代码

此部分为机器人的[[花瓣]]功能相关。

若[[配置文件]]中 <code>enable_petal</code> 为 <code>False</code>，将无法正常使用这些对象。

== ''async def'' <code>gained_petal</code> ==
<syntaxhighlight lang="py3">
gained_petal(msg: Bot.MessageSession, amount: int)
</syntaxhighlight>
参数：
* <code>msg</code>：消息会话。
* {{Instructor param|amount|int}}：增加的花瓣数量。
返回：增加花瓣的提示消息。

此异步函数可以增加用户的花瓣数量。

== ''async def'' <code>lost_petal</code> ==
<syntaxhighlight lang="py3">
lost_petal(msg: Bot.MessageSession, amount: int)
</syntaxhighlight>
参数：
* <code>msg</code>：消息会话。
* {{Instructor param|amount|int}}：减少的花瓣数量。
返回：减少花瓣的提示消息。

此异步函数可以减少用户的花瓣数量。

== ''async def'' <code>cost_petal</code> ==
<syntaxhighlight lang="py3">
cost_petal(msg: Bot.MessageSession, amount: int) -> bool
</syntaxhighlight>
参数：
* <code>msg</code>：消息会话。
* {{Instructor param|amount|int}}：花费的花瓣数量。
返回：是否成功处理花瓣花费。

此异步函数可以处理用户花费的花瓣数量。