フィールド長を得る

# mssql_field_length

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

mssql_field_length — フィールド長を得る

警告

この関数は PHP 7.0.0 で 削除 されました。

この関数の代替として、これらが使えます。

- PDOStatement::getColumnMeta()
- sqlsrv_field_metadata()
- odbc_field_len()

### 説明

mssql_field_length ( resource `$result` [, int `$offset` = -1 ] ) : int

結果 `result` のフィールド番号 `offset` のフィールド長を返します。

### パラメータ

`result`

  処理対象となる結果リソース。これは mssql_query() のコールによって取得します。

`offset`

  フィールドオフセット。0 から始まります。 省略した場合は現在のフィールドを使用します。

### 返り値

成功した場合は指定したフィールドの長さ、 失敗した場合に `FALSE` を返します。

### 例

例1 mssql_field_length() の例

`<?php
// MSSQL に接続し、データベースを選択します
mssql_connect('MANGO\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php');
// select クエリを MSSQL に送信します
$query = mssql_query('SELECT [name], [age] FROM [php].[dbo].[persons]');
// フィールドの長さを表示します
echo 'The field \'age\' has a data length of ' . mssql_field_length($query, 1);
// 結果を開放します
mssql_free_result($query);
?>`

上の例の出力は、 たとえば以下のようになります。

    The field 'age' has a data length of 4

### 注意

> 注意: Windows ユーザーへの注意

> PHP が使用している API（MS DbLib C API）の制限により、 VARCHAR フィールドの長さは 255 までに限定されます。それ以上のデータを保存したい場合は、かわりに TEXT フィールドを使用します。

### 参考

- mssql_field_name() - フィールド名を得る
- mssql_field_type() - フィールド型を得る