string remove first

Otro código fuente

1.0.0

Descargar

Acerca de stdlib...

Creemos en un futuro en el que la web sea el entorno preferido para la computación numérica. Para ayudar a hacer realidad este futuro, hemos creado stdlib. stdlib es una biblioteca estándar, con énfasis en computación numérica y científica, escrita en JavaScript (y C) para su ejecución en navegadores y en Node.js.

La biblioteca es completamente descomponible y está diseñada de tal manera que puede intercambiar, mezclar y combinar API y funcionalidades para satisfacer sus preferencias y casos de uso exactos.

Cuando utiliza stdlib, puede estar absolutamente seguro de que está utilizando el código más completo, riguroso, mejor escrito, estudiado, documentado, probado, medido y de alta calidad que existe.

Para unirse a nosotros para llevar la computación numérica a la web, comience visitándonos en GitHub y considere apoyar financieramente a stdlib. ¡Apreciamos mucho su continuo apoyo!

eliminarPrimero

Estado de construcción

Elimina los primeros caracteres de una cadena.

Instalación

npm install @stdlib/string-remove-first

Alternativamente,

Para cargar el paquete en un sitio web a través de una etiqueta script sin instalación ni paquetes, utilice el módulo ES disponible en la rama esm (consulte README).
Si está utilizando Deno, visite la sucursal deno (consulte README para obtener instrucciones de uso).
Para usar en Observable, o en entornos de navegador/nodo, use la compilación de Definición de módulo universal (UMD) disponible en la rama umd (consulte README).
Para utilizarlo como utilidad general para la línea de comandos, instale el paquete CLI correspondiente de forma global.

El archivo Branches.md resume las ramas disponibles y muestra un diagrama que ilustra sus relaciones.

Para ver las instrucciones de instalación y uso específicas de cada compilación de rama, asegúrese de navegar explícitamente a los archivos README respectivos en cada rama, como se indica arriba.

Uso

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

eliminarPrimero( str[, n][, opciones] )

Elimina los primeros caracteres de una string .

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

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

La función admite las siguientes opciones:

modo : tipo de caracteres a devolver. Debe ser uno de los siguientes:
- 'grapheme' : grupos de grafemas. Apropiado para cadenas que contienen caracteres visuales que pueden abarcar varios puntos de código Unicode (por ejemplo, emoji).
- 'code_point' : puntos de código Unicode. Apropiado para cadenas que contienen caracteres visuales que se componen de más de una unidad de código Unicode (por ejemplo, símbolos y puntuación ideográficos y alfanuméricos matemáticos).
- 'code_unit' : unidades de código UTF-16. Apropiado para cadenas que contienen caracteres visuales extraídos del plano multilingüe básico (BMP) (por ejemplo, caracteres comunes, como los de los alfabetos latino, griego y cirílico).
Predeterminado: 'grapheme' .

De forma predeterminada, la función devuelve el primer carácter. Para devolver los primeros n caracteres, proporcione un segundo argumento que especifique el número de caracteres que se devolverán.

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

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

Notas

De forma predeterminada, la función asume el caso general en el que una cadena de entrada puede contener un número arbitrario de grupos de grafemas. Esta suposición tiene un costo de rendimiento. En consecuencia, si se sabe que una cadena de entrada sólo contiene caracteres visuales de un tipo particular (por ejemplo, sólo alfanuméricos), se puede lograr un mejor rendimiento especificando la opción mode adecuada.

Ejemplos

 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

Instalación

Para utilizarlo como una utilidad general, instale el paquete 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

Si el separador de división es una expresión regular, asegúrese de que la opción split esté correctamente escapada o entre comillas.

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

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

La implementación ignora los delimitadores finales.

Ejemplos

$ remove-first beep
eep

Para utilizarlo como flujo estándar,

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

De forma predeterminada, cuando se utiliza como flujo estándar, la implementación asume datos delimitados por nueva línea. Para especificar un delimitador alternativo, configure la opción split .

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

Ver también

@stdlib/string-remove-last : elimina los últimos caracteres de una cadena.

Aviso

Este paquete es parte de stdlib, una biblioteca estándar para JavaScript y Node.js, con énfasis en informática numérica y científica. La biblioteca proporciona una colección de bibliotecas sólidas y de alto rendimiento para matemáticas, estadísticas, secuencias, utilidades y más.

Para obtener más información sobre el proyecto, cómo presentar informes de errores y solicitudes de funciones, y orientación sobre cómo desarrollar stdlib, consulte el repositorio principal del proyecto.