関数・クラス解説

fbsql_query

version:PHP 4 >= 4.0.6, PHP 5 < 5.3.0 (公式)

FrontBase クエリを送信する

公式リファレンス

書式

fbsql_query ( string $query [, resource $link_identifier [, int $batch_size ]] ) : resource

説明

クエリ query を、 サーバー上の現在アクティブなデータベースに送信します。

クエリが成功したと仮定すると、 fbsql_num_rows() を使用して SELECT 文から 返された行数を取得したり fbsql_affected_rows() を使用して DELETE、INSERT、REPLACE あるいは UPDATE 文で変更された行数を 取得したりすることが可能です。

パラメータ

query
実行する SQL クエリ。
注意: クエリ文字列の最後はセミコロンで終わらなければなりません。
link_identifier
fbsql_connect() あるいはfbsql_pconnect() が返す FrontBase リンク ID。指定しなかった場合は、この関数は FrontBaseサーバーでオープンしているリンクを探します。見つからないときはfbsql_connect() に引数を指定せずにコールしたときと同様にして作成します。
batch_size

返値

fbsql_query() は、クエリが成功したかどうかを 示すために TRUE (非ゼロ) あるいは FALSE を返します。 返り値が TRUE の場合、クエリは正しい形式であってサーバーで実行された ことを示します。変更された行数や返された行数については何も示しません。 クエリが成功しても 1 行も変更しなかったり 1 行も返さなかったりすることは 十分にありえることです。 SELECT 文の場合は fbsql_query() は新しい結果 ID を返し、これを fbsql_result() に渡すことができます。 クエリが参照しているテーブルへのアクセス権がない場合にも fbsql_query() は失敗し、FALSE を返します。

サンプル

以下のクエリは文法的に間違っています。そのため fbsql_query() は失敗して FALSE を返します。

例1 fbsql_query() の例

$result = fbsql_query("SELECT * WHERE 1=1")     or die ("不正なクエリ");

テーブル my_tbl に my_col というカラムが存在しない場合、以下のクエリは意味的に間違ったものと なります。そのため fbsql_query() は失敗して FALSE を返します。

例2 fbsql_query() の例

$result = fbsql_query ("SELECT my_col FROM my_tbl;")     or die ("不正なクエリ");

参考

  • fbsql_affected_rows() - 直近の FrontBase 操作により変更されたレコードの数を得る
  • fbsql_db_query() - FrontBase クエリを送信する
  • fbsql_free_result() - 結果メモリを開放する
  • fbsql_result() - 結果データを得る
  • fbsql_select_db() - FrontBase データベースを選択する
  • fbsql_connect() - FrontBase サーバーへの接続をオープンする
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール