User Tools

Site Tools


k9:k9.4:start

9.4 Drawing test functions

You can use the character test functions to check whether there are only certain characters in a string.

  • The argument (argument or expression or exp) for all character test functions is of the data type string.
  • The function value is always of the data type Boolean.
FunctionDescription
IsAscii (argument AS String)
Ascii? (argument AS string) Returns True if the argument contains ASCII characters after it has been converted to a string. An ASCII character is a character whose code is less than or equal to 127.
IsBlank (argument AS String)
Blank? (argument AS String) Returns True if argument contains only spaces as string. A space is a space or the tab character. The line break \n and a return \r are not considered as spaces.
IsDigit (argument AS String)
Digit? (argument AS String) Returns True if the argument contains digits only. A digit is one of the following characters: 0 1 2 2 3 4 5 6 6 7 8 9.
IsHexa (expression AS string)
Hexa? (Expression AS string) Returns True if the expression contains only the following characters: 0 1 2 3 3 4 5 6 6 7 8 9 A B C D E F a b c d e f.
IsLCase (argument AS String)
IsLower (argument AS String) Returns True if the argument contains only ASCII lowercase letters. A lower case letter is one of the following characters: a b c c d e f g h i j k l l m n o p q r s t u w x y z.
IsUCase (Exp AS String)
IsUpper (Exp AS String) Returns True if the expression contains only ASCII capital letters. A capital letter is one of the following characters: A B C D E E F G H I J K L M N O P Q R S T U V W X X Y Z. Other characters are not considered capital letters.
IsLetter (argument AS string) Returns true if the argument contains only letters. A letter is one of the following characters: ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz.
IsPunct (Exp AS String) Returns True if the expression contains punctuation characters only. A punctuation mark is one of the following:“! # $ % &' () ★ +,- /:;.? < = > @[ \] # { { } ~ Pipe Caret
IsSpace (Exp AS String) Returns True if the expression contains spaces only. The following characters are interpreted as blanks: Space, page feed Chr$ (12), line break “\n”, carriage return (CR)“\r”, horizontal tab “\t” and the vertical tab Chr$ (11).

Table 9.4.1: Overview of the character test functions

Examples:

PRINT IsAscii("Gambas"), IsAscii(Now), IsAscii(188), IsAscii("Benoît") 
True    True    True    False

PRINT IsBlank(" \t"), IsBlank("Test") 
True 	 False

PRINT IsDigit("2014"), IsDigit("123a") 
True    False

Print IsHexa("C3DDFF"), IsHexa("Bad") 
True    True

Print IsHexa("GAMBAS"), IsHexa(""), IsHexa(Null), IsHexa("Arie")
False   False   False   False

Print IsLCase("klein"), IsLCase("groß"), IsLCase("123a")
True    False   False

Print IsUCase("GAMBAS"), IsUCase("ÄRGER")
True    False

Print IsPunct(":-)"), IsPunct(":-p")
True    False

PRINT IsLetter("Gambas?"), IsLetter("Ja - Gambas!"), IsLetter("Stimmt")
False   False   True

Print "IsSpace = "; IsSpace(" \\n \\r\\n"), IsSpace(gb.NewLine)
IsSpace = False   True

Download

9.4 Zeichentest-Funktionen

Mit den Zeichentest-Funktionen können Sie prüfen, ob in einer Zeichenkette (String) nur ganz bestimmte Zeichen vorhanden sind.

  • Das Argument (Argument oder Expression oder Exp) für alle Zeichentest-Funktionen ist vom Daten-Typ String.
  • Der Funktionswert ist stets vom Daten-Typ Boolean.


1x1FunktionBeschreibung
IsAscii ( Argument AS String )
Ascii? ( Argument AS String ) Gibt True zurück, wenn das Argument - nachdem es in einen String konvertiert wurde - ASCII-Zeichen enthält. Ein ASCII-Zeichen ist ein Zeichen, dessen Code kleiner oder gleich 127 ist.
IsBlank ( Argument AS String )
Blank? ( Argument AS String ) Gibt True zurück, wenn Argument als String nur Leerzeichen enthält. Ein Leerzeichen ist ein Leerzeichen oder das Tabulator-Zeichen. Der Zeilenumbruch \n und ein Return \r werden nicht als Leerzeichen betrachtet.
IsDigit ( Argument AS String )
Digit? ( Argument AS String ) Gibt True zurück, wenn das Argument nur Ziffern enthält. Eine Ziffer ist eines der folgenden Zeichen: 0 1 2 3 4 5 6 7 8 9.
IsHexa ( Expression AS String )
Hexa? ( Expression AS String ) Gibt True zurück, wenn der Ausdruck nur folgende Zeichen enthält: 0 1 2 3 4 5 6 7 8 9 A B C D E F a b c d e f.
IsLCase ( Argument AS String )
IsLower ( Argument AS String ) Gibt True zurück, wenn das Argument nur ASCII-Kleinbuchstaben enthält. Ein Kleinbuchstabe ist eines der folgenden Zeichen: a b c d e f g h i j k l m n o p q r s t u v w x y z.
IsUCase ( Exp AS String )
IsUpper ( Exp AS String ) Gibt True zurück, wenn der Ausdruck nur ASCII-Großbuchstaben enthält. Ein Großbuchstabe ist eines der folgenden Zeichen: A B C D E F G H I J K L M N O P Q R S T U V W X Y Z. Andere Zeichen werden nicht als Großbuchstaben angesehen.
IsLetter ( Argument AS String ) Gibt True zurück, wenn das Argument nur Buchstaben enthält. Ein Buchstabe ist eines der folgenden Zeichen: ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz.
IsPunct ( Exp AS String ) Gibt True zurück, wenn der Ausdruck nur Satzzeichen enthält. Ein Satzzeichen ist eines der folgenden Zeichen: ! ” # $ % & ' ( ) ★ + ,- / : ; . ? < = > @ [ \ ] _` { } ~ Pipe Caret
IsSpace ( Exp AS String ) Gibt True zurück, wenn der Ausdruck nur Leerzeichen enthält. Als Leerzeichen werden folgende Zeichen interpretiert: Leerzeichen (Space), Seiten-Vorschub Chr$(12), Zeilen-Umbruch “\n”, Wagenrücklauf (CR) “\r”, horizontaler Tabulator “\t” und der vertikale Tabulator Chr$(11).

Tabelle 9.4.1: Übersicht zu den Zeichentest-Funktionen

Beispiele:

PRINT IsAscii("Gambas"), IsAscii(Now), IsAscii(188), IsAscii("Benoît") 
True    True    True    False

PRINT IsBlank(" \t"), IsBlank("Test") 
True 	 False

PRINT IsDigit("2014"), IsDigit("123a") 
True    False

Print IsHexa("C3DDFF"), IsHexa("Bad") 
True    True

Print IsHexa("GAMBAS"), IsHexa(""), IsHexa(Null), IsHexa("Arie")
False   False   False   False

Print IsLCase("klein"), IsLCase("groß"), IsLCase("123a")
True    False   False

Print IsUCase("GAMBAS"), IsUCase("ÄRGER")
True    False

Print IsPunct(":-)"), IsPunct(":-p")
True    False

PRINT IsLetter("Gambas?"), IsLetter("Ja - Gambas!"), IsLetter("Stimmt")
False   False   True

Print "IsSpace = "; IsSpace(" \\n \\r\\n"), IsSpace(gb.NewLine)
IsSpace = False   True

Download

The website uses a temporary session cookie. This technically necessary cookie is deleted when the browser is closed. You can find information on cookies in our privacy policy.
k9/k9.4/start.txt · Last modified: 02.07.2018 (external edit)

Page Tools