string remove first

关于标准库...

我们相信未来网络将成为数值计算的首选环境。为了帮助实现这个未来，我们构建了 stdlib。 stdlib 是一个标准库，重点是数值和科学计算，用 JavaScript（和 C）编写，可在浏览器和 Node.js 中执行。

该库是完全可分解的，其架构使得您可以交换、混合和匹配 API 和功能，以满足您的确切偏好和用例。

当您使用 stdlib 时，您可以绝对确定您正在使用最彻底、最严格、编写良好、经过研究、记录、测试、测量和高质量的代码。

要与我们一起将数值计算带入网络，请首先在 GitHub 上查看我们，并考虑在经济上支持 stdlib。我们非常感谢您一如既往的支持！

删除第一个

删除字符串的第一个字符。

安装

npm install @stdlib/string-remove-first

或者，

• 要通过script标签在网站中加载程序包而无需安装和捆绑程序，请使用esm分支上提供的 ES 模块（请参阅自述文件）。
• 如果您使用 Deno，请访问deno分支（有关使用说明，请参阅自述文件）。
• 要在 Observable 或浏览器/节点环境中使用，请使用umd分支上提供的通用模块定义 (UMD) 版本（请参阅自述文件）。
• 要用作命令行的通用实用程序，请全局安装相应的 CLI 软件包。

Branches.md 文件总结了可用分支并显示说明其关系的图表。

要查看特定于每个分支版本的安装和使用说明，请务必明确导航到每个分支上相应的自述文件，如上面的链接。

用法

 var removeFirst = require ( '@stdlib/string-remove-first' ) ; 

removeFirst( str[, n][, 选项] )

删除string的第一个字符。

 var out = removeFirst ( 'last man standing' ) ;
// returns 'ast man standing'

out = removeFirst ( 'Hidden Treasures' ) ;
// returns 'idden Treasures'

该函数支持以下选项：

• mode ：要返回的字符类型。必须是以下之一：

  • 'grapheme' ：字素簇。适用于包含可以跨越多个 Unicode 代码点的视觉字符（例如表情符号）的字符串。
  • 'code_point' ：Unicode 代码点。适用于包含由多个 Unicode 代码单元（例如表意符号、标点符号和数学字母数字）组成的视觉字符的字符串。
  • 'code_unit' ：UTF-16 代码单元。适用于包含从基本多语言平面 (BMP) 绘制的可视字符的字符串（例如，常见字符，例如来自拉丁、希腊和西里尔字母的字符）。

  默认值： 'grapheme' 。

默认情况下，该函数返回第一个字符。要返回前n字符，请提供第二个参数来指定要返回的字符数。

 var out = removeFirst ( 'foo bar' , 4 ) ;
// returns 'bar'

out = removeFirst ( 'foo bar' , 10 ) ;
// returns '' 

笔记

• 默认情况下，该函数假设输入字符串可能包含任意数量的字素簇的一般情况。这种假设会带来性能成本。因此，如果已知输入字符串仅包含特定类型的视觉字符（例如，仅字母数字），则可以通过指定适当的mode选项来实现更好的性能。

示例

 var removeFirst = require ( '@stdlib/string-remove-first' ) ;

var str = removeFirst ( 'last man standing' ) ;
// returns 'ast man standing'

str = removeFirst ( 'presidential election' ) ;
// returns 'residential election'

str = removeFirst ( 'JavaScript' ) ;
// returns 'avaScript'

str = removeFirst ( 'Hidden Treasures' ) ;
// returns 'idden Treasures'

str = removeFirst ( 'The Last of the Mohicans' , 4 ) ;
// returns 'Last of the Mohicans'

str = removeFirst ( '?????' , 2 ) ;
// returns '???'

str = removeFirst ( '?????' , 10 ) ;
// returns '' 

---

命令行界面

安装

要用作通用实用程序，请全局安装 CLI 软件包

npm install -g @stdlib/string-remove-first-cli

用法

 Usage: remove-first [options] [<string>]

Options:

  -h,    --help                Print this message.
  -V,    --version             Print the package version.
         --n                   Number of characters to remove. Default: 1.
         --split sep           Delimiter for stdin data. Default: '/\r?\n/'.
         --mode mode           Type of character to return. Default: 'grapheme'.

笔记

• 如果拆分分隔符是正则表达式，请确保split选项正确转义或用引号引起来。

   # Not escaped...
  $ echo -n $' beep n boop ' | remove-first --split / r ? n /
  
  # Escaped...
  $ echo -n $' beep n boop ' | remove-first --split / \ r ? \ n/

• 该实现忽略尾随分隔符。

示例

$ remove-first beep
eep

要用作标准流，

$ echo -n ' beepnboop ' | remove-first --n=2
be
bo

默认情况下，当用作标准流时，实现采用换行符分隔的数据。要指定替代分隔符，请设置split选项。

$ echo -n ' beeptboop ' | remove-first --split ' t '
eep
oop

---

参见

• @stdlib/string-remove-last ：删除字符串的最后一个字符。

---

注意

该包是 stdlib 的一部分，stdlib 是 JavaScript 和 Node.js 标准库，重点关注数值和科学计算。该库提供了一系列强大的高性能库，用于数学、统计、流、实用程序等。

有关该项目的更多信息、提交错误报告和功能请求以及如何开发 stdlib 的指南，请参阅主项目存储库。

社区

---

执照

请参阅许可证。

版权

版权所有 © 2016-2024。 Stdlib 作者。