sqlsrv_get_field(3) [php man page]

SQLSRV_GET_FIELD(3)													       SQLSRV_GET_FIELD(3)

sqlsrv_get_field - Gets field data from the currently selected row

SYNOPSIS

       mixed sqlsrv_get_field (resource  $stmt, int  $fieldIndex, [int	$getAsType])

DESCRIPTION

	Gets field data from the currently selected row. Fields must be accessed in order. Field indices start at 0.

PARAMETERS

	      o $stmt
		- A statement resource returned by sqlsrv_query(3) or sqlsrv_execute(3).

	      o $fieldIndex
		-  The	index  of  the field to be retrieved. Field indices start at 0. Fields must be accessed in order. i.e. If you access field
		index 1, then field index 0 will not be available.

	      o $getAsType
		- The PHP data type for the returned field data. If this parameter is not set, the field data will be returned as its default  PHP
		data type. For information about default PHP data types, see Default PHP Data Types in the Microsoft SQLSRV documentation.

RETURN VALUES

	Returns data from the specified field on success. Returns FALSE otherwise.

EXAMPLES

       Example #1

	      sqlsrv_get_field(3) example

	       The following example demonstrates how to retrieve a row with sqlsrv_fetch(3) and get the row fields with sqlsrv_get_field(3).

	      <?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 Name, Comment
		      FROM Table_1
		      WHERE ReviewID=1";
	      $stmt = sqlsrv_query( $conn, $sql);
	      if( $stmt === false ) {
		   die( print_r( sqlsrv_errors(), true));
	      }

	      // Make the first (and in this case, only) row of the result set available for reading.
	      if( sqlsrv_fetch( $stmt ) === false) {
		   die( print_r( sqlsrv_errors(), true));
	      }

	      // Get the row fields. Field indeces start at 0 and must be retrieved in order.
	      // Retrieving row fields by name is not supported by sqlsrv_get_field.
	      $name = sqlsrv_get_field( $stmt, 0);
	      echo "$name: ";

	      $comment = sqlsrv_get_field( $stmt, 1);
	      echo $comment;
	      ?>

SEE ALSO

       sqlsrv_fetch(3), sqlsrv_fetch_array(3), sqlsrv_fetch_object(3).

PHP Documentation Group 												       SQLSRV_GET_FIELD(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)