🏠 Housenumber Helper

Utility functies voor validatie en verwerking van huisnummers.

← Terug naar Core Library

📖 Introductie

De Housenumber Helper bevat eenvoudige utility functies voor het valideren en verwerken van huisnummers.

👉 Deze helper wordt gebruikt om basisvalidatie en parsing van huisnummers consistent toe te passen.

đŸ“Ļ Functionaliteit

✅ Validatie

  • isValid(housenumber) → controleert of minimaal ÊÊn cijfer aanwezig is

🔍 Extractie

  • extract(housenumber) → haalt het numerieke deel uit een string

⚙ī¸ Werking

De helper biedt eenvoudige en robuuste logica voor huisnummerverwerking.

👉 De helper:
  • controleert of input bestaat
  • zoekt naar numerieke patronen ( \d+)
  • extraheert het eerste numerieke deel

Validatie

  • Controleert aanwezigheid van cijfers
  • Minimaal ÊÊn numerieke waarde vereist

Extractie

  • Zoekt eerste numerieke reeks
  • Converteert naar integer
  • Retourneert null indien geen getal gevonden

⚠ī¸ Belangrijke aandachtspunten

  • isValid() valideert alleen aanwezigheid cijfers (geen volledige adresvalidatie)
  • extract() retourneert alleen de eerste numerieke match
  • Suffixen worden genegeerd (bijv. 123-bis → 123)
⚠ī¸ Deze helper is niet bedoeld voor volledige adresvalidatie, maar alleen voor basis parsing.

Return types

  • isValid() → boolean
  • extract() → number of null

💡 Voorbeelden

Validatie

const isValid = core.Housenumber.isValid("1234");
// true

Validatie met suffix

const isValid = core.Housenumber.isValid("12B");
// true

Extract numeriek deel

const number = core.Housenumber.extract("123-bis");
// 123

Geen nummer gevonden

const number = core.Housenumber.extract("ABC");
// null

📊 Samenvatting

✅ Basisvalidatie van huisnummers
✅ Extractie van numerieke waarden
✅ Eenvoudige en snelle parsing
✅ Geschikt voor form logic