sqlsrv_fetch_array(3) [php man page]

SQLSRV_FETCH_ARRAY(3)													     SQLSRV_FETCH_ARRAY(3)

sqlsrv_fetch_array - Returns a row as an array

SYNOPSIS

       array sqlsrv_fetch_array (resource  $stmt, [int	$fetchType], [int  $row], [int	$offset])

DESCRIPTION

	Returns the next available row of data as an associative array, a numeric array, or both (the default).

PARAMETERS

	      o $stmt
		- A statement resource returned by sqlsrv_query or sqlsrv_prepare.

	      o $fetchType
		-  A predefined constant specifying the type of array to return. Possible values are SQLSRV_FETCH_ASSOC, SQLSRV_FETCH_NUMERIC, and
		SQLSRV_FETCH_BOTH (the default).  A fetch type of SQLSRV_FETCH_ASSOC should not be used when consuming a result set with  multiple
		columns of the same name.

	      o $row
		-  Specifies  the  row	to  access  in	a  result  set that uses a scrollable cursor. Possible values are SQLSRV_SCROLL_NEXT, SQL-
		SRV_SCROLL_PRIOR, SQLSRV_SCROLL_FIRST, SQLSRV_SCROLL_LAST, SQLSRV_SCROLL_ABSOLUTE and, SQLSRV_SCROLL_RELATIVE (the default).  When
		this parameter is specified, the $fetchType must be explicitly defined.

	      o $offset
		-  Specifies the row to be accessed if the row parameter is set to SQLSRV_SCROLL_ABSOLUTE or SQLSRV_SCROLL_RELATIVE. Note that the
		first row in a result set has index 0.

RETURN VALUES

	Returns an array on success, NULL if there are no more rows to return, and FALSE if an error occurs.

EXAMPLES

       Example #1

	      Retrieving an associative array.

	      <?php
	      $serverName = "serverNameinstanceName";
	      $connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
	      $conn = sqlsrv_connect( $serverName, $connectionInfo );
	      if( $conn === false ) {
		  die( print_r( sqlsrv_errors(), true));
	      }

	      $sql = "SELECT FirstName, LastName FROM SomeTable";
	      $stmt = sqlsrv_query( $conn, $sql );
	      if( $stmt === false) {
		  die( print_r( sqlsrv_errors(), true) );
	      }

	      while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_ASSOC) ) {
		    echo $row['LastName'].", ".$row['FirstName']."<br />";
	      }

	      sqlsrv_free_stmt( $stmt);
	      ?>

       Example #2

	      Retrieving a numeric array.

	      <?php
	      $serverName = "serverNameinstanceName";
	      $connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
	      $conn = sqlsrv_connect( $serverName, $connectionInfo );
	      if( $conn === false ) {
		  die( print_r( sqlsrv_errors(), true));
	      }

	      $sql = "SELECT FirstName, LastName FROM SomeTable";
	      $stmt = sqlsrv_query( $conn, $sql );
	      if( $stmt === false) {
		  die( print_r( sqlsrv_errors(), true) );
	      }

	      while( $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_NUMERIC) ) {
		    echo $row[0].", ".$row[1]."<br />";
	      }

	      sqlsrv_free_stmt( $stmt);
	      ?>

NOTES

	Not specifying the $fetchType or explicity using the SQLSRV_FETCH_TYPE constant in the examples above will return an array that  has  both
       associative and numeric keys.

	If more than one column is returned with the same name, the last column will take precedence. To avoid field name collisions, use aliases.

	If a column with no name is returned, the associative key for the array element will be an empty string ("").

SEE ALSO

       sqlsrv_connect(3), sqlsrv_query(3), sqlsrv_errors(3), sqlsrv_fetch(3).

PHP Documentation Group 												     SQLSRV_FETCH_ARRAY(3)

Check Out this Related Man Page

SQLSRV_CANCEL(3)														  SQLSRV_CANCEL(3)

sqlsrv_cancel - Cancels a statement

SYNOPSIS

       bool sqlsrv_cancel (resource  $stmt)

DESCRIPTION

	Cancels  a  statement.	Any results associated with the statement that have not been consumed are deleted. After sqlsrv_cancel(3) has been
       called, the specified statement can be re-executed if it was created with sqlsrv_prepare(3). Calling sqlsrv_cancel(3) is not  necessary	if
       all the results associated with the statement have been consumed.

PARAMETERS

	      o $stmt
		- The statement resource to be cancelled.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      sqlsrv_cancel(3) example

	      <?php
	      $serverName = "serverNamesqlexpress";
	      $connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
	      $conn = sqlsrv_connect( $serverName, $connectionInfo);
	      if( $conn === false ) {
		   die( print_r( sqlsrv_errors(), true));
	      }

	      $sql = "SELECT Sales FROM Table_1";

	      $stmt = sqlsrv_prepare( $conn, $sql);

	      if( $stmt === false ) {
		   die( print_r( sqlsrv_errors(), true));
	      }

	      if( sqlsrv_execute( $stmt ) === false) {
		   die( print_r( sqlsrv_errors(), true));
	      }

	      $salesTotal = 0;
	      $count = 0;

	      while( ($row = sqlsrv_fetch_array( $stmt)) && $salesTotal <=100000)
	      {
		   $qty = $row[0];
		   $price = $row[1];
		   $salesTotal += ( $price * $qty);
		   $count++;
	      }

	      echo "$count sales accounted for the first $$salesTotal in revenue.<br />";

	      // Cancel the pending results. The statement can be reused.
	      sqlsrv_cancel( $stmt);
	      ?>

NOTES

	The  main  difference between sqlsrv_cancel(3) and sqlsrv_free_stmt(3) is that a statement resource cancelled with sqlsrv_cancel(3) can be
       re-executed if it was created with sqlsrv_prepare(3). A statement resource cancelled with sqlsrv_free_statement(3) cannot be re-executed.

SEE ALSO

       sqlsrv_free_stmt(3), sqlsrv_prepare(3).

PHP Documentation Group 													  SQLSRV_CANCEL(3)

Linux and UNIX Man Pages

sqlsrv_fetch_array(3) [php man page]

Check Out this Related Man Page