net/de.jfachwert.net/Telefonnummer

Telefonnummer

open class Telefonnummer @JvmOverloads constructor(nummer: String, validator: KSimpleValidator<String> = VALIDATOR) : Text

Die Klasse Telefonnummer steht fuer alle Arten von Rufnummern im Telefon-Netz wie Fesetnetznummer, Faxnummer oder Mobilfunknummer. Ueblicherweise bestehen Telefonnummern aus

Laenderkennzahl (LKz),
Ortsnetzkennzahl (ONKz) bzw. die eigentliche Vorwahl
Teilnehmerrufnummer (RufNr),
Durchwahl (optional).

Die Telefonnummer +49 30 12345-67 hat die Laenderkennzahl 49 (Deutschland), die Vorwahl 030 (Berlin), die Teilnehmerrufnummer 12345 und die Durchwahl

Frueher waren Telefon-Netz und Computer-Netzwerke strikt getrennt. Inwischen wachsen diese beiden Netze immer mehr zusammen und unterscheiden sich nur noch durch das Netzwerkprotokoll. Deswegen ist diese Klasse im gleichen Package 'net' wie die EMailAdresse zu finden und nicht in 'comm' (fuer Kommunikation), wie urspruenglich geplant.

Fuer eine effizente Speicherung von Telefonnummern kann man sich die Telefonnummer ueber #toPackedDecimal in PackedDecimal umwandeln. Damit laesst sich der Speicherbedarf fuer Telefonnummern halbieren. Allerdings lassen sich Klammern wie in "+49 (0)811 32 16 8" nicht als PackedDecimal abspeichern - diese gehen bei der Konvertierung verloren.

Author

oboehm

Since

0.5 (04.09.2017)

Constructors

Telefonnummer

constructor(uri: URI)

Eine Telefonnummer lasesst sich auch ueber eine URI kreieren. Der RFC 3966 schlaegt dabei "tel:" als Schema vor.

@JvmOverloads

constructor(nummer: String, validator: KSimpleValidator<String> = VALIDATOR)

Types

Companion

object Companion

Validator

class Validator(pattern: Pattern) : KSimpleValidator<String>

Die Klasse Validator validiert die Schreibweise von Telefonnummern. Urspruenglich war dieser Validator in einer eigenen Klasse ('TelefonnummerValidator' ausgegegliedert. Mit v2.2 wurde der Validator analog zu den anderen Validatoren zur betroffenen Klasse als innere Klasse dazugesteckt.

Properties

code

val code: String

inlandsnummer

val inlandsnummer: Telefonnummer

Liefert die Telefonnummer ohne Laenderkennzahl, dafuer mit Vorwahl inklusive fuehrender Null.

laenderkennzahl

val laenderkennzahl: Optional<String>

Die Laenderkennzahl (LKZ) ist die Vorwahl, die man fuer Telefonate ins Ausland waehlen muss. Fuer Deutschland ist die LKZ "+49*, d.h. wenn man von Oesterreich nach Deutschland waehlen muss, muss man "0049" vorwaehlen.

rufnummer

val rufnummer: Telefonnummer

Liefert die Nummer der Ortsvermittlungsstelle, d.h. die Telefonnummer ohne Vorwahl und Laenderkennzahl.

vorwahl

val vorwahl: String

Liefert die Vorwahl oder auch Ortskennzahl (ONKz).

Functions

compareTo

open operator override fun compareTo(other: Text): Int

convertTo

fun convertTo(toEncoding: Charset, fromEncoding: Charset): Text

detectCharset

fun detectCharset(): Charset

detectCharsets

fun detectCharsets(): Collection<Charset>

equals

open operator override fun equals(other: Any?): Boolean

Beim Vergleich zweier Telefonnummern spielen Trennzeichen keine Rolle. Hier sind nur die Nummern relevant.

equalsIgnoreCase

fun equalsIgnoreCase(other: Text): Boolean

equalsIgnoreCaseAndUmlaute

fun equalsIgnoreCaseAndUmlaute(other: Text): Boolean

equalsIgnoreUmlaute

fun equalsIgnoreUmlaute(other: Text): Boolean

getDistanz

fun getDistanz(other: Text): Int

fun getDistanz(other: String): Int

hashCode

open override fun hashCode(): Int

Wenn zwei Telefonnummern gleich sind, muessen sie auch den gleichen Hashcode liefern.

isCharset

fun isCharset(cs: Charset): Boolean

isPrintable

fun isPrintable(): Boolean

isValid

open override fun isValid(): Boolean

replaceUmlaute

fun replaceUmlaute(): Text

toDinString

fun toDinString(): String

Gibt den String nach DIN 5008 aus. Die Nummern werden dabei funktionsbezogen durch Leerzeichen und die Durchwahl mit Bindestrich abgetrennt.

toE123String

fun toE123String(): String

Die "E.123" ist eine Empfehlung der Internationalen Fernmeldeunion. Dabei werden die einzelnen Bestandteile (Laenderkennzeichen, Vorwahl und Rufnummer) durch Leerzeichen gruppiert.

toLowerCase

fun toLowerCase(): Text

toMap

open override fun toMap(): Map<String, Any>

toPackedDecimal

fun toPackedDecimal(): PackedDecimal

Fuer eine kompaktere interne Speicherung von Telefonnummer kann auf PackedDecimal zurueckgegriffen werden, um den Speicherverbrauch zu halbieren. Allerdings koennen damit mit PackedDecimal keine Klammern abgespeichert werden, d.h. "+49 (0)811 32 16 8" wird als "+49 0811 32 16 8" abgespeichert.

toPrintable

fun toPrintable(): Text

toShortString

fun toShortString(): String

Stellt eine Telefonnummer in verkuerzter Schreibweise ohne Leerzeichen und Trennzeichen dar.

toString

open override fun toString(): String

toUpperCase

fun toUpperCase(): Text

toURI

fun toURI(): URI

Nach RFC 3966 wird die Telefonnummer wie E.123 dargestellt, jedoch mit Bindestrich statt Leerzeichen.