The matchRow() method of p5.Table in p5.js is used to find the first row that matches the given regular expression and returns a reference to that row. The column that the method uses to search the row can be specified as a parameter. The method only returns the first row of the possible matches even if multiple matches of the regular expression exist.
Syntax:
matchRow( regexp, column )
Parameters: This method accepts two parameters as mentioned above and described below:
- regexp: It is a String or RegExp object that specifies the regular expression to match.
- column: It is a String or number that denotes the column name or ID of the column.
Return Value: This method returns a p5.TableRow object which matches the given regular expression.
The example below illustrates the match Row() method in p5.js:
Example:
function setup() { createCanvas(500, 300); textSize(16); matchQueryInput = createInput(); matchQueryInput.position(30, 40); getColBtn = createButton("Get the matching row"); getColBtn.position(30, 70); getColBtn.mouseClicked(getMatchResults); // Create the table table = new p5.Table(); // Add two columns table.addColumn("name"); table.addColumn("id"); // Add some rows to the table let newRow = table.addRow(); newRow.setString("name", "mary"); newRow.setString("id", 21); newRow = table.addRow(); newRow.setString("name", "marco6"); newRow.setString("id", 27); newRow = table.addRow(); newRow.setString("name", "tunisia 4"); newRow.setString("id", 32); newRow = table.addRow(); newRow.setString("name", "user 23"); newRow.setString("id", 32); newRow = table.addRow(); newRow.setString("name", "admin"); newRow.setString("id", 45); newRow = table.addRow(); newRow.setString("name", "mikasa"); newRow.setString("id", 23); showTable(); } function getMatchResults() { clear(); let matchQuery = matchQueryInput.value(); // Get the row values using matchRow() if (matchQuery != "") { // Match the query in the column of 'name' matchResults = table.matchRow(new RegExp(matchQuery), "name"); if (matchResults) { text("The row that matches the " + "query is", 20, 120); // Display the matched value text(matchResults.arr[0], 20, 140); text(matchResults.arr[1], 120, 140); } else text("No Results Found", 20, 120); } else { text("The query string is empty", 20, 120); } text("Enter a string to find it in " + "the 'name' column table", 20, 20); } function showTable() { clear(); // Display the total rows present in the table text("There are " + table.getRowCount() + " rows in the table", 20, 120); for (let r = 0; r < table.getRowCount(); r++) for (let c = 0; c < table.getColumnCount(); c++) text(table.getString(r, c), 20 + c * 100, 140 + r * 20); text("Enter a string to find it in " + "the 'name' column table", 20, 20); } |
Output:
Environment Setup: https://www.geeksforgeeks.org/p5-js-soundfile-object-installation-and-methods/
Reference: https://p5js.org/reference/#/p5.Table/matchRow
