Matches: Unterschied zwischen den Versionen

Aus JACK Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
KKeine Bearbeitungszusammenfassung
 
(25 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
===Zugehörige Evaluatoren===
*'''MathEvaluator'''
=== Beschreibung ===
=== Beschreibung ===
Die Funktion ''matches'' prüft, ob ein String einem gegebenen regulären Ausdruck genügt. Die Funktion erwartet zwei String, die Zeichenkette, die geprüft werden soll, und den regulärer Ausdruck, der als Grundlage zum Prüfen gilt. Es wird ein Boolean zurückgegeben.
Die Funktion ''matches'' prüft, ob ein String einem gegebenen regulären Ausdruck genügt. Die Funktion erwartet zwei Strings, die Zeichenkette, die geprüft werden soll, und den regulärer Ausdruck, der als Grundlage zum Prüfen gilt. Es wird ein Boolean zurückgegeben.


=== Syntax ===
=== Syntax ===
  matches(String zeichenkette, String regExp)
  matches([[Zeichenkette]] zeichenkette, [[Zeichenkette]] regExp)


=== Parameter ===
=== Parameter ===
Zeile 10: Zeile 13:


=== Return Value ===
=== Return Value ===
* Gibt einen Boolean zurück
* Gibt einen [[Boolean]] zurück


=== Beispiele ===
=== Beispiele ===
==== Standardfälle ====
==== Standardfälle ====
  matches('Abcd0','[A-Za-z0-9]*')  --> returns true
  matches('Abcd0','[A-Za-z0-9]*')  --> returns ''true''


==== Benutzung von Variablen ====
==== Benutzung von Variablen ====
    matches('abababa','[var=a]')
matches('abababa','[var=a]')
    matches('[var=c]','\\d')
matches('[var=c]','\\d')
matches([input=field1], concat([var=s3a], '|', [var=s3b], '|', [var=s3c]))
 
==== Benutzung von Textfeldern ====
Bei einigen Testfunktionen kann <code>matches</code> als Ersatz dienen, wenn man Textfelder aber keinen Formeleditor nutzt.
 
Im folgenden jeweils ein Beispiel für die Ersetzung der Funktionen mit <code>matches</code>.
 
'''isElementOf''':
'''JACK2:'''
matches('[pos=1]','^(1|2|3)$')
--> [pos=1]=4  --> returns ''false''
--> [pos=1]=2  --> returns ''true''
 
'''JACK3:'''
matches([input=field1],'^(1|2|3)$')
--> [input=field1]=4  --> returns ''false''
--> [input=field1]=2  --> returns ''true''
 
 
'''isFraction''':
'''JACK2:'''
matches('[pos=1]','^-?\d+\/\d+$')
--> [pos=1]=12.34  --> returns ''false''
--> [pos=1]=8/9  --> returns ''true''
 
'''JACK3:'''
matches([input=field1],'^-?\d+\/\d+$')
--> [input=field1]=12.34  --> returns ''false''
--> [input=field1]=8/9  --> returns ''true''
 
 
'''isIntegerNumber''':
'''JACK2:'''
matches('[pos=1]','^-?\d+$')
--> [pos=1]=12  --> returns ''true''
--> [pos=1]=2.3  --> returns ''false''
 
'''JACK3:'''
matches([input=field1],'^-?\d+$')
--> [input=field1]=12  --> returns ''true''
--> [input=field1]=2.3  --> returns ''false''
 
 
'''isNaturalNumber''':
'''JACK2:'''
matches('[pos=1]','^\d+$')
--> [pos=1]=42  --> returns ''true''
--> [pos=1]=-42  --> returns ''false''
 
'''JACK3:'''
matches([input=field1],'^\d+$')
--> [input=field1]=42  --> returns ''true''
--> [input=field1]=-42  --> returns ''false''
 
 
'''isNotElementOf''':
'''JACK2:'''
matches('[pos=1]','^((?!1|2).)*$')
--> [pos=1]=2  --> returns ''false''
--> [pos=1]=4  --> returns ''true''
 
'''JACK3:'''
matches([input=field1],'^((?!1|2).)*$')
--> [input=field1]=2  --> returns ''false''
--> [input=field1]=4  --> returns ''true''
 
 
'''isRationalNumber''':
'''JACK2:'''
matches('[pos=1]','^-?\d+\.\d+$')
--> [pos=1]=14  --> returns ''false''
--> [pos=1]=12.5  --> returns ''true''
 
'''JACK3:'''
matches([input=field1],'^-?\d+\.\d+$')
--> [input=field1]=14  --> returns ''false''
--> [input=field1]=12.5  --> returns ''true''


====JUnit Tests====
<syntaxhighlight lang="java" class="mw-collapsible mw-collapsed">
@Before
public void beforeTest(){
  placeFillInVariable(1,OMParser.parse("abababa"));
  placeFillInVariable(2,OMParser.parse("6"));
  placeFillInVariable(3,OMParser.parse("2"));
 
  placeExerciseVariable("a",OMParser.parse("abababa"));
  placeExerciseVariable("b",OMParser.parse("6"));
  placeExerciseVariable("c",OMParser.parse("2"));
}
@Test
public void testMatches(){
  assertTrue(getEvaluator().getBooleanResult("matches('abababa','abababa')"));
  assertTrue(getEvaluator().getBooleanResult("matches('abcdefghijklmnopqrstuvwxyz','abcdefghijklmnopqrstuvwxyz')"));
  assertTrue(getEvaluator().getBooleanResult("matches('5', '[0-6]+')"));
  assertTrue(getEvaluator().getBooleanResult("matches('Ab3', '[A-Za-z0-9]+')"));
  assertTrue(getEvaluator().getBooleanResult("matches('2', '\\d')"));
  assertTrue(!getEvaluator().getBooleanResult("matches('abc', '\\d')"));
}
@Test
public void testMatchesAndInput(){
  assertTrue(getEvaluator().getBooleanResult("matches('abababa','[pos=1]')"));
  assertTrue(getEvaluator().getBooleanResult("matches('5','[0-[pos=2]]+')"));
  assertTrue(getEvaluator().getBooleanResult("matches('[pos=3]', '\\d')"));
}
@Test
public void testMatchesWithVariables(){
  assertTrue(getEvaluator().getBooleanResult("matches('abababa','[var=a]')"));
  assertTrue(getEvaluator().getBooleanResult("matches('5', '[0-[var=b]]+')"));
  assertTrue(getEvaluator().getBooleanResult("matches('[var=c]', '\\d')"));
}
@Test(expected=InvalidEvaluatorFunctionArgumentException.class)
public void testMatchesWithWrongInputCharacter(){
  getEvaluator().getNumberResult("matches(a, a)");
}


@Test(expected=UnsupportedEvaluatorFunctionException.class)
'''isRealNumber''':
public void testMatchesWithOneArgument(){
'''JACK2:'''
  getEvaluator().getNumberResult("matches('abc')");
matches('[pos=1]','^-?\d+(\.|\/)?\d*$')
}
--> [pos=1]=12.7  --> returns ''true''
--> [pos=1]=test  --> returns ''false''
@Test(expected=UnsupportedEvaluatorFunctionException.class)
public void testmatchesWithThreeArguments(){
  getEvaluator().getNumberResult("matches('str', '[i]+', 'string')");
}
@Test(expected=UndefinedExerciseVariableException.class)
public void testMatchesWithMissingExerciseVariable(){
  getEvaluator().getNumberResult("matches('[var=j]', '[var=j]')");
}
@Test(expected=UndefinedFillInVariableException.class)
public void testMatchesWithMissingInput(){
  getEvaluator().getNumberResult("matches('[pos=42]', '[pos=42]')");
}
</syntaxhighlight>


=== Hinweise ===
'''JACK3:'''
matches([input=field1],'^-?\d+(\.|\/)?\d*$')
--> [input=field1]=12.7  --> returns ''true''
--> [input=field1]=test  --> returns ''false''


[[Kategorie:Evaluatorfunktion]]
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:Zeichenkettenfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Aktuelle Version vom 18. April 2024, 10:33 Uhr

Zugehörige Evaluatoren

  • MathEvaluator

Beschreibung

Die Funktion matches prüft, ob ein String einem gegebenen regulären Ausdruck genügt. Die Funktion erwartet zwei Strings, die Zeichenkette, die geprüft werden soll, und den regulärer Ausdruck, der als Grundlage zum Prüfen gilt. Es wird ein Boolean zurückgegeben.

Syntax

matches(Zeichenkette zeichenkette, Zeichenkette regExp)

Parameter

  • zeichenkette - zu prüfende Zeichenkette
  • regExp - regulärer Ausdruck

Return Value

Beispiele

Standardfälle

matches('Abcd0','[A-Za-z0-9]*')   --> returns true

Benutzung von Variablen

matches('abababa','[var=a]')

matches('[var=c]','\\d')

matches([input=field1], concat([var=s3a], '|', [var=s3b], '|', [var=s3c]))

Benutzung von Textfeldern

Bei einigen Testfunktionen kann matches als Ersatz dienen, wenn man Textfelder aber keinen Formeleditor nutzt.

Im folgenden jeweils ein Beispiel für die Ersetzung der Funktionen mit matches.

isElementOf: 

JACK2:
matches('[pos=1]','^(1|2|3)$')
--> [pos=1]=4   --> returns false
--> [pos=1]=2   --> returns true

JACK3:
matches([input=field1],'^(1|2|3)$')
--> [input=field1]=4   --> returns false
--> [input=field1]=2   --> returns true


isFraction: 

JACK2:
matches('[pos=1]','^-?\d+\/\d+$')
--> [pos=1]=12.34   --> returns false
--> [pos=1]=8/9   --> returns true

JACK3:
matches([input=field1],'^-?\d+\/\d+$')
--> [input=field1]=12.34   --> returns false
--> [input=field1]=8/9   --> returns true


isIntegerNumber: 

JACK2:
matches('[pos=1]','^-?\d+$')
--> [pos=1]=12   --> returns true
--> [pos=1]=2.3   --> returns false

JACK3:
matches([input=field1],'^-?\d+$')
--> [input=field1]=12   --> returns true
--> [input=field1]=2.3   --> returns false


isNaturalNumber: 

JACK2:
matches('[pos=1]','^\d+$')
--> [pos=1]=42   --> returns true
--> [pos=1]=-42   --> returns false

JACK3:
matches([input=field1],'^\d+$')
--> [input=field1]=42   --> returns true
--> [input=field1]=-42   --> returns false


isNotElementOf: 

JACK2:
matches('[pos=1]','^((?!1|2).)*$')
--> [pos=1]=2   --> returns false
--> [pos=1]=4   --> returns true

JACK3:
matches([input=field1],'^((?!1|2).)*$')
--> [input=field1]=2   --> returns false
--> [input=field1]=4   --> returns true


isRationalNumber: 

JACK2:
matches('[pos=1]','^-?\d+\.\d+$')
--> [pos=1]=14   --> returns false
--> [pos=1]=12.5   --> returns true

JACK3:
matches([input=field1],'^-?\d+\.\d+$')
--> [input=field1]=14   --> returns false
--> [input=field1]=12.5   --> returns true


isRealNumber: 

JACK2:
matches('[pos=1]','^-?\d+(\.|\/)?\d*$')
--> [pos=1]=12.7   --> returns true
--> [pos=1]=test   --> returns false

JACK3:
matches([input=field1],'^-?\d+(\.|\/)?\d*$')
--> [input=field1]=12.7   --> returns true
--> [input=field1]=test   --> returns false
Abgerufen von „https://wiki.uni-due.de/jack/index.php?title=Matches&oldid=10731“