软弃用

尚无计划移除 soft deprecated API。

  • 现在 re.match() 和 re.Pattern.match() 已被设为 soft deprecated 而应改用新的 re.prefixmatch() 和 re.Pattern.prefixmatch() API,它们作为替代性的、更明白的显式名称被添加进来。 这样做的目的是为了遵循 Python 之禅的 "明白胜于隐晦" 原则以消除对 match 具体含义理解所造成的混淆。 大多数其他语言的正则表达式库都使用名为 match 的 API 来表示to mean what Python 一直以来所称为的 search。

    我们 没有 计划移除旧的 match() 名称,因为它已在代码中使用超过 30。 支持较旧 Python 的代码应当继续使用 match(),而新的代码应当首选 prefixmatch()。 参见 prefixmatch() vs. match()。

    (由 Gregory P. Smith 在 gh-86519 以及 Hugo van Kemenade 在 gh-148100 中贡献。)

  • 使用 struct 模块的 'F' 和 'D' 格式类型代码的做法现在已被设为 soft deprecated 并应改用两字母形式 'Zf' 和 'Zd'。 (由 Sergey B Kirpichev 在 gh-121249 中贡献。)