Elixir 1.3.0:缺少String.strip / 1和String.strip / 2 API文档。

时间:2016-06-28 10:12:13

标签: elixir

似乎Elixir 1.3.0不再显示String.strip / 1和String.strip / 2的文档:

iex(1)> h String.strip
No documentation for String.strip was found

在当前的在线文档(v1.3,Master,Stable)中也缺少它们,但编译器仍然可以识别这些函数:

iex(2)> String.strip("   Hallo, World!   ")
"Hallo, World!"

所以我想知道这是否只是String文档中的一个错误,或者这些函数是否会被弃用。我找不到任何更好的信息谷歌搜索。

1 个答案:

答案 0 :(得分:16)

这些功能已被软弃用。这意味着它们已被标记为@doc false。目前计划是deprecate with warnings by 1.5

https://github.com/elixir-lang/elixir/blob/v1.3/CHANGELOG.md#3-soft-deprecations-no-warnings-emitted

  

[String]令人困惑的String.strip / 2,String.lstrip / 2和String.rstrip / 2 API已被软推荐使用,转而使用String.trim / 2,String.trim_leading / 2和String.trim_trailing / 2