mssql_fetch_array

(PHP 4, PHP 5, PECL odbtp >= 1.1.1)

mssql_fetch_array — Liefert einen Ergebnis-Datensatz als assoziatives Array, als numerisches Array oder beides

Warnung

Diese Funktion wurde in PHP 7.0.0 REMOVED (entfernt).

Alternativ können folgende Features verwendet werden:

Beschreibung

mssql_fetch_array ( resource $result [, int $result_type = MSSQL_BOTH ] ) : array

mssql_fetch_array() ist die erweiterte Version von mssql_fetch_row(). Zusätzlich zum Speichern der Daten in den numerischen Indizes des Ergebnisarrays, speichert sie die Daten unter Verwendung der Feldnamen als Schlüssel auch in assoziativen Indizes.

Wichtige Anmerkung: die Verwendung von mssql_fetch_array() ist nur unwesentlich langsamer als die Verwendung von mssql_fetch_row(), bietet aber wesentlich mehr.

Parameter-Liste

result: Der Bezeichner des Ergebnisses, das ausgewertet wird. Dieses Ergebnis stammt von einem Aufruf von mssql_query().
result_type: Der Typ des Arrays, das abgerufen werden soll. Er ist eine Konstante, der die folgenden Werte annehmen kann: MSSQL_ASSOC, MSSQL_NUM und MSSQL_BOTH.

Rückgabewerte

Gibt ein Array mit dem gelieferten Datensatz zurück oder FALSE, wenn es keinen weiteren Datensatz gibt.

Beispiele

Beispiel #1 mssql_fetch_array()-Beispiel


<?php
// Eine Select-Anfrage an MSSQL senden
$anfrage = mssql_query('SELECT [username], [name] FROM [php].[dbo].[userlist]');

// Überprüfen, ob es Datensätze gab
if (!mssql_num_rows($anfrage)) {
    echo 'Keine Datensätze gefunden';
} else {
    // Folgendes ist mit dem Code darunter identisch:
    //
    // while ($datensatz = mssql_fetch_row($anfrage))

    while ($datensatz = mssql_fetch_array($anfrage, MSSQL_NUM)) {
        // ...
    }
}

// Den Ergebnisspeicher freigeben
mssql_free_result($anfrage);
?>

Anmerkungen

Hinweis: Feldnamen, die von dieser Funktion zurückgegeben werden, unterscheiden sich in der Groß-/Kleinschreibung.

Hinweis: Diese Funktion setzt NULL-Felder auf den PHP Wert-NULL.

Siehe auch

mssql_fetch_row() - Liefert einen Datensatz als indiziertes Array

add a note

User Contributed Notes 13 notes

down

blood - demon at gmx dot net ¶

17 years ago


Note that if you fetch varchar fields larger than 255 letters the result will be cut off at 255 letters. 

To prevent this you have to do a CONVERT(TEXT,data_field) for this fields in your select clause.

down

Bryan ¶

17 years ago


Calling this function with the option second parameter is causing a "Wrong parameter count" message. If you run into this problem, you can get the same effect by calling different functions:

mssql_fetch_array: MSSQL_BOTH
mssql_fetch_assoc: MSSQL_ASSOC
mssql_fetch_row: MSSQL_NUM

down

hackajar matt yahoo trot com ¶

20 years ago


from php-dev mailing list article - 
#26012 [Bgs]: mssql_fetch_array 

"Previously mssql data was always rtrimed, however that's wrong because it modifies the original data. This caused a problem for people who needed those trailing space. Ultimately, the job of database extension is to fetch the data as is (like other db extensions already do) and not to mangle it in any way."

moving from <4.3.4 to a higher version you will have this now:

$query = "Select dumb_spaces from dbo.table where weak_sause = 'true'";
$result = mssql_query($query) or die("Spicy Sause! Query = $query");

while($line = mssql_fetch_array($result, MSSQL_ASSOC) {
     foreach($line as $bs_trim) {
          //Trim whitespace from end of query
          $bs_trim = rtrim($bs_trim);
          echo "Clean!".$bs_trim;
     }
}

down

archwisp at gmail dot com ¶

20 years ago


[Editor's Note: NULLs *are* distinguishable from 0.  See the manual section on comparison operators. ]

microsoft sql 2000 server
php running on windows 2000

Using the $row = mssql_fetch_array($result)

A null value will return 0, this is a problem if you are using 0 and some identifier for a value.  you should convert all nulls to something like -1 or "NO VALUE"

******

After extensive testing, the above statements both seem to be true. You *can* distinguish between 0 and null values in PHP; however, the mssql_fetch_array function does not set null colums to the php NULL value. 

if ($row['Null_Column'] === 0) { print('pass'); }

A null column passes the above test. Seems to be a bug in the function.

down

flatcable2000 at yahoo dot com ¶

21 years ago


Apparently php 4.0.6 does not support the second parameter. When used the error sounds
"Wrong parameter count for mssql_fetch_array"

down

shaver at qspeed dot com ¶

21 years ago


Note that the second parameter is the same as the msql version of this function (http://www.php.net/manual/en/function.msql-fetch-array.php) with the constants (MSQL_ASSOC, MSQL_NUM, and MSQL_BOTH) changing to MSSQL_.



Also note that if you don't specify this parameter you'll get both the numbers and column names, which can cause some frustration.

down

php at bricology dot com ¶

16 years ago


I just spent a few hours trying to get ntext data with this function, CASTing and CONVERTing every which way, and scouring the 'net. Nothing worked, I just got a NULL.

Then on a whim I tried it with mssql_fetch_row instead, and that DOES work.

down

chu61 dot tw at gmail dot com ¶

16 years ago


To write Unicode (nvarchar) to SQL2000/2005 use PHP

用PHP在SQL Server 存取Unicode資料

----------------------------------------------



Let's assume, we have following data table, that allows us to store unicode values (using UCS-2 encoding):



    create table mytable    (

        myfield nvarchar (100) null

    );



Below is the code to work with:



<?php

    $link = mssql_connect('dbhost', 'username', 'password');

    mssql_select_db('database', $link);



    // sending data to database

    $utf8 = 'some unicode UTF-8 data';  // some Greek text for example ;)

    $ucs2 = iconv('UTF-8', 'UCS-2LE', $utf8);



    // converting UCS-2 string into "binary" hexadecimal form

    $arr = unpack('H*hex', $ucs2);

    $hex = "0x{$arr['hex']}";



    // IMPORTANT!

    // please note that value must be passed without apostrophes

    // it should be "... values(0x0123456789ABCEF) ...", not "... values('0x0123456789ABCEF') ..."

    mssql_query("insert into mytable (myfield) values ({$hex})", $link);



    // retrieving data from database

    // IMPORTANT!

    // please note that "varbinary" expects number of bytes

    // in this example it must be 200 (bytes), while size of field is 100 (UCS-2 chars)



    $result = mssql_query("select convert(varbinary(200), myfield) from mytable", $link);



    while (($row = mssql_fetch_array($result, MSSQL_BOTH))) 

    {

        // we get data in UCS-2

        // I use UTF-8 in my project, so I encode it back

        echo(iconv('UCS-2LE', 'UTF-8', $row['myfield']));

    }



    mssql_free_result($result);

    mssql_close($link);

?>

down

gillis dot phpmanual at no-spam-for-megillis dot fi ¶

19 years ago


Allthough probably obvious to people who have used the functions available to other databases it during writing is not present in this entry that result type can be entered as MSSQL_ASSOC or MSSQL_NUM, and the default value when nothing entered being MSSQL_BOTH

//Gillis Danielsen

down

archwisp at gmail dot com ¶

20 years ago


In response to my last post:

After further testing, it appears as though the null column bug only affects windows installations. On my linux installation using freetds-0.61.2, the function behaves properly. It must exist either in the php_mssql.dll or the Microsoft connection libraries. And since I use this functionality through ASP as well (which uses the Microsoft connection libraries), it would lead me to believe that it's an issue within the php_mssql.dll.

down

ask at manniac dot de ¶

22 years ago


It seems that this function creates arrays wich keys can not be longer than 30 chars. So when you're having a DB-field like "this_is_a_very_long_db_field_name"
its array-key is cut off after 30 chars and you will have to access the value with
rs["this_is_a_very_long_db_field_n"]

down

-1

herriedm at yahoo dot com ¶

21 years ago


[Editor's Note: NULLs *are* distinguishable from 0.  See the manual section on comparison operators. ]



microsoft sql 2000 server

php running on windows 2000



Using the $row = mssql_fetch_array($result)



A null value will return 0, this is a problem if you are using 0 and some identifier for a value.  you should convert all nulls to something like -1 or "NO VALUE"

down

-1

Derek Ethier ¶

20 years ago


The array_walk function is also useful for stripping the whitespace returned in an mssql_query.

function modify_field(&$array) {
    $array = trim($array);
}

$query = "select * from dbo.table where value = '0'";
$result = mssql_query($query) or die;

while ($row = mssql_fetch_array($result)) {
    // This will call the above function.
    array_walk($row, 'modify_field'); 
    array_push($eventresults, $row);
}

An added benefit is that you can expand the modify_field function to handled unexpected returned column data.

add a note