JJ.Framework.Existence.Core 2.8.4205

Existence.Core

Ever find yourself trying to decide on IsNullOrEmpty, IsNullOrWhiteSpace, a null check, empty list check or whether you should check at all?

Well, no more. Now you just type Has(text) or Has(collection) and be done with it.

Background

Nothing isn't one thing in .NET. It's null, default, white space, 0, NaN, Empty, Length = 0, !Equals(x, default(T?)) && !Equals(x, default(T)). It gets quite absurd with the many states of nothingness in .NET.

Here we coin the term nully. Don't blame us; the concept already existed, just nobody dared give it a name yet.

Features

Grab these methods instead of wrestling with these checks. Your code (and your brain) will thank you:

• Has / FilledIn / IsNully

  • One step beyond null treating empty strings / white space / 0 / empty lists as nully.

• Coalesce

  • Pick the first non-nully value (?? on steroids).

• In / Contains

  • "Is this in that?" tests for collections.

• Is

  • Loose equality (case/trim-insensitive, etc.) when you don't care about exact matches.

Flags for special occasions:

• spaceMatters

  • spaceMatters flags everywhere – because sometimes you really care if your string is just a single space.

• caseMatters

  • To keep us sane as long as possible, the default is to not trip over case mismatches: GREEN = green. The caseMatters flag can make things stricter and case-sensitive again.

Examples

list = list.Where(FilledIn);

if (number.IsNully()) return;

if (Has(name)) sb.Append($" {name} ");

Coalesce(" ", null, "Hi!") == "Hi!"

"\r\n GREEN\t  ".Is("Green")

"GREEN".In("Red", "Green","Blue") == true!

Coming Soon

• zeroMatters – flip the switch if you consider 0 meaningful.
• flex mode – force a full runtime type lookup on values when you're feeling adventurous.
• char quirks – treat lone ' ' as nully by default (no more sneaky space bugs).
• float drama – NaN, ∞, +0/–0 all count as empty.
• enum safety net – invalid enum values get flagged as nully instead of blowing up.
• all-null collections – if every item is null, the whole collection is officially empty.
• ultra-loose Is – 10.Is("10") regardless of type, because how will we stay sane if 10 isn't 10?

Release Notes

2.5 Initial release

2.6 Flags

• spaceMatters flags everywhere
• caseMatters replaced ignoreCase
• StringBulder/string more combos possible
• x.In(a, b, c) extension favored over static In(x, a, b, c)

2.7 Technical

• Improved separation of Legacy version lineages for a more stable package update.

2.8 Technical

• Compatibility with AOT "Ahead-Of-Time" native compilation, core trimming and single-executable, self-contained apps.

After Upgrading

Links to legacy dependencies may have changed. If you experience problems, these things might help:

Option 1

• Do nothing. Everything works.

Option 2

• Use the JJ.Framework.Common.Legacy namespace where you currently use JJ.Framework.Common.

Option 3

• Install JJ.Framework.Common explicitly. You may need a downgrade to a 0.* version.

The same thing applies to JJ.Framework.PlatformCompatibility.Legacy vs JJ.Framework.PlatformCompatibility

🐨 Mr. Koala

Special thanks to Mr. Koala. Once you think of koalas when you read 🐨 Coalesce, you can never unsee it. Mr. Koala eats your nullies. Nully nums are his favorite!

💬 Feedback

Found an issue? Let me know.