feat: add utils/any-own-by

[Rec0iL99]

Resolves #819.

Description

What is the purpose of this pull request?

This pull request adds a utility to test whether any "own" property of a provided object satisfies a predicate function.

var anyOwnBy = require( '@stdlib/utils/any-own-by' );

function isNegative( value ) {
    return ( value < 0 );
}

var obj = {
    'a': 1,
    'b': 2,
    'c': 3,
    'd': -24,
    'e': 12
};

var bool = anyOwnBy( obj, isNegative );
// returns true

Related Issues

Does this pull request have any related issues?

This pull request:

• resolves [RFC]: Add @stdlib/utils/any-own-by #819

Questions

Any questions for reviewers of this pull request?

No.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

No.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

• Read, understood, and followed the contributing guidelines.

---

@stdlib-js/reviewers

[stdlib-bot]

👋 Hi there! 👋

And thank you for opening your first pull request! We will review it shortly. 🏃 💨

[Planeshifter]

Thank you for your contribution! It looked very good; made some small edits and will merge after CI has passed.