sqlsrv_rows_affected(3) [php man page]

SQLSRV_ROWS_AFFECTED(3) 												   SQLSRV_ROWS_AFFECTED(3)

sqlsrv_rows_affected - Returns the number of rows modified by the last INSERT, UPDATE, or DELETE query executed

SYNOPSIS

       int sqlsrv_rows_affected (resource  $stmt)

DESCRIPTION

	Returns  the  number  of  rows	modified  by  the  last INSERT, UPDATE, or DELETE query executed. For information about the number of rows
       returned by a SELECT query, see sqlsrv_num_rows(3).

PARAMETERS

	      o $stmt
		- The executed statement resource for which the number of affected rows is returned.

RETURN VALUES

	Returns the number of rows affected by the last INSERT, UPDATE, or DELETE query. If no rows were affected, 0 is returned. If the number of
       affected rows cannot be determined, -1 is returned. If an error occurred, FALSE is returned.

EXAMPLES

       Example #1

	      sqlsrv_rows_affected(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 = "UPDATE Table_1 SET data = ? WHERE id = ?";

	      $params = array("updated data", 1);

	      $stmt = sqlsrv_query( $conn, $sql, $params);

	      $rows_affected = sqlsrv_rows_affected( $stmt);
	      if( $rows_affected === false) {
		   die( print_r( sqlsrv_errors(), true));
	      } elseif( $rows_affected == -1) {
		    echo "No information available.<br />";
	      } else {
		    echo $rows_affected." rows were updated.<br />";
	      }
	      ?>

SEE ALSO

       sqlsrv_num_rows(3).

PHP Documentation Group 												   SQLSRV_ROWS_AFFECTED(3)

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)