https://github.com/writetome51/public-array-remover
An array-manipulating typescript/javascript class with methods that remove items from the array
https://github.com/writetome51/public-array-remover
array array-manipulations class remove remover typescript
Last synced: 11 months ago
JSON representation
An array-manipulating typescript/javascript class with methods that remove items from the array
- Host: GitHub
- URL: https://github.com/writetome51/public-array-remover
- Owner: writetome51
- License: mit
- Created: 2018-10-20T05:47:14.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-06-10T02:59:49.000Z (over 6 years ago)
- Last Synced: 2025-02-02T10:46:58.476Z (11 months ago)
- Topics: array, array-manipulations, class, remove, remover, typescript
- Language: TypeScript
- Size: 46.9 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PublicArrayRemover
An array-manipulating Typescript/Javascript class with methods that remove items
from the array.
## Constructor
```ts
constructor(data? = []) // 'data' is assigned to this.data .
```
You can reset the array by accessing the class `.data` property:
```ts
this.data = [1,2,3,4];
```
## Properties
```ts
data : any[] // the actual array
className: string (read-only)
```
## Methods
view methods
```ts
byIndex(index): this
// removes single item, identified by index. index can be negative or positive.
byIndexes(indexes): this
// removes items identified by indexes. indexes can be negative or positive.
adjacentAt(startingIndex, numItemsToRemove): this
// Removes adjacent items. startingIndex can be negative or positive.
head(numItemsToRemove): this
// Removes numItemsToRemove from beginning of this.data .
tail(numItemsToRemove): this
// Removes numItemsToRemove from end of this.data .
between(numItemsToKeepAtEachEnd): this
// Removes everything between numItemsToKeepAtEachEnd.
// i.e., if numItemsToKeepAtEachEnd = 2, then only the first 2 items and
// last 2 items will remain.
```
NOTICE: For all the functions below, any parameter called `value` cannot be an object,
and any parameter called `values` cannot contain an object.
This does not include arrays. Arrays are OK, as long as they don't contain objects.
```ts
adjacentToValue(info): this
/****************
Removes adjacent items including, or near, a particular value.
Only applies to the first instance of value found in array.
The parameter 'info' is an object that looks like this:
{
value: any except object (the value to search for in the array),
offset: integer (tells function where, in relation to value, to begin
selecting adjacent items to remove. If offset is zero, the
selection will begin with value.)
howMany: integer greater than zero (it's how many adjacent items to remove)
}
Example:
let remove = new PublicArrayRemover( [1,2,3,4,5,6,7,8,9,10] );
remove.adjacentToValue({value:5, offset: -2, howMany:3});
// remove.data is now [1,2,6,7,8,9,10]
****************/
firstOf(value): this
// Removes first instance of value.
firstOfEach(values: any[]): this
// Removes first instance of each value.
allOf(value): this
// Removes all instances of value.
allOfEach(values: any[]): this
// Removes all instances of each value.
allAfterFirst(value): this
// Removes all items after first instance of value.
allBeforeFirst(value): this
// Removes all items before first instance of value.
allAfterLast(value): this
// Removes all items after last instance of value.
allBeforeLast(value): this
// Removes all items before last instance of value.
duplicates(): this
byTest(testFunction: (currentItem, currentIndex?, array?) => boolean): this
// testFunction has same signature as callback passed to Array.filter().
// if currentItem passes test, it is removed.
byType(
type: 'object' | 'array' | 'number' | 'string' | 'boolean' | 'function' | 'undefined' | 'null'
): this
// Removes all items that are of the passed type.
// Here, 'null' is considered its own type, separate from 'object'.
// You can also pass 'array' as a type. Passing 'object' will match with objects and arrays.
```
The methods below are not important to know about in order to use this
class. They're inherited from [BaseClass](https://github.com/writetome51/typescript-base-class#baseclass) .
```ts
protected _createGetterAndOrSetterForEach(
propertyNames: string[],
configuration: IGetterSetterConfiguration
) : void
/*********************
Use this method when you have a bunch of properties that need getter and/or
setter functions that all do the same thing. You pass in an array of string
names of those properties, and the method attaches the same getter and/or
setter function to each property.
IGetterSetterConfiguration is this object:
{
get_setterFunction?: (
propertyName: string, index?: number, propertyNames?: string[]
) => Function,
// get_setterFunction takes the property name as first argument and
// returns the setter function. The setter function must take one
// parameter and return void.
get_getterFunction?: (
propertyName: string, index?: number, propertyNames?: string[]
) => Function
// get_getterFunction takes the property name as first argument and
// returns the getter function. The getter function must return something.
}
*********************/
protected _returnThis_after(voidExpression: any) : this
// voidExpression is executed, then function returns this.
// Even if voidExpression returns something, the returned data isn't used.
protected _errorIfPropertyHasNoValue(
property: string, // can contain dot-notation, i.e., 'property.subproperty'
propertyNameInError? = ''
) : void
// If value of this[property] is undefined or null, it triggers fatal error:
// `The property "${propertyNameInError}" has no value.`
```
## Inheritance Chain
PublicArrayRemover<--[PublicArrayContainer](https://github.com/writetome51/public-array-container#publicarraycontainer)<--[BaseClass](https://github.com/writetome51/typescript-base-class#baseclass)
## Installation
```bash
npm i @writetome51/public-array-remover
```
## Loading
```ts
// if using Typescript:
import {PublicArrayRemover} from '@writetome51/public-array-remover';
// if using ES5 Javascript:
var PublicArrayRemover =
require('@writetome51/public-array-remover').PublicArrayRemover;
```
## License
[MIT](https://choosealicense.com/licenses/mit/)