Checking input
A sign-up desk on a laptop: it asks for a player name and the coordinates of a home. A name like Al or Steve the Great is sent back, and so are coordinates like 12 sixty -30. Coordinates typed sloppily, like 12, 64 ,-30, are tidied up, and at the end the desk writes Welcome, Steve_42! Home: x=12 y=64 z=-30.
Functions: REGEX_MATCH and REGEX_REPLACE
What you need
A trigger block with a button and a laptop. The program has no parameters and no results, so the trigger block needs no items.
The idea
Players type all kinds of things. Checking a text character by character with INSTR and MID takes many lines; a regular expression describes the form of a text in one: ^[A-Za-z0-9_]{3,16}$ means "3 to 16 letters, digits or underscores, and nothing else". REGEX_MATCH says whether a text has that form.
REGEX_REPLACE finds the parts of a text that match a pattern and replaces them, like the command s of sed. With the flag g, it replaces all of them: [ ,]+ turns every row of spaces and commas into one space. Parentheses in the pattern make groups, and \1, \2 and \3 in the replacement put the text of a group back in – that's how 12 64 -30 becomes x=12 y=64 z=-30.
c0de uses the regular expressions of Java; the page of REGEX_MATCH lists what they can do.
The program
PROGRAM checking
NOOP
INCLUDE c0de/strings
NOOP
FUNCTION askName
RESULT name STRING
BEGIN
VARIABLE ok BOOLEAN
REPEAT
BEGIN
CALL PRINT
PARAMETER value "Your name:" ;
CALL INPUT
PARAMETER variable name ;
CALL c0de/strings/REGEX_MATCH
PARAMETER text name ;
PARAMETER pattern "^[A-Za-z0-9_]{3,16}$" ;
RESULT result ok
IF NOT ok ;
BEGIN
CALL PRINT
PARAMETER value "? 3 to 16 letters, digits or _" ;
END IF
END REPEAT NOT ok ;
END FUNCTION
NOOP
FUNCTION askHome
RESULT home STRING
BEGIN
VARIABLE ok BOOLEAN
REPEAT
BEGIN
CALL PRINT
PARAMETER value "Your home (x y z):" ;
CALL INPUT
PARAMETER variable home ;
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "[ ,]+" ;
PARAMETER replacement " " ;
PARAMETER flags "g" ;
RESULT result home
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "^ | $" ;
PARAMETER replacement "" ;
PARAMETER flags "g" ;
RESULT result home
CALL c0de/strings/REGEX_MATCH
PARAMETER text home ;
PARAMETER pattern "^-?[0-9]+ -?[0-9]+ -?[0-9]+$" ;
RESULT result ok
IF NOT ok ;
BEGIN
CALL PRINT
PARAMETER value "? three whole numbers, like 12 64 -30" ;
END IF
END REPEAT NOT ok ;
END FUNCTION
NOOP
FUNCTION signup
BEGIN
VARIABLE name STRING
VARIABLE home STRING
VARIABLE coordinates STRING
CALL CLS
CALL askName
RESULT name name
CALL askHome
RESULT home home
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "(-?[0-9]+) (-?[0-9]+) (-?[0-9]+)" ;
PARAMETER replacement "x=\\1 y=\\2 z=\\3" ;
RESULT result coordinates
CALL PRINT
PARAMETER value "Welcome, " ⊕ name ⊕ "! Home: " ⊕ coordinates ;
END FUNCTIONThe text notation writes a backslash in a text as \\ (see literals). In the dialog of the LITERAL block, you type the replacement as x=\1 y=\2 z=\3.
Building and running it
- Place the laptop, right-click it, click the buttons until they show
checkingandsignup, and click ✔. - Set the trigger block to the same program and function and press the button.
- Open the laptop. Below the screen, the input line shows
INPUT name (STRING):, laterINPUT home (STRING):. Type the lines one by one and press Enter after each:
Al
Steve the Great
Steve_42
12 sixty -30
12,64
12, 64 ,-30The screen shows each line you typed and the answer below it:
Your name:
Al
? 3 to 16 letters, digits or _
Your name:
Steve the Great
? 3 to 16 letters, digits or _
Your name:
Steve_42
Your home (x y z):
12 sixty -30
? three whole numbers, like 12 64 -30
Your home (x y z):
12,64
? three whole numbers, like 12 64 -30
Your home (x y z):
12, 64 ,-30
Welcome, Steve_42! Home: x=12 y=64 z=-30
Spaces in front of or behind the coordinates don't matter either.
How it works
askNameasks until the name has the right form. In^[A-Za-z0-9_]{3,16}$, the brackets are a character class: one character out of the rangesAtoZ,atoz,0to9, or_.{3,16}repeats it 3 to 16 times.^and$tie the pattern to the start and the end of the text. Without them, a part of the text would be enough:Steve the GreatcontainsSteve, which has the right form.askHomefirst cleans up what the player typed. The first REGEX_REPLACE turns every row of spaces and commas ([ ,]+, the+means "one or more") into a single space; the flaggdoes it for all matches, not only the first. The second one removes a space at the start or at the end:|means "or", and the replacement is the empty text.- Then REGEX_MATCH checks the cleaned text:
-?is an optional minus sign,[0-9]+one or more digits, and the spaces between them are just spaces.12 sixty -30and12,64don't have this form, and the REPEAT loop asks again. signupreformats the coordinates. Each(-?[0-9]+)is a group; in the replacement,\1is the text of the first group,\2of the second and\3of the third. The pattern matches only once, so no flag is needed.&would put in the whole match.[0-9]could also be written\d, and[A-Za-z0-9_]is the same as\w– in the text notation\\dand\\w. A pattern with a mistake, like a missing], raises INVALID_ARGUMENT, and so does a pattern that would take too long.
Try it yourself
- Some names are reserved: refuse every name that contains
admin, in any case –SuperAdminandadmin_1too.
Solution
PROGRAM checking
NOOP
INCLUDE c0de/strings
NOOP
FUNCTION askName
RESULT name STRING
BEGIN
VARIABLE ok BOOLEAN
VARIABLE admin BOOLEAN
REPEAT
BEGIN
CALL PRINT
PARAMETER value "Your name:" ;
CALL INPUT
PARAMETER variable name ;
CALL c0de/strings/REGEX_MATCH
PARAMETER text name ;
PARAMETER pattern "^[A-Za-z0-9_]{3,16}$" ;
RESULT result ok
IF NOT ok ;
BEGIN
CALL PRINT
PARAMETER value "? 3 to 16 letters, digits or _" ;
END IF
CALL c0de/strings/REGEX_MATCH
PARAMETER text name ;
PARAMETER pattern "(?i)admin" ;
RESULT result admin
IF admin ;
BEGIN
CALL PRINT
PARAMETER value "? that name is reserved" ;
END IF
END REPEAT NOT ok OR admin ;
END FUNCTION
NOOP
FUNCTION askHome
RESULT home STRING
BEGIN
VARIABLE ok BOOLEAN
REPEAT
BEGIN
CALL PRINT
PARAMETER value "Your home (x y z):" ;
CALL INPUT
PARAMETER variable home ;
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "[ ,]+" ;
PARAMETER replacement " " ;
PARAMETER flags "g" ;
RESULT result home
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "^ | $" ;
PARAMETER replacement "" ;
PARAMETER flags "g" ;
RESULT result home
CALL c0de/strings/REGEX_MATCH
PARAMETER text home ;
PARAMETER pattern "^-?[0-9]+ -?[0-9]+ -?[0-9]+$" ;
RESULT result ok
IF NOT ok ;
BEGIN
CALL PRINT
PARAMETER value "? three whole numbers, like 12 64 -30" ;
END IF
END REPEAT NOT ok ;
END FUNCTION
NOOP
FUNCTION signup
BEGIN
VARIABLE name STRING
VARIABLE home STRING
VARIABLE coordinates STRING
CALL CLS
CALL askName
RESULT name name
CALL askHome
RESULT home home
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "(-?[0-9]+) (-?[0-9]+) (-?[0-9]+)" ;
PARAMETER replacement "x=\\1 y=\\2 z=\\3" ;
RESULT result coordinates
CALL PRINT
PARAMETER value "Welcome, " ⊕ name ⊕ "! Home: " ⊕ coordinates ;
END FUNCTIONThe second REGEX_MATCH has no ^ and $, so admin may be anywhere in the name. REGEX_MATCH has no flags; (?i) at the start of the pattern switches on ignoring the case. The loop repeats while the name has the wrong form or is reserved.
- Let players also type the coordinates the way the desk writes them:
X=12, Y = 64, Z=-30.
Solution
PROGRAM checking
NOOP
INCLUDE c0de/strings
NOOP
FUNCTION askName
RESULT name STRING
BEGIN
VARIABLE ok BOOLEAN
REPEAT
BEGIN
CALL PRINT
PARAMETER value "Your name:" ;
CALL INPUT
PARAMETER variable name ;
CALL c0de/strings/REGEX_MATCH
PARAMETER text name ;
PARAMETER pattern "^[A-Za-z0-9_]{3,16}$" ;
RESULT result ok
IF NOT ok ;
BEGIN
CALL PRINT
PARAMETER value "? 3 to 16 letters, digits or _" ;
END IF
END REPEAT NOT ok ;
END FUNCTION
NOOP
FUNCTION askHome
RESULT home STRING
BEGIN
VARIABLE ok BOOLEAN
REPEAT
BEGIN
CALL PRINT
PARAMETER value "Your home (x y z):" ;
CALL INPUT
PARAMETER variable home ;
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "[xyz] *=" ;
PARAMETER replacement "" ;
PARAMETER flags "gi" ;
RESULT result home
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "[ ,]+" ;
PARAMETER replacement " " ;
PARAMETER flags "g" ;
RESULT result home
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "^ | $" ;
PARAMETER replacement "" ;
PARAMETER flags "g" ;
RESULT result home
CALL c0de/strings/REGEX_MATCH
PARAMETER text home ;
PARAMETER pattern "^-?[0-9]+ -?[0-9]+ -?[0-9]+$" ;
RESULT result ok
IF NOT ok ;
BEGIN
CALL PRINT
PARAMETER value "? three whole numbers, like 12 64 -30" ;
END IF
END REPEAT NOT ok ;
END FUNCTION
NOOP
FUNCTION signup
BEGIN
VARIABLE name STRING
VARIABLE home STRING
VARIABLE coordinates STRING
CALL CLS
CALL askName
RESULT name name
CALL askHome
RESULT home home
CALL c0de/strings/REGEX_REPLACE
PARAMETER text home ;
PARAMETER pattern "(-?[0-9]+) (-?[0-9]+) (-?[0-9]+)" ;
PARAMETER replacement "x=\\1 y=\\2 z=\\3" ;
RESULT result coordinates
CALL PRINT
PARAMETER value "Welcome, " ⊕ name ⊕ "! Home: " ⊕ coordinates ;
END FUNCTIONA third REGEX_REPLACE comes first and removes every x, y or z with its =, and the spaces in between ([xyz] *=). The flag g removes all three, and i also finds X, Y and Z. What remains, 12, 64, -30, is cleaned up as before.
Read more
- c0de/strings: REGEX_MATCH, REGEX_REPLACE
- Reading commands: cutting a line into words with INSTR and MID
- Literals: how the text notation writes a backslash
- WHILE and REPEAT
- INPUT and the laptop