DocumentationHackReferenceClassAsyncMysqlQueryResultvectorRowsTyped

AsyncMysqlQueryResult::vectorRowsTyped

Returns the actual rows returned by the successful query, each row including the typed values for each column

public function vectorRowsTyped(): Vector<KeyedContainer<int, mixed>>;

The rows are returned as a Vector of Vector objects which hold the (possibly null) mixed values of each column in the order of the original query (e.g., an INTEGER column will come back as an int.).

Returns

Vector<KeyedContainer<int,mixed>> - A Vector of Vector objects, where the outer Vector represents the rows and each inner Vector represent the typed column values for each row.

Examples

When executing a query, you can get the rows returned from it in the form of a Vector of Vector objects, where each value of the Vector is a column value. This example shows how to use AsyncMysqlQueryResult::vectorRowsTyped to get that Vector. A resulting Vector may look like:

object(HH\Vector)#9 (2) {
  [0]=>
  object(HH\Vector)#10 (2) {
    [0]=>
    string(11) "Joel Marcey"
    [1]=>
    int(41)
  }
  [1]=>
  object(HH\Vector)#11 (2) {
    [0]=>
    string(11) "Fred Emmott"
    [1]=>
    int(26)
  }
}

Note that all values in the Vector returned from vectorRowsTyped will be the actual typed representation of the database type, or null. Above you can see we have string and int. If you want just string values for everything, use vectorRows

Also understand that if you want the actual column names associated with the values in the Vector, you should use mapRowsTyped instead.

use \Hack\UserDocumentation\API\Examples\AsyncMysql\ConnectionInfo as CI;

async function connect(
  \AsyncMysqlConnectionPool $pool,
): Awaitable<\AsyncMysqlConnection> {
  return await $pool->connect(
    CI::$host,
    CI::$port,
    CI::$db,
    CI::$user,
    CI::$passwd,
  );
}
async function simple_query(): Awaitable<int> {
  $pool = new \AsyncMysqlConnectionPool(darray[]);
  $conn = await connect($pool);
  $result = await $conn->query(
    'SELECT name, age FROM test_table WHERE userID < 50',
  );
  \var_dump($result->vectorRowsTyped()->count() === $result->numRows());
  $conn->close();
  return $result->numRows();
}

<<__EntryPoint>>
async function run(): Awaitable<void> {
  $r = await simple_query();
  \var_dump($r);
}
```.hhvm.expectf
bool(true)
int(%d)
```.example.hhvm.out
bool(true)
int(1)
```.skipif
await \Hack\UserDocumentation\API\Examples\AsyncMysql\skipif_async();