# @hyfi06/str-utils

> A collection of string utility functions.

Latest version **1.0.0** (published 2023-07-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install @hyfi06/str-utils
pnpm add @hyfi06/str-utils
yarn add @hyfi06/str-utils
bun add @hyfi06/str-utils
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2023-07-21 |
| First published | 2023-07-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 20.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Héctor Olvera Vital |
| Maintainers | hyfi06 |
| Keywords | strings, utils, tools, clear |

## Links

- npm: https://www.npmjs.com/package/@hyfi06/str-utils
- Repository: https://github.com/hyfi06/str-utils
- Homepage: https://github.com/hyfi06/str-utils#readme
- Issues: https://github.com/hyfi06/str-utils/issues
- npm.io page: https://npm.io/package/@hyfi06/str-utils

## Alternatives

- [@mce/gif](https://npm.io/package/@mce/gif.md) — 2.6K weekly downloads
- [cleanse](https://npm.io/package/cleanse.md) — 173 weekly downloads
- [str](https://npm.io/package/str.md) — 127 weekly downloads
- [naming](https://npm.io/package/naming.md) — 95 weekly downloads
- [tap-telco-api](https://npm.io/package/tap-telco-api.md) — 19 weekly downloads

## Recent versions

- 1.0.0 (latest) — 2023-07-21

## README

# @hyfi06/str-utils

A collection of string utility functions.

## Install

```bash
npm install --save @hyfi06/str-utils
```

## Usage

Here is an example of how to use the `sanitizeStr` function:

```javascript
const { sanitizeStr } = require("@hyfi06/str-utils");

const str = "  HéllO  my  friend!   ";
const config = { removeAccents: true, toUpperCase: true };
const result = sanitizeStr(str, config);

console.log(result); // Prints: 'HELLO MY FRIEND!'
```

## Functions

- [`areStringsSimilar(str1: string, str2: string): boolean`](#areStringsSimilar): Compares two strings for similarity. Removes leading, trailing, and duplicate spaces, removes accents, and converts the strings to uppercase before comparing them.
- [`multiReplace(str: string, replace: { [pattern: string]: string } = {}): string`](#multireplace): Replaces all occurrences of specified patterns in a given string.
- [`removeAccents(str: string): string`](#removeaccents): Removes all accents from a given string.
- [`removeSpaces(str: string): string`](#removespaces): Removes leading, trailing, and duplicate spaces in a given string.
- [`sanitizeJoin(array: any[], separator: string = " "): string`](#sanitizejoin): Joins an array into a string using a specified separator, ignoring any falsy values in the array. It also removes leading, trailing, and duplicate spaces from the resulting string.
- [`sanitizeStr(str: string, config: { removeAccents?: boolean, toUpperCase?: boolean } = {}): string`](#sanitizeStr): Processes a given string based on a configuration object. By default, it removes leading, trailing, and duplicate spaces. If the configuration object specifies, it can also remove accents and convert the string to uppercase.

### areStringsSimilar

The `areStringsSimilar` function compares two strings for similarity. It removes leading, trailing, and duplicate spaces, removes accents, and converts the strings to uppercase before comparing them.

#### Parameters

- `str1` (string): The first string to compare.
- `str2` (string): The second string to compare.

#### Returns

- (boolean): Returns `true` if the processed strings are equal, `false` otherwise.

#### Example

```javascript
const str1 = "  HéllO  my  friend!   ";
const str2 = "hello my friend!";
const result = areStringsSimilar(str1, str2);
// result is true
```

### multiReplace

The `multiReplace` function replaces all occurrences of the keys in the replace object with the corresponding values in the given string.

#### Parameters

- `str` (string): The string to perform replacements on.
- `replace` (object): An object where the keys are the patterns to be replaced and the values are the replacements. Defaults to an empty object.

#### Returns

- (string): A new string where all occurrences of the keys in the replace object in str have been replaced with the corresponding values.

#### Example

```javascript
const str = "foo biz baz";
const replace = {
  foo: "0",
  biz: "1",
  baz: "2",
};
const result = multiReplace(str, replace);
// result is '0 1 2'
```

### removeAccents

The `removeAccents` function removes all accents from a given string.

#### Parameters

- `str` (string): The string to remove accents from.

#### Returns

- (string): The string with all accents removed.

#### Example

```javascript
const str = "Héctor";
const result = removeAccents(str);
// result is 'Hector'
```

### removeSpaces

The `removeSpaces` removes leading, trailing, and duplicate spaces in a given string.

#### Parameters

- `str` (string): The string to remove spaces from.

#### Returns

- (string): The string with all leading, trailing, and duplicate spaces removed.

#### Example

```javascript
const str = "  hello  my  friend!   ";
const result = removeSpaces(str);
// result is 'hello my friend!'
```

### sanitizeJoin

The `sanitizeJoin` function joins an array into a string using a specified separator, ignoring any falsy values in the array. It also removes leading, trailing, and duplicate spaces from the resulting string.

#### Parameters

- `array` (Array): The array to join.
- `separator` (string): The separator to use. Defaults to a single space.

#### Returns

- (string): The joined string with all leading, trailing, and duplicate spaces removed.

#### Example

```javascript
const array = ["hello", "", "my", null, "friend!", "  "];
const separator = " ";
const result = sanitizeJoin(array, separator);
// result is 'hello my friend!'
```

### sanitizeStr

The `sanitizeStr` function processes a given string based on a configuration object. By default, it removes leading, trailing, and duplicate spaces. If the configuration object specifies, it can also remove accents and convert the string to uppercase.

#### Parameters

- `str` (string): The string to process.
- `config` (object): An optional configuration object. Can have the following properties:
  - `removeAccents` (boolean): If `true`, removes accents from the string.
  - `toUpperCase` (boolean): If `true`, converts the string to uppercase.

#### Returns

- (string): The processed string.

#### Example

```javascript
const str = "  HéllO  my  friend!   ";
const config = {
  removeAccents: true,
  toUpperCase: true,
};
const result = sanitizeStr(str, config);
// result is 'HELLO MY FRIEND!'
```

## Copyright

Copyright (c) 2023 Héctor Olvera Vital

## License

This project is licensed under the [MIT License](LICENSE), which means you are free to use, modify, and distribute the code for both commercial and non-commercial purposes. However, the software is provided "as is," without any warranty or guarantee of its effectiveness or suitability for your specific needs. [Please review the license file for more details](LICENSE).

---
_Source: https://npm.io/package/@hyfi06/str-utils · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._