# Remove Words
> Remove a list of words from a string.
## Usage
```javascript
var removeWords = require( '@stdlib/string/remove-words' );
```
#### removeWords( str, words\[, ignoreCase] )
Removes all occurrences of the given `words` from a `string`.
```javascript
var str = 'beep boop Foo bar';
var out = removeWords( str, [ 'boop', 'foo' ] );
// returns 'beep Foo bar'
```
By default, words are removed from an input `string` in case of an exact match. To perform a case-insensitive replace operation, set `ignoreCase` to `true`.
```javascript
var str = 'beep boop Foo bar';
var out = removeWords( str, [ 'boop', 'foo' ], true );
// returns 'beep bar'
```
## Examples
```javascript
var removeWords = require( '@stdlib/string/remove-words' );
var stopwords = require( '@stdlib/datasets/stopwords-en' );
var inmap = require( '@stdlib/utils/inmap' );
var spam = require( '@stdlib/datasets/spam-assassin' );
var corpus = spam();
var words = stopwords();
function remove( mail, idx ) {
var newText = removeWords( mail.text, words );
console.log( 'After removing stop words, email %d contains %d characters. Originally, it contained %d.', idx, newText.length, mail.text.length );
mail.text = newText;
}
inmap( corpus, remove );
```
* * *
## CLI
### Usage
```text
Usage: remove-words [options] [] --words=
Options:
-h, --help Print this message.
-V, --version Print the package version.
--words w1,w2,... Comma-separated list of words.
--ignore-case Perform case-insensitive replace operation.
```
### Examples
```bash
$ remove-words 'beep! boop!!!' --words='beep,boop'
! !!!
```
To use as a [standard stream][standard-streams],
```bash
$ echo -n 'beep! boop!!!' | remove-words --words='BEEP,BOOP' --ignore-case
! !!!
```
[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams