string remove first

Outro código-fonte

1.0.0

Baixar

Sobre stdlib...

Acreditamos em um futuro em que a web seja o ambiente preferencial para computação numérica. Para ajudar a concretizar esse futuro, criamos o stdlib. stdlib é uma biblioteca padrão, com ênfase em computação numérica e científica, escrita em JavaScript (e C) para execução em navegadores e em Node.js.

A biblioteca é totalmente decomponível, sendo arquitetada de forma que você possa trocar, misturar e combinar APIs e funcionalidades para atender exatamente às suas preferências e casos de uso.

Ao usar stdlib, você pode ter certeza absoluta de que está usando o código mais completo, rigoroso, bem escrito, estudado, documentado, testado, medido e de alta qualidade que existe.

Para se juntar a nós e trazer a computação numérica para a web, comece verificando-nos no GitHub e considere apoiar financeiramente o stdlib. Agradecemos imensamente seu apoio contínuo!

removerPrimeiro

Status de construção

Remova o(s) primeiro(s) caractere(s) de uma string.

Instalação

npm install @stdlib/string-remove-first

Alternativamente,

Para carregar o pacote em um site através de uma tag script sem instalação e bundlers, use o Módulo ES disponível no branch esm (veja README).
Se você estiver usando o Deno, visite o branch deno (consulte o README para obter instruções de uso).
Para uso em Observable ou em ambientes de navegador/nó, use a construção Universal Module Definition (UMD) disponível na ramificação umd (consulte README).
Para usar como um utilitário geral para a linha de comandos, instale o pacote CLI correspondente globalmente.

O arquivo branch.md resume as ramificações disponíveis e exibe um diagrama que ilustra seus relacionamentos.

Para visualizar instruções de instalação e uso específicas para cada build de branch, certifique-se de navegar explicitamente até os respectivos arquivos README em cada branch, conforme link acima.

Uso

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

removeFirst(str[, n][, opções])

Remove o(s) primeiro(s) caractere(s) de uma string .

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

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

A função oferece suporte às seguintes opções:

mode : tipo de caracteres a serem retornados. Deve ser um dos seguintes:
- 'grapheme' : agrupamentos de grafemas. Apropriado para strings contendo caracteres visuais que podem abranger vários pontos de código Unicode (por exemplo, emoji).
- 'code_point' : pontos de código Unicode. Apropriado para strings contendo caracteres visuais que são compostos por mais de uma unidade de código Unicode (por exemplo, símbolos ideográficos e pontuação e alfanuméricos matemáticos).
- 'code_unit' : unidades de código UTF-16. Apropriado para strings contendo caracteres visuais extraídos do plano multilíngue básico (BMP) (por exemplo, caracteres comuns, como os dos alfabetos latino, grego e cirílico).
Padrão: 'grapheme' .

Por padrão, a função retorna o primeiro caractere. Para retornar os primeiros n caracteres, forneça um segundo argumento especificando o número de caracteres a serem retornados.

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

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

Notas

Por padrão, a função assume o caso geral em que uma string de entrada pode conter um número arbitrário de clusters de grafemas. Essa suposição acarreta um custo de desempenho. Conseqüentemente, se uma string de entrada contém apenas caracteres visuais de um tipo específico (por exemplo, apenas alfanumérico), pode-se obter melhor desempenho especificando a opção mode apropriada.

Exemplos

 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

Instalação

Para usar como um utilitário geral, instale o pacote CLI globalmente

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

Uso

 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'.

Notas

Se o separador de divisão for uma expressão regular, certifique-se de que a opção split tenha escape adequado ou esteja entre aspas.

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

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

A implementação ignora delimitadores finais.

Exemplos

$ remove-first beep
eep

Para usar como fluxo padrão,

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

Por padrão, quando usado como um fluxo padrão, a implementação assume dados delimitados por nova linha. Para especificar um delimitador alternativo, defina a opção split .

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

Veja também

@stdlib/string-remove-last : remove o(s) último(s) caractere(s) de uma string.

Perceber

Este pacote faz parte da stdlib, uma biblioteca padrão para JavaScript e Node.js, com ênfase em computação numérica e científica. A biblioteca fornece uma coleção de bibliotecas robustas e de alto desempenho para matemática, estatística, fluxos, utilitários e muito mais.

Para obter mais informações sobre o projeto, preencher relatórios de bugs e solicitações de recursos, além de orientações sobre como desenvolver o stdlib, consulte o repositório principal do projeto.