TMQL tutorial - part 4

Einführung in Topic Maps

topicmapslab.de

Topic Maps Query Language

Sven Krosse M. Sc.

Topic Maps Lab an der Universität Leipzig

[email protected]

Session 4


topicmapslab.de

Review – Session 3

Postfix

● Filter

– Boolean-Expression

– Filtertypen

● Projektion

Operatoren


topicmapslab.de

Agenda

1. Funktionen

● Draft 2007 Funktionen

● TMQL4J Erweiterungen

● Draft 2010 Funktionen


topicmapslab.de

SprachbestandteileFunktionen


topicmapslab.de5

Funktionen

● erlaubt als sogenannte Value-Expression oder Content

● Bestandteil einer Boolean-Expression

● Bestandteil von Select-Expressions

● jeder Operator existiert als Funktion

● alle im Namespace fn

(http://psi.topicmaps.org/tmql/1.0/functions/)


topicmapslab.de6

Funktion - has-datatype

● Identifier: has-datatype

● Argumente: eine Menge von Konstrukten

● Beschreibung:

● liefert für jede Occurrence den Datentyp als Locator

● liefert für andere Konstrukte das Systemtopic undef


topicmapslab.de7

Funktion - has-datatype

● Beispiel

%prefix o http://psi.ontopia.net/music/

// o:composer >> characteristics tm:occurrence

[ fn:has-datatype(.) == xsd:string ]

→ alle Occurrence vom Typ XSD String


topicmapslab.de8

Funktion - has-variant

● Identifier: has-variant

● Argumente: eine Menge von Konstrukten

● Beschreibung:

● liefert die Varianten von Namen

● sonst Systemtopic undef


topicmapslab.de9

Funktion - has-variant

● Beispiel


http://en.wikipedia.org/wiki/Puccini >> characteristics tm:name

( fn:has-variant(.) )

→ die Namensvarianten aller Namen von Puccini


topicmapslab.de10

Funktion - length

● Identifier: length

● Argumente: eine Menge von Literalen

● Beschreibung:

● liefert die Länge der String-Literale

● andere Konstrukte werden zu Literal konvertiert

Hinweis Draft 2010: umbenannt in 'string-length'


topicmapslab.de11

Funktion - length

● Beispiel


http://en.wikipedia.org/wiki/Puccini >> characteristics tm:name

[ fn:length( . >> atomify ) == 10 ]

→ alle Namen von Puccini mit Länge 10


topicmapslab.de12

Konstrukt-Literal-Transformation

● Topic → Name, Subject-Identifier, Subject-Locator, Item-Identifier

● Name → Stringliteral

● Occurrence → Stringliteral

● Variant → Stringliteral

● Role → Item-Identifier

● Association → Item-Identifier


topicmapslab.de13

Funktion - slice

● Identifier: slice

● Argumente: eine Menge von Literalen und zwei numerische

Werte

● Beschreibung:

● liefert die Submenge definiert durch die numerischen

Grenzen


topicmapslab.de14

Funktion - count

● Identifier: count


● Beschreibung:

● liefert die Anzahl der Elemente der Menge


topicmapslab.de15

Funktion - count

● Beispiel


// o:composer [ fn:count( . / tm:name ) == 2 ]

→ alle Komponisten, welche genau zwei Namen haben


topicmapslab.de16

Funktion - uniq

● Identifier: uniq


● Beschreibung:

● entfernt aller Duplikate


topicmapslab.de17

Funktion - zigzag

● Identifier: zigzag


● Beschreibung:

● erzeugt neues Tupel bestehend aus allen Tupeln der

gegebenen Menge

● Beispiel: zigzag( { [A, B] , [C, D] } )

= { [A, B, C, D] }


topicmapslab.de18

Funktion - zagzig

● Identifier: zagzig


● Beschreibung:

● erzeugt neue Menge mit Singleton Tupeln

● Beispiel: zagzig( { [A, B] , [C, D] } )

= { [A], [B], [C], [D] }


topicmapslab.de19

Funktionen -TMQL4J

● Identifier: substring

● Argumente: eine Menge und zwei numerische Werte

● Beschreibung:

● Menge von Sub-Strings definiert durch numerische Werte

● numerische Werte definieren maximalen Bereich

● Beispiel: substring( „abc“ , 0 , 9 )

= { „abc“ }

Hinweis Draft 2010: 3. Argument definiert die Menge an Zeichen


topicmapslab.de20

Funktionen – Draft 2010

● Identifier: starts-with

● Argumente: eine Menge von Literalen und Vergleichsliteral

● Beschreibung:

● Prüfung ob Literal mit Vergleichsliteral beginnt

● Beispiel: starts-with( { „ab“,“bc“ } , „a“ )

= { true, false }


topicmapslab.de21


● Identifier: ends-with


● Beschreibung:

● Prüfung ob Literal mit Vergleichsliteral endet

● Beispiel: ends-with( { „ab“,“bc“ } , „b“ )

= { true, false }


topicmapslab.de22


● Identifier: contains


● Beschreibung:

● Prüfung ob Literal das Vergleichsliteral enthält

● Beispiel: contains( { „ab“,“bc“ } , „a“ )

= { true, false }


topicmapslab.de23


● Identifier: substring-before


● Beschreibung:

● liefert Zeichenkette vor dem gegebenen Literal, falls

vorhanden, ansonsten leere Zeichenkette

● Beispiel: substring-before( { „ab“,“bc“ } , „b“ )

= { „a“, „“ }


topicmapslab.de24


● Identifier: substring-after


● Beschreibung:

● liefert Zeichenkette nach dem gegebenen Literal, falls

vorhanden, ansonsten leere Zeichenkette

● Beispiel: substring-after( { „ab“,“bc“ } , „b“ )

= { „“, „c“ }


topicmapslab.de25


● Identifier: normalize-space


● Beschreibung:

● entfernt multiple Vorkommen von Leerzeichen

● Beispiel: normalize-space( { „a b“,“b c“ } )

= { „a b“, „b c“ }


topicmapslab.de26


● Identifier: translate

● Argumente: eine Menge von Literalen und zwei weitere Literale

● Beschreibung:

● ersetzt jedes Zeichen des 2. Literals durch Zeichen des 3.

Literals (index-basiert)

● Beispiel: translate( „Puccini“,“Pci“,“xyz“ )

= { „xuyyznz“ }


topicmapslab.de27


● Identifier: find

● Argumente: eine Menge von Literalen und weiteres Literal

● Beschreibung:

● lierfert Index des ersten Vorkommens des 2. Literals

● Beispiel: find( „Puccini“,“cc“ )

= { 2 }


topicmapslab.de28


● Identifier: extract-regexp

● Argumente: eine Menge von Literalen und weiteres Literal

● Beschreibung:

● liefert den 1. Substring welcher den regulären Ausdruck

erfüllt

● Beispiel: extract-regexp( „Puccini“,“.*cc.*“ )

= { „Pucc“ }


topicmapslab.de29


● Identifier: ceiling

● Argumente: eine Menge von numerischen Literalen

● Beschreibung:

● liefert kleinste natürliche Zahl die nicht kleiner als die

gegeben ist

● Beispiel: ceiling( { 1.5, - 1.5, 5 } )

= { 2, -1, 5 }


topicmapslab.de30


● Identifier: floor


● Beschreibung:

● liefert größte natürliche Zahl die nicht größer als die gegeben

ist

● Beispiel: floor( { 1.5, - 1.5, 5 } )

= { 1, -2, 5 }


topicmapslab.de31


● Identifier: round


● Beschreibung:

● liefert gerundete Werte

● Beispiel: round( { 1.5, - 1.5, 5.1 } )

= { 2, -1, 5 }


topicmapslab.de32


● Identifier: topicmap

● Argumente: keine

● Beschreibung:

● liefert die Instanz der Topic Map


topicmapslab.de33


● Literalfunktionen

● Transformation von Konstrukt zu Literalen des entsprechenden

Typs

● Funktionen

● string

● boolean

● number


topicmapslab.de

ENDE

Education

TMQL tutorial - part 4