p5.Table getString() Method

Last Updated : 16 Jul, 2020

The getString() method of p5.Table in p5.js is used to retrieve a String value from the given row and column of the table. The row can be specified by the row ID and the column can be specified by its column ID or column name.

Syntax:

getString( row, column )

Parameters: This method accepts two parameters as mentioned above and described below:

row: It is a number that denotes the row ID of the row.
column: It is a String or Number that denotes the column name or ID of the column.

Return Value: This method returns a String which is the value retrieved from the given row and column of the table.

The examples below illustrate the getString() method in p5.js:

Example 1:

JavaScript

function setup() {
  createCanvas(600, 300);
  textSize(18);

  text("Click on the button to get all " +
  "string values of the table", 20, 20);

  setBtn =
    createButton("Get all table values");
  setBtn.position(30, 40);
  setBtn.mouseClicked(showTable);

  // Create the table
  table = new p5.Table();

  setTableData();
}

function setTableData() {
  table.addColumn('Waterfall');
  table.addColumn('Height');

  let tableRow = table.addRow();
  tableRow.setString('Waterfall',
                     'Angel Falls');
  tableRow.setString('Height',
                     '979 metres');

  tableRow = table.addRow();
  tableRow.setString('Waterfall', 'Tugela Falls');
  tableRow.setString('Height', '948 metres');

  tableRow = table.addRow();
  tableRow.setString('Waterfall', 'Tres Hermanas Falls');
  tableRow.setString('Height', '914 metres');
}

function showTable() {
  clear();
  text("The values of the table are retrieved " +
  "using the getString() method", 20, 20);

  // Show all the columns present
  for (let c = 0; c < table.getColumnCount(); c++) {
    text(table.columns[c], 20 + 200 * c, 80);
  }

  // Show all the rows currently
  // present in the table
  for (let r = 0; r < table.getRowCount(); r++) {
    for (let c = 0; c < table.getColumnCount(); c++) {

      // Get the string at the given row and column
      text(table.getString(r, c),
           20 + 200 * c,
           110 + 20 * r);
    }
  }
}

Output:

Example 2:

JavaScript

function setup() {
  createCanvas(600, 300);
  textSize(18);

  text("Click on the button to get the " +
       "specific string value of the table",
       20, 20);

  text("Enter row and column", 20, 60);

  rowInp = createInput();
  rowInp.position(30, 80);
  rowInp.size(30, 20);

  colInp = createInput();
  colInp.position(70, 80);
  colInp.size(30, 20);

  setBtn =
    createButton("Get value at row and column");
  setBtn.position(30, 110);
  setBtn.mouseClicked(getValueAt);

  // Create the table
  table = new p5.Table();

  setTableData()
}

function setTableData() {

  table.addColumn('Waterfall');
  table.addColumn('Height');

  let tableRow = table.addRow();
  tableRow.setString('Waterfall', 'Angel Falls');
  tableRow.setString('Height', '979 metres');

  tableRow = table.addRow();
  tableRow.setString('Waterfall', 'Tugela Falls');
  tableRow.setString('Height', '948 metres');

  tableRow = table.addRow();
  tableRow.setString('Waterfall', 'Tres Hermanas Falls');
  tableRow.setString('Height', '914 metres');

}

function getValueAt() {
  clear();
  let rowToGet = int(rowInp.value());
  let colToGet = int(colInp.value());

  if (rowToGet < table.getRowCount() &&
      colToGet < table.getColumnCount()) {
    text("The value at row " + rowToGet +
         " and column " + colToGet + " is:",
         20, 160);

    // Get the string at the given row and column
    text(table.getString(rowToGet, colToGet),
         20, 180);
  }
  else
    text("Please enter correct row and " +
         "column values", 20, 160);


  text("Click on the button to get the " +
       "specific string value of the table",
       20, 20);
  text("Enter row and column", 20, 60);
}