powerscript® リファレンスボリューム 1 · powersoft portfolio ... replication server,...

PowerScript® リファレンスボリューム 1

PowerBuilder®

9

DOCUMENT ID: 37781-01-0900-01

LAST REVISED: March 2003

Copyright © 1989-2004 by Sybase, Inc. All rights reserved.

本書に記載されているソフトウェアは、Sybase ライセンス契約に基づいて Sybase, Inc. が提供し、かかる契約の条項に従う場合にのみ使用が許諾されます。

本書に記載されている内容は、 Sybase, Inc. およびその関連会社の書面による許可なく、いかなる形態、または手段、電子的、機械的、手作業、光学的およびその他にかかわらず、複製、転載および翻訳を禁じます。

Sybase, Sybase （ロゴ） , AccelaTrade, ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture,Adaptive Server, Adaptive Server Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive ServerEnterprise Replication, Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, Anywhere Studio, ApplicationManager, AppModeler, APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-FORMS, APT-Translator, APT-Library, BackupServer, BizTracker, ClearConnect, Client-Library, Client Services, Convoy/DM, Copernicus, Data Pipeline, Data Workbench,DataArchitect, Database Analyzer, DataExpress, DataServer, DataWindow, DB-Library, dbQueue, Developers Workbench, DirectConnect Anywhere, Distribution Director, e-ADK, E-Anywhere, e-Biz Integrator, E-Whatever, EC Gateway, ECMAP, ECRTP,eFulfillment Accelerator, Embedded SQL, EMS, Enterprise Application Studio, Enterprise Client/Server, Enterprise Connect, EnterpriseData Studio, Enterprise Manager, Enterprise SQL Server Manager, Enterprise Work Architecture, Enterprise Work Designer, EnterpriseWork Modeler, eProcurement Accelerator, EWA, Financial Fusion, Financial Fusion Server, Gateway Manager, GlobalFIX,ImpactNow, Industry Warehouse Studio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnect,InternetBuilder, iScript, Jaguar CTS, jConnect for JDBC, MainframeConnect, Maintenance Express, MDI Access Server, MDIDatabase Gateway, media.splash, MetaWorks, MySupport, Net-Gateway, Net-Library, New Era of Networks, ObjectConnect,ObjectCycle, OmniConnect, OmniSQL Access Module, OmniSQL Toolkit, Open Biz, Open Client, Open ClientConnect, Open Client/Server, Open Client/Server Interfaces, Open Gateway, Open Server, Open ServerConnect, Open Solutions, Optima++, PB-Gen, PC APTExecute, PC Net Library, Power++, power.stop, PowerAMC, PowerBuilder, PowerBuilder Foundation Class Library, PowerDesigner,PowerDimensions, PowerDynamo, PowerJ, PowerScript, PowerSite, PowerSocket, Powersoft, PowerStage, PowerStudio, PowerTips,Powersoft Portfolio, Powersoft Professional, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst, Rapport, Report Workbench,Report-Execute, Replication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, ResourceManager, RW-DisplayLib, S-Designor, SDF, Secure SQL Server, Secure SQL Toolset, Security Guardian, SKILS, smart.partners,smart.parts, smart.script, SQL Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL Debug, SQL Edit, SQLEdit/TPU, SQL Everywhere, SQL Modeler, SQL Remote, SQL Server, SQL Server Manager, SQL SMART, SQL Toolset, SQL Server/CFT, SQL Server/DBM, SQL Server SNMP SubAgent, SQL Station, SQLJ, STEP, SupportNow, S.W.I.F.T. Message Format Libraries,Sybase Central, Sybase Client/Server Interfaces, Sybase Financial Server, Sybase Gateways, Sybase MPP, Sybase SQL Desktop, SybaseSQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench, SybaseWare, Syber Financial, SyberAssist, SyBooks, System 10,System 11, System XI ( ロゴ ), SystemTools, Tabular Data Stream, TradeForce, Transact-SQL, UltraLite.NET, UNIBOM, Unilib,Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Viewer, Visual Components, VisualSpeller, VisualWriter, VQL,WarehouseArchitect, Warehouse Control Center, Warehouse Studio, Warehouse WORKS, Watcom, Watcom SQL, Watcom SQLServer, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup SQL Server, XA-Library, XA-Server およびXP Server は Sybase, Inc. の登録商標です。

Unicode および Unicode のロゴは Unicode, Inc. の登録商標です。

本書で使用される会社名および製品名はそれぞれの会社の商標および登録商標です。

本書に記載されている内容は、将来予告なしに変更することがあります。また、本ソフトウェアおよび説明書を使用したことによる損害、または第三者からのいかなる請求についても、サイベース株式会社、その親会社である米国法人 Sybase,Inc. またはその関連会社は、一切の責任を負わないものとします。

目次

本書について .................................................................................................................................. ix

第 1 部 POWERSCRIPT についてのトピック

第 1 章 PowerScript の基礎.................................................................................................... 3コメント ........................................................................................... 3識別子の命名.................................................................................... 5ラベル .............................................................................................. 7特殊な ASCII 文字 ............................................................................ 7NULL 値 ........................................................................................... 9予約語 ............................................................................................ 10代名詞 ............................................................................................ 11

Parent 代名詞 .......................................................................... 12This 代名詞 .............................................................................. 14Super 代名詞 ........................................................................... 15

継続行文字 ..................................................................................... 16ステートメントの区切り子 ............................................................ 17空白文字 ......................................................................................... 18

第 2 章データ型 ........................................................................................................................... 19標準データ型.................................................................................. 19Any データ型.................................................................................. 24システムオブジェクトデータ型 ................................................... 27カタログデータ型 ......................................................................... 29EAServer での PowerBuilder データ型 .......................................... 29

第 3 章宣言 ..................................................................................................................................... 31変数の宣言 ..................................................................................... 31

変数の宣言場所 ....................................................................... 31変数の使い方 ........................................................................... 33変数宣言のための構文 ............................................................ 36

定数の宣言 ..................................................................................... 47

PowerScript リファレンスボリューム 1 iii

目次

配列の宣言 ..................................................................................... 48配列要素の値 ........................................................................... 52可変長配列のサイズ ................................................................ 53配列についての詳細 ................................................................ 54

外部関数の宣言 .............................................................................. 58外部関数の引数のデータ型 ..................................................... 63外部関数の呼び出し ................................................................ 65外部変数の定義 ....................................................................... 65

リモートプロシージャコールとしての DBMS ストアドプロシージャの宣言 .............................. 66

第 4 章演算子と式....................................................................................................................... 69演算子 ............................................................................................ 69

算術演算子 .............................................................................. 69関係演算子 .............................................................................. 72連結演算子 .............................................................................. 73

演算子の優先順位 .......................................................................... 74PowerBuilder 式のデータ型 ........................................................... 75

数値データ型 ........................................................................... 75String 型と Char 型の間の変換 ............................................... 77

第 5 章構造体とオブジェクト .............................................................................................. 79構造体について .............................................................................. 79オブジェクトについて ................................................................... 80

ユーザオブジェクトについて ................................................. 82オブジェクトのインスタンス作成 .......................................... 83先祖と子孫の使い方 ................................................................ 84ガベージコレクション ........................................................... 85構造体としてのユーザオブジェクト ...................................... 86

オブジェクトと構造体の代入 ........................................................ 87構造体の代入 ........................................................................... 87オブジェクトの代入 ................................................................ 88自動生成するユーザオブジェクトの代入............................... 89

第 6 章関数とイベントの呼び出し .................................................................................... 91関数とイベントについて ................................................................ 91関数とイベントの検索と実行方法 ................................................. 94

関数の検索 .............................................................................. 94イベントの検索 ....................................................................... 95

関数とイベントのトリガまたはポスト .......................................... 96静的呼び出しと動的呼び出し ........................................................ 98

静的呼び出し ........................................................................... 98

iv PowerBuilder

目次

動的呼び出し ........................................................................... 99関数とイベントの多重定義、上書き、拡張 ................................. 105

関数の多重定義と上書き ....................................................... 105イベントの拡張と上書き ....................................................... 107

関数とイベントへの引数の渡し方 ............................................... 107オブジェクトの渡し方 .......................................................... 108構造体の渡し方 ..................................................................... 109配列の渡し方 ......................................................................... 109

戻り値の使い方 ............................................................................ 110関数 ....................................................................................... 110イベント ................................................................................ 111カスケード呼び出しと戻り値の使い方 ................................. 112

PowerBuilder の関数とイベントの呼び出し構文 ......................... 113先祖オブジェクトの関数とイベントの呼び出し .......................... 117

第 2 部ステートメント、イベント、および関数

第 7 章 PowerScript のステートメント ...................................................................... 123値の代入文 ................................................................................... 124CALL ............................................................................................ 127CHOOSE CASE........................................................................... 129CONTINUE .................................................................................. 131CREATE....................................................................................... 132DESTROY.................................................................................... 136DO...LOOP................................................................................... 137EXIT ............................................................................................. 139FOR...NEXT ................................................................................. 140GOTO........................................................................................... 142HALT ............................................................................................ 143IF...THEN ..................................................................................... 144RETURN ...................................................................................... 146THROW........................................................................................ 147THROWS ..................................................................................... 148TRY...CATCH...FINALLY...END TRY .......................................... 149

第 8 章 SQL 文........................................................................................................................... 151スクリプトにおける SQL 文の使い方.......................................... 152

CLOSE Cursor ..................................................................... 155CLOSE Procedure................................................................ 156COMMIT............................................................................... 157CONNECT............................................................................ 158DECLARE Cursor................................................................. 159

PowerScript リファレンスボリューム 1 v

目次

DECLARE Procedure........................................................... 160DELETE ............................................................................... 162DELETE Where Current of Cursor ....................................... 163DISCONNECT...................................................................... 164EXECUTE ............................................................................ 165FETCH ................................................................................. 166INSERT ................................................................................ 167OPEN Cursor ....................................................................... 168ROLLBACK .......................................................................... 169SELECT ............................................................................... 170SELECTBLOB...................................................................... 172UPDATE............................................................................... 174UPDATEBLOB ..................................................................... 175UPDATE Where Current of Cursor ...................................... 177

動的 SQL の使い方 ...................................................................... 177動的 SQL 書式 1................................................................... 182動的 SQL 書式 2................................................................... 183動的 SQL 書式 3................................................................... 184動的 SQL 書式 4................................................................... 187

第 9 章 PowerScript のイベント ...................................................................................... 193イベントについて ........................................................................ 193Activate ........................................................................................ 197BeginDrag .................................................................................... 198BeginLabelEdit ............................................................................. 202BeginRightDrag............................................................................ 204Clicked ......................................................................................... 207Close ............................................................................................ 213CloseQuery .................................................................................. 215ColumnClick ................................................................................. 217Constructor................................................................................... 219DataChange ................................................................................. 221Deactivate .................................................................................... 222DeleteAllItems .............................................................................. 223DeleteItem.................................................................................... 224Destructor..................................................................................... 226DoubleClicked .............................................................................. 227DragDrop...................................................................................... 232DragEnter..................................................................................... 237DragLeave.................................................................................... 239DragWithin ................................................................................... 241EndLabelEdit................................................................................ 244Error ............................................................................................. 246ExternalException ........................................................................ 250

vi PowerBuilder

目次

FileExists ...................................................................................... 253GetFocus...................................................................................... 254Help.............................................................................................. 256Hide.............................................................................................. 257HotLinkAlarm................................................................................ 258Idle ............................................................................................... 259InputFieldSelected ....................................................................... 260InsertItem ..................................................................................... 261ItemActivate ................................................................................. 262ItemChanged................................................................................ 264ItemChanging............................................................................... 265ItemCollapsed .............................................................................. 266ItemCollapsing ............................................................................. 267ItemExpanded .............................................................................. 268ItemExpanding ............................................................................. 269ItemPopulate ................................................................................ 270Key ............................................................................................... 271LineDown ..................................................................................... 273LineLeft ........................................................................................ 274LineRight ...................................................................................... 275LineUp.......................................................................................... 276LoseFocus.................................................................................... 277Modified........................................................................................ 279MouseDown ................................................................................. 281MouseMove.................................................................................. 284MouseUp...................................................................................... 288Moved .......................................................................................... 291Open ............................................................................................ 292Other ............................................................................................ 296PageDown.................................................................................... 297PageLeft ....................................................................................... 299PageRight .................................................................................... 300PageUp ........................................................................................ 301PictureSelected ............................................................................ 303PipeEnd........................................................................................ 304PipeMeter..................................................................................... 305PipeStart ...................................................................................... 306PrintFooter ................................................................................... 307PrintHeader .................................................................................. 309PropertyChanged ......................................................................... 311PropertyRequestEdit .................................................................... 312RButtonDown ............................................................................... 313RButtonUp.................................................................................... 316RemoteExec................................................................................. 317

PowerScript リファレンスボリューム 1 vii

目次

RemoteHotLinkStart..................................................................... 318RemoteHotLinkStop ..................................................................... 319RemoteRequest ........................................................................... 320RemoteSend ................................................................................ 321Rename........................................................................................ 322Resize .......................................................................................... 323RightClicked ................................................................................. 324RightDoubleClicked...................................................................... 327Save ............................................................................................. 329SaveObject................................................................................... 330Selected ....................................................................................... 331SelectionChanged........................................................................ 332SelectionChanging ....................................................................... 336Show ............................................................................................ 339Sort............................................................................................... 340SystemError ................................................................................. 343SystemKey ................................................................................... 344Timer ............................................................................................ 345ToolbarMoved .............................................................................. 347ViewChange................................................................................. 348

viii PowerBuilder

本書について

対象とする読者このマニュアルは、 PowerBuilder® を使ってクライアントサーバアプリケーションまたは Web アプリケーションの開発に携わっているプログラマを対象にしています。

目的このマニュアルは、 PowerScript® 言語の変数、式、ステートメント、イベント、および関数など、その構文と使い方について解説しています。

2 つのボリュームこのマニュアルは、次の 2 つのボリュームに分かれています。

関連マニュアル PowerBuilder のすべてのマニュアルの一覧については、『PowerBuilder入門』マニュアルを参照してください。

そのほかの参照情報製品に関するそのほかの詳細情報については、 Sybase のテクニカルライブラリ CD やテクニカルライブラリ製品マニュアル Webサイト（英語）を参照してください。

• ソフトウェア付属のテクニカルライブラリ CD には、製品マニュアルが収められています。製品マニュアルは、 PDF 形式にて提供しています。

テクニカルライブラリ CD の使い方については、テクニカルライブラリ CD 内の Readme.txt ファイルを参照してください。

• テクニカルライブラリ製品マニュアルの Web サイト（英語）には、 Product Manuals http://www.sybase.com/support/manuals/ からアクセスできます。

表記規則このマニュアルは、以下の表記規則を使用します。

ボリューム内容

ボリューム 1 第 1 章～第 9 章ボリューム 2 第 10 章（PowerScript の関数）

PowerScript リファレンスボリューム 1 ix

サポートについて製品に同梱している「サポートハンドブック」を参照してください。

表記例意味

Retrieve と Update 説明文で使用されている場合、左記のフォントは次のいずれかを表します。

• コマンド名、関数名、メソッド名

• TRUE、 FALSE、 NULL などのキーワード

• Integer 型、 Char 型などのデータ型

• emp_id、 f_name などのデータベースカラム名

• dw_emp、 w_main などのユーザ定義オブジェクト

変数（variable）またはファイル名（file name）

説明文と構文の説明で使用された場合、斜体は次のいずれかを表します。

• myCounter などの変数名

• 入力テキストで pblname.pbd など入力が必要な部分

• ファイルとパス名

［ファイル｜上書き保存］

メニュー名やメニュー項目は、単純なテキストで記述されています。縦棒（｜）は、メニューの選択順序を示します。たとえば、［ファイル｜上書き保存］は、「［ファイル］メニューから［上書き保存］を選択する」ことを示します。

dw_1.Update() このフォントは、以下のいずれかを表します。

• ダイアログボックスやコマンドラインに入力する情報

• サンプルスクリプトの一部

• サンプル出力の一部

x PowerBuilder

第 1 部 PowerScript についてのトピック

第 1 章 PowerScript の基礎

この章についてこの章では、 PowerScript でプログラミングを行う上での規則や手法について解説します。

内容

コメント機能コメントは、スクリプトに注釈を加えたり、スクリプト内のステー

トメントが実行されないようにするためのものです。コメントを作成するには、 2 つの方法があります。

構文 2 つのスラッシュを用いる方法

Code // Comment

スラッシュとアスタリスクを用いる方法

/* Comment */

解説次の表に、各メソッドの使い方を示します。

項目ページ

コメント 3

識別子の命名 5

ラベル 7

特殊な ASCII 文字 7

NULL 値 9

予約語 10

代名詞 11

継続行文字 16

ステートメントの区切り子 17

空白文字 18

PowerScript リファレンスボリューム 1 3

コメント

表 1-1: スクリプトにコメント追加するためのメソッド

コメント記号の追加スクリプトビューおよび関数ペインタでは、ペインタバーの［コメント行］ボタンをクリックするかメニューバーの［編集｜選択した行をコメントにする］を選択して、カーソルがある行または選択した複数の行をコメントにすることができます。

オブジェクトやライブラリエントリにコメントを記述する方法については、『PowerBuilder ユーザーズガイド』マニュアルを参照してください。

例 2 つのスラッシュを用いる方法

// この行はコメントです。// この行もコメントです。amt = qty * cost // ここから行末まではコメントです。

// 次の行はコメント行のため// 実行されません。// SetNull(amt)

スラッシュとアスタリスクを用いる方法

/* 1 行のコメント文です。 */

/* コメント文は、この行から始まりこの行に続き、この行で終わります。 */

A = B + C /* ここからコメント文が始まります。 /* ここから入れ子のコメント文が始まります。

入れ子のコメント文はここで終わります。 */ 最初のコメント文はここで終わります。 */ + D + E + F

方法記号用途注意

2 つのスラッシュ

// この記号よりも右側にある部分をすべてコメントとする

複数行にまたがることはできない

スラッシュとアスタリスク

/*...*/ これらの記号ではさまれた部分をコメントとする

入れ子状のコメント

• 複数行にまたがることができる（継続行文字は不要）

• 入れ子状にできる

4 PowerBuilder


識別子の命名機能変数、ラベル、関数、ウィンドウ、コントロール、メニューおよびス

クリプト内で参照するほかのすべてのものに名前をつけるときには、識別子を使用します。

構文識別子には、以下の命名規約があります。

• 先頭は必ず文字または _ （アンダースコア）にします。

• 予約語は使用できません（10 ページの「予約語」を参照してください）。

• 最大で 40 バイトまで、スペースは使用できません。

• 英文の大文字と小文字を区別しません（PART、 Part、 part はすべて同じです）。

• 英文字、数字、および以下の特殊文字を任意に組み合わせることができます。

- ハイフン _ アンダースコア$ ドル記号# シャープ記号% パーセント記号

PowerBuilder 9.0 における日本語名のサポートについては、以下のとおりです。

日本語名をサポートしているもの

• ライブラリエントリとなるオブジェクトに埋め込まれるオブジェクト名（データウィンドウカラムのオブジェクト名、メニュー項目名、コントロール名など）

日本語名をサポートしていないもの

• ライブラリエントリとなるオブジェクト名（ウィンドウ名、メニュー名、データウィンドウ名、アプリケーション名、関数名、構造体名、ユーザオブジェクト名など）

• オブジェクト関数名

• 関数の引数名

• 変数名


識別子の命名

日本語のコントロール名について日本語版 PowerBuilder 9.0 では、コントロール名に日本語の接尾語を用いることができます。しかし、開発するアプリケーションを他国語に移植し日本語版以外の PowerBuilder 実行環境で動作させる計画がある場合や、将来、 UNIX ワークステーションなどほかのプラットフォームへアプリケーションを移植する可能性がある場合は、日本語を含んだコントロール名が移植に支障を来すことが考えられます。日本語版PowerBuilder 9.0 は、現在のところ Windows プラットフォームだけをサポートしますが、他国語やほかのプラットフォームへの移植の可能性がある場合は、コントロール名に日本語文字列を用いるべきではありません。

解説初期設定では、スクリプト内の変数名を含むすべての識別子にハイフン（-）を使用できます。ただし、スクリプト内で - （減算）演算子または -- 演算子を使用するときには、 PowerBuilder に識別子ではなく式であることを認識させるために、演算子の前後にスペースを入れる必要があります。

スクリプト内で変数名にハイフンを使用できないようにするには、スクリプトエディタのプロパティシートで［識別子にハイフンを使用］チェックボックスをオフにします。こうすれば、 - 演算子や -- 演算子の前後にスペースを入れる必要はありません。

注意変数名にハイフンを使用していて［識別子にハイフンを使用］チェックボックスをオフに変更した場合、次にコンパイルするとエラーとなりますので注意してください。

例有効な識別子

ABC_CodeChild-IdFirstButtonresponse35pay-before%deductions$ORDER_DATEActual-$-amountPart#

無効な識別子

2nd-quantity // 先頭が数字になっています。ABC Code // スペースを含んでいます。Child'sId // 無効な文字を含んでいます。

6 PowerBuilder


ラベル機能 GOTO 文で使用するためのラベルをスクリプト内で用いることができ

ます。

構文 identifier

解説ラベルには、任意の有効な識別子を使用できます。ステートメントより前に単独行として使用するか、ステートメントと同じ行の先頭で使用します。

GOTO 文の詳細については、 142 ページの「 GOTO」を参照してください。また有効な識別子については、 5 ページの「識別子の命名」を参照してください。

例ステートメントの前の単独行で使用する場合

FindCity:IF city=cityname[1] THEN ...

ステートメントと同じ行の先頭で使用する場合

FindCity: IF city=cityname[1] THEN ...

特殊な ASCII 文字機能文字列の中に特殊な ASCII 文字を用いることができます。たとえば、

タブを入れてスペースを確保したり、中黒を入れてリスト項目を示すことができます。特殊文字の前にはティルダ（~）を付けます。タブは、ティルダの後に 1 回のキーストロークで入力できる一般的な ASCII 文字の 1 つです。中黒は、ティルダと、その後の、その値を表す 10 進、16 進、または 8 進の ASCII 値を使って入力することが必要です。

構文次の表のガイドラインに従ってください。


特殊な ASCII 文字

表 1-2: 文字列での特殊 ASCII 文字の使い方

例 ASCII 文字の入力以下に、文字列中における特殊文字の使い方を示します。

10 進値、 16 進値、 8 進値の使い方以下に、 10 進、 16 進、および 8 進のASCII コード値を使用して、文字列中に中黒（・）を指定する方法を示します。

種類用途入力摘要

一般的なASCII 文字

改行 ~n

タブ ~t

垂直タブ ~v

復帰 ~r

用紙送り ~f

後退 ~b

二重引用符 ~"

単一引用符 ~'

ティルダ ~~

すべてのASCII 文字

10 進数 ~### ### = 000 ～ 255 までの 3 桁の 10 進数

16 進値 ~h## ## = 01 ～ FF までの 2 桁の 16 進数

8 進値 ~o### ### = 000 ～ 377 までの 3 桁の 10 進数

文字列説明

"dog~n" dog という語の後に改行文字が続く文字列。

"dog~tcat~ttiger" dog という語、タブ、 cat という語、タブ、さらに tigerという語が続く文字列。

値説明

"~249" 10 進数の値が 249 の ASCII 文字。

"~hF9" 16 進数の値が F9 の ASCII 文字。

"~o371" 8 進数の値が 371 の ASCII 文字。

8 PowerBuilder


NULL 値機能 NULL は未定義を意味し、空文字列、 0、あるいは 0000-00-00 の日付の

いずれとも異なります。 NULL は、 0 でも 0 以外の値でもない未知あるいは未定義の値です。

一般に、 NULL 値はデータベースの値に関してだけ使用します。

解説変数の初期値 PowerBuilder は、すべての変数のデータ型に対して NULL値をサポートしていますが、変数の初期値に NULL 値を設定することはありません。変数の宣言時に値が設定されていない場合には、変数のデータ型のデフォルトの初期値が設定されます。たとえば、数値型の場合には 0、 Boolean 型の場合には FALSE、 String 型の場合には空文字列（""）を設定します。

NULL 値を持つ変数変数が NULL 値を保持できるのは、以下の場合に限られます。

• データベースから変数に NULL 値が代入される場合。データベースが NULL 値をサポートしている場合、 SQL の INSERT 文や UPDATE文によってデータベースに NULL 値が送られると、データベースにNULL が書き込まれます。また、 SELECT 文や FETCH 文によって、データベースから検索された NULL 値を変数に代入できます。

変数の NULL変数に NULL 値が代入されると、その変数はスクリプト内で変更されるまで NULL 値のままです。

• SetNull 関数を使用して変数に明示的に NULL 値を設定する場合。次に例を示します。

string city // city は空の文字列です。SetNull(city) // city に NULL 値が設定されます。

関数および式における NULL 引数のいずれかが NULL 値の関数は、ほとんどが NULL を返します。また、NULL 値を保持する変数を用いた式は、NULL と評価されます。

NULL 値のブール式は未定義であり、 FALSE とみなされます。

NULL の確認変数や式が NULL かどうかを確認するときには、 IsNull 関数を使用します。 NULL の確認には等号（=）は使用できません。

有効次のステートメントは、 NULL を確認する正しい方法です。

IF IsNull(a) THEN ...

無効以下のステートメントは、 NULL を確認する間違った方法です。

IF a = NULL THEN ...


予約語

例例 1 以下のどのステートメントを実行しても、コンピュータはビープ音を鳴らしません（変数 Nbr には NULL 値が設定されているので、ステートメントの各条件節は FALSE と評価されます）。

int Nbr

// Nbrは NULLに設定されますSetNull(Nbr)IF Nbr = 1 THEN Beep(1)IF Nbr <> 1 THEN Beep(1)IF NOT (Nbr = 1) THEN Beep(1)

例 2 以下の IF...THEN 文では、ブール式は FALSE と評価されるので、ELSE 節が実行されます。

int aSetNull(a)IF a = 1 THEN

MessageBox("値 ", "a = 1")ELSE

MessageBox("値 ", "a = NULL")END IF

例 3 これは、例 2 よりさらに便利な NULL ブール式の応用です。次の式は、どのコントロールにもフォーカスが設定されていない場合、メッセージを表示します。コントロールにフォーカスが設定されていなければ GetFocus 関数が NULL オブジェクトの参照を返し、ブール式がそれを FALSE と評価し、したがって ELSE 節が実行されます。

IF GetFocus( ) THEN

. . . // 何らかの処理ELSE

MessageBox("重要 ", " オプションを指定してください。 ")END IF

予約語PowerScript が内部的に使用する語を予約語と呼び、これらは、識別子としては使用できません。予約語を識別子として使用すると、コンパイラから警告が発せられます。アスタリスク（*）の付いた予約語は関数名として使用できます。

10 PowerBuilder


表 1-3: PowerScript の予約語

また、 PowerBuilder のシステムクラスには、識別子として使用できないプライベート変数があります。このプライベート変数を識別子として使用した場合、情報メッセージが表示されて、識別子の名前を変更しなければなりません。

代名詞機能 PowerScript では、オブジェクトやコントロールの一般的な参照をする

ときに、代名詞を使用できます。代名詞を使用すると、オブジェクトやコントロールの名前が変更されてでも、そのまま参照されます。

解説オブジェクト名を使用する関数やイベントのスクリプトで、代名詞を使用することができます。たとえば、代名詞を使用して以下のことが行えます。

aliasand*autoinstantiatecallcasecatchchooseclose*commitconnectconstantcontinuecreate*cursordeclaredeletedescribe*descriptordestroydisconnectdodynamicelseelseifendenumerated

eventexecuteexitexternalfalsefetchfinallyfirstforforwardfromfunctionglobalgotohaltifimmediateindirectinsertintointrinsicislastlibraryloopnext

notofonopen*orparentpost*preparepriorprivateprivatereadprivatewriteprocedureprotectedprotectedreadprotectedwriteprototypespublicreadonlyrefreturnrollbackrpcfuncselectselectblobshared

staticstepsubroutinesupersystemsystemreadsystemwritethenthisthrowthrowstotriggertruetrytypeuntilupdate*updateblobusingvariableswhilewithwithin_debug


代名詞

• オブジェクトやコントロールのイベントを起動させる

• オブジェクトやコントロールを操作、変更する

• オブジェクトやコントロールのプロパティ値を取得、変更する

次の表に、 PowerScript の代名詞とその簡単な使い方を示します。

表 1-4: PowerScript の代名詞

ParentWindow プロパティメニューオブジェクトの ParentWindow プロパティを、メニュースクリプトの代名詞と同じように使用できます。このプロパティは、実行時にそのメニュー項目と関連付けられているウィンドウを識別します。詳細については、『PowerBuilder ユーザーズガイド』マニュアルを参照してください。

次に、それぞれの代名詞について解説します。

Parent 代名詞機能 PowerBuilder スクリプトでの代名詞 Parent は、現行オブジェクトを所

有しているオブジェクトを参照します。

解説代名詞 Parent は、以下のスクリプト内で使用できます。

代名詞対象スクリプト参照先

This ウィンドウ、カスタムユーザオブジェクト、メニュー項目、アプリケーションオブジェクト、コントロール

オブジェクトまたはコントロール自体

Parent ウィンドウ内のコントロール

対象のコントロールが配置されているウィンドウ

カスタムユーザオブジェクト内のコントロール

対象のコントロールが配置されているカスタムユーザオブジェクト

メニュー項目対象のメニュー項目の上位のメニュー項目

Super 子孫オブジェクトまたは子孫コントロール

Parent

子孫ウィンドウまたは子孫ユーザオブジェクト

対象のウィンドウまたはユーザオブジェクトの直接の先祖

子孫ウィンドウまたは子孫ユーザオブジェクト内のコントロール

対象のコントロールの親ウィンドウまたは親ユーザオブジェクトの直接の先祖

12 PowerBuilder


• ウィンドウ内のコントロール

• カスタムユーザオブジェクト

• メニュー項目

Parent をどのスクリプトで使用するかによって、参照先が決まります。

ウィンドウのコントロールコマンドボタンなどのコントロールのスクリプト内で Parent を使用した場合、 Parent は、そのコントロールが配置されているウィンドウを参照します。

ユーザオブジェクトのコントロールカスタムユーザオブジェクト内のコントロールのスクリプトで Parent を使用した場合、 Parent は、そのユーザオブジェクトを参照します。

メニュー項目メニュー項目に対するスクリプトで Parent を使用した場合、 Parent は、そのスクリプトが対象とするメニュー項目の上位のメニュー項目を参照します。

例ウィンドウのコントロールウィンドウ内のコマンドボタンの Clickedイベントに対するスクリプトに、次のステートメントを記述した場合、このコマンドボタンをクリックすると、コマンドボタンが配置されているウィンドウが閉じます。

Close(Parent)

また、次のステートメントを記述した場合、このコマンドボタンをクリックすると、ウィンドウ内に水平スクロールバーが表示されます（ウィンドウの HScrollBar プロパティに TRUE が設定されます）。

Parent.HScrollBar = TRUE

ユーザオブジェクトのコントロールユーザオブジェクト内のチェックボックスの Clicked イベントに対するスクリプトに、次のステートメントを記述した場合、このチェックボックスをクリックすると、ユーザオブジェクトが非表示になります。

Parent.Hide( )

また、次のステートメントを記述した場合、このチェックボックスをクリックすると、ユーザオブジェクトが使用できなくなります（ユーザオブジェクトの Enabled プロパティに FALSE が設定されます）。

Parent.Enabled = FALSE

メニュー項目メニュー項目［選択］の下位の［すべて選択］の Clickedイベントに対するスクリプトに、次のステートメントを記述した場合、［すべて選択］をクリックすると［選択］が使用できなくなります。

Parent.Disable( )


代名詞

また、［すべて選択］の Clicked イベントに対するスクリプトに、次のステートメントを記述した場合、［すべて選択］をクリックすると［選択］にチェックマークが付きます。

Parent.Checked = TRUE

This 代名詞機能 PowerBuilder スクリプトでの代名詞 This は、ウィンドウ、ユーザオブ

ジェクト、メニュー項目、アプリケーションオブジェクト、または現行スクリプトを所有するコントロールを参照します。

解説 This を用いる理由代名詞 This を使って、所有権を明示できます。次のステートメントは、現行オブジェクトの X プロパティを参照します。

This.X = This.X + 50

使った方がわかりやすい場合オブジェクトまたはコントロールのスクリプトで This を使用しなくても、オブジェクトやコントロールのプロパティを参照できますが、使用すれば、明確でわかりやすいスクリプトを記述できます。

必要な場合どうしても This を使わなければならない状況もあります。グローバル変数またはローカル変数とインスタンス変数の名前が同じ場合、まずグローバル変数またはローカル変数が参照されます。このとき、 This を使用すれば、インスタンス変数が先に参照されます。

EAServer の制限EAServer コンポーネントで引数を渡す際には This は使用できません。

例例 1 メニュー項目に対するスクリプトに、次のステートメントを記述した場合、そのメニュー項目にチェックマークが付きます。

This.Check( )

例 2 関数呼び出しで This を使用して、そのスクリプトを所有するオブジェクトへの参照を渡すことができます。

ReCalc(This)

例 3 This を省略した場合、次のステートメントの x は、ローカル変数x が定義されていればそのローカル変数を参照し（スクリプトはコントロールの X プロパティではなく変数 x に 50 を加えます）、ローカル変数がない場合は、オブジェクトの X プロパティを参照します。

x = x + 50

14 PowerBuilder


例 4 This を使って、プロパティを確実に参照するようにします。たとえば、コマンドボタンの Clicked イベントに対するスクリプトに、次のステートメントを記述した場合、そのコマンドボタンをクリックすると、コマンドボタンの水平位置が変わります（つまり、コマンドボタンの X プロパティが変わります）。

This.x = This.x + 50

Super 代名詞機能子孫オブジェクトや子孫コントロールの PowerBuilder スクリプトを記

述するときには、先祖に記述されている任意のスクリプトを呼び出すことができます。呼び出す際に直接先祖を指定するか、または予約語Super を使用して、直接の継承元を参照できます。

解説 Super の使用条件先祖関数を呼び出す際に Super を使用する必要があるのは、子孫が先祖関数と同じ名前で、同じデータ型の引数を取る関数を持っている場合だけです。それ以外の場合は、修飾子なしで関数を呼び出すことができます。

Super の制約 Super を使って、先祖ウィンドウ内のコントロールに関連付けられているスクリプトを呼び出すことはできません。 Super が使用できるのは、呼び出す関数を所有する先祖の直接の子孫のイベントと関数だけです。それ以外のところで使用すると、コンパイル時に構文エラーが返されます。

コントロールに関連付けられているスクリプトを呼び出すには、 CALL文を使用します。

127 ページの「 CALL」の説明を参照してください。

例例 1 次のステートメントは、先祖関数 wf_myfunc を呼び出します（この場合、子孫にも wf_myfunc という関数があると考えられます）。

Super::wf_myfunc(myarg1, myarg2)

上記のステートメントは、子孫ウィンドウのスクリプトまたは関数の一部であり、子孫ウィンドウ内のコントロールのものではありません。たとえば、このステートメントを子孫ウィンドウ内のコマンドボタンの Clicked イベントに対するスクリプトで使用すると、コンパイル時に構文エラーが返されます。

引数を与えるには先祖関数の引数の数を間違えないように注意してください。


継続行文字

例 2 コマンドボタンのスクリプトに次のステートメントを記述した場合、直接の先祖ウィンドウまたはユーザオブジェクトのコマンドボタンに対する Clicked スクリプトを呼び出します。

Super::EVENT Clicked()

継続行文字機能通常は、 1 行に 1 つのステートメントを記述しますが、ときには、複

数行にまたがって記述することが必要な場合があります。ステートメントの継続行文字はアンパサンド記号（&）です。アクセラレータキーでアンパサンド文字を使用する方法については、『PowerBuilder ユーザーズガイド』を参照してください。

構文 Start of statement & more statement & end of statement

アンパサンド記号は、必ず行の終わりに記述します（行の途中にある場合、コンパイラはステートメントの一部とみなします）。

空白文字の詳細については、 18 ページの「空白文字」を参照してください。

解説以下の場合、継続行文字は使用できません。

• コメントの継続コメントを次の行に続ける場合、継続行文字は使用できません。継続行文字もコメントの一部とみなされ、コンパイル時には無視されます。

• SQL 文の継続 SQL 文を次の行に続ける場合、継続行文字を使用する必要はありません。 PowerBuilder では、 SQL 文の終わりには必ずセミコロン（;）を付けます。コンパイル時には、 SQL 文の先頭からセミコロンまでが SQL 文とみなされます。このため、 SQL 文中の継続行文字はステートメントの一部とみなされ、エラーとなります。

例引用符付き文字列の継続

通常の方法文字列の間に継続行文字（&）を入れて、引用符付き文字列を次の行に続けます。

IF Employee_District = "Eastern United States and&Eastern Canada" THEN ...

16 PowerBuilder


引用符内の継続行文字の前および継続行の先頭にあるタブやスペースなどの空白文字は、文字列の一部になります。

問題点次のステートメントでは、継続行文字だけを使用してIF...THEN 文の中の引用符付き文字列を次の行に続けています。継続行の先頭にタブを入れて、スクリプトを読みやすくしています。この場合、タブも文字列に含まれてしまい、コンパイル時にエラーとなることがあります。

IF Employee_District = "Eastern United States and& Eastern Canada" THEN ...

よりよい方法引用符付き文字列を継続するには、最初の行の終わりにくる継続行文字の前に引用符を記述し（その文字列を区切っているのが単一引用符の場合には '& で、二重引用符の場合には "&）、次の行の先頭にプラス符号と引用符（+' または +"）を記述します。この方法を用いると、文字列リテラルにタブやスペースなどの不要な空白文字が入るのを避けることができます。

IF Employee_District = "Eastern United States and "& +" Eastern Canada" THEN ...

（PowerBuilder のマニュアルでは、この方法で引用符付き文字列の継続行を表記しています。）

変数名の継続ステートメントを次の行に続けるときは、変数名の間に継続行文字を入れることはできません。次のステートメントは、継続行文字によって変数名 "Quantity" を分割しているため、エラーとなります。

Total-Cost = Price * Quan& tity + (Tax + Shipping)

ステートメントの区切り子機能通常は 1 つのステートメントを 1 行に記述しますが、場合によっては、

複数のステートメントを 1 行に記述したいこともあります。ステートメントの区切り子にはセミコロン（;）を使用します。

構文 Statement1; statement2

例次の行は、 3 つの短いステートメントから構成されています。 A = B + C; D = E + F; Count = Count + 1


空白文字

空白文字機能スペース、タブ、用紙送りおよびコメントは、空白文字として扱われ

ます。コンパイル時には、これらの文字は個数に関係なく区切り子として扱われます。

解説文字列リテラルの空白文字文字列リテラル（単一引用符または二重引用符で囲まれている）に空白文字がある場合は、コンパイル時に無視されません。

識別子のハイフン識別子にハイフン（-）が使用できる場合、 - 演算子の前後をスペースで囲む必要があります（5 ページの「識別子の命名」を参照してください）。それ以外の場合は、 PowerBuilder は - 演算子を変数名の一部とみなします。

Order - Balance // Order から Balance を減算します。Order-Balance // Order-Balance という変数名

例例 1 次の式の中のスペースとコメントは空白文字として扱われ、コンパイル時に無視されます。

A + B /*Adjustment factor */+C

例 2 ただし、次の文字列リテラルの中のスペースは、無視されません。

"The value of A + B is:"

18 PowerBuilder

第 2 章データ型

この章についてこの章では、 PowerScript が提供する 4 種類のデータ型について解説します。

内容

標準データ型データ型 PowerBuilder の標準データ型は、多くのプログラム言語で用いら

れている一般的なデータ型で、Char、Integer、Decimal、Long、Stringなどがこれに相当します。 PowerScript では、変数や配列を宣言するときに、これらのデータ型を使用します。

次に、 PowerScript の標準データ型とその説明を示します。

Blob 大きなバイナリオブジェクト。量を限定できないデータ（たとえば、一般的なバイナリデータ、画像データ、ワープロ文書などの大きなテキストデータ）を保持するのに使用します。

項目ページ

標準データ型 19

Any データ型 24

システムオブジェクトデータ型 27

カタログデータ型 29

EAServer での PowerBuilder データ型 29

Blob LongLongBoolean Long

Char または character Real Date String 型DateTime Time

Decimal または Dec UnsignedInteger、 UnsignedInt、またはUInt

Double UnsignedLong または ULongInteger または Int


標準データ型

Boolean TRUE または FALSE です。

Char または character 1 文字の ASCII 文字です。

アプリケーションにおいて、構文解析を要する文字データは、 Char 型の配列として定義すると便利です。 Char 型の配列の構文解析は、 String型の構文解析より簡単かつ高速だからです。さらに、文字データを外部関数に渡す場合にも、 String 型の代わりに Char 型の配列を使用した方がよいでしょう。

文字データを外部関数に渡す方法については、『アプリケーションテクニック』マニュアルを参照してください。 String 型のデータを Char 型のデータに代入したり、あるいはその逆の代入をするときのデータ型の変換についての詳細は、 77 ページの「 String 型と Char 型の間の変換」を参照してください。

リテラルの使い方リテラル値を代入するには、文字を単一引用符または二重引用符で囲みます。

char cc = 'T'c = "T"

Date ハイフンで区切られた年（1000 ～ 3000）、月（01 ～ 12）、日（01 ～ 31）からなる日付です。

リテラルの使い方リテラル値を代入するには、年、月、および日をハイフンで区切ります。

1992-12-25 // 1992 年 12 月 25 日 1995-02-06 // 1995 年 2 月 6 日

DateTime 日付と時刻が 1 つになったデータ型です。データベースの DateTime 値を読み書きするためだけに使用します。 DateTime 値を PowerBuilder で使用できるデータ型に変換するには、以下の関数を使用します。

• Date(datetime) 関数データベースから読み込んだ後で、 DateTime値を PowerBuilder の日付値に変換します。

• Time(datetime) 関数データベースから読み込んだ後で、 DateTime値を PowerBuilder の時刻値に変換します。

• DateTime(date, time) 関数データベースの DateTime カラムに書き込む前に、日付と時刻（時刻はオプション）を DateTime 値に変換します。

マイクロ秒をサポートする DBMS では、PowerBuilder データベースインタフェースによって、マイクロ秒がサポートされています。

20 PowerBuilder


Decimal または Dec 最大 18 桁の符号付き 10 進数です。 18 桁の任意の位置に小数点を入れることができます。たとえば、 123.456、 0.00000000000000001、12345678901234.5678 です。

リテラルの使い方リテラル値を代入するには、小数点を持ち指数部を持たない任意の 10 進数を使用します。以下のものは省略できます。プラス符号（95 と +95 は同じ）、 0 と 1 の間の数の少数点の左の 0 （0.1と .1 は同じ）、整数の場合の少数点の右の 0 （32.00 と 32.0 と 32 は同じ）。

12.34 0.005 14.0 -6500 +3.5555

Double 15 桁の精度で 2.2250738585073E-308 ～ 1.79769313486231E+308 の符号付き浮動小数点数です。

Integer または Int -32768 ～ +32767 の 16 ビットの符号付き整数です。

リテラルの使い方リテラル値を代入するには、任意の整数（正、負または 0）を使います。先頭のプラス符号は省略できます（18 と +18 は同じ）。

1 123 1200 +55 -32

Long -2147483648 ～ +2147483647 の 32 ビットの符号付き整数です。

リテラルの使い方 Integer 型と同じですが、より長い桁の数を使用できます。

LongLong -9223372036854775808～9223372036854775807 の 64 ビットの符号付き整数です。

リテラルの使い方 Integer 型と同じですが、より長い桁の数を使用できます。

Real 6 桁の精度で 1.175495E-38 ～ 3.402822E+38 の符号付き浮動小数点数です。

リテラルの使い方リテラル値を代入するには、後に E と整数が付いた10 進数を使います。スペースを用いることはできません。 E の前の 10進数は、10 進数リテラルに対するすべての規則に従います。指数部（Eの後の整数）の前のプラス符号は省略できます（3E5 と 3E+5 は同じ）。

2E4 2.5E78 +6.02E3 -4.1E-2-7.45E16 7.7E+8 3.2E-45

String 型可変長（0 ～ 2147483647）の ASCII 文字です。

アプリケーションにおいて、名前や住所などの文字データのほとんどは、 String 型で定義します。 PowerScript 言語では、文字列中の英文の小文字を大文字に変換する関数や、先頭と末尾のブランクを削除する関数など、文字列を操作する関数が多数用意されています。


標準データ型

文字データを外部関数に渡す方法については、『アプリケーションテクニック』マニュアルを参照してください。 String 型のデータを Char型のデータに代入したり、あるいはその逆の代入をするときのデータ型の変換についての詳細は、 77 ページの「 String 型と Char 型の間の変換」を参照してください。

リテラルの使い方リテラル値を代入するには、最大 1024 文字を単一引用符や二重引用符で囲みます。文字列には長さが 0 の文字列や空白文字列も含まれます。

string s1s1 = 'This is a string's1 = "This is a string"

次のように、引用符をほかの引用符で囲んで、 String 型リテラルの中に引用符を組み込むこともできます。たとえば、次のステートメントは、文字列 Here's a string を返します。

string s1s1 = "Here's a string."

また、次のように、ティルダ（~）を使用して、 String 型リテラルの中に引用符を組み込むこともできます。

string s1 = 'He said, "It~'s good!"'

複雑なネストティルダ（~）を使用して、文字列の中で引用符をネストさせて（入れ子状に）用いることができます。一番外側の対となる引用符が取り除かれ、各ティルダの後の文字がリテラルとして解釈されます。 2 つのティルダは 1 つのティルダとして、ティルダと引用符は引用符として解釈されます。

例 1 次の文字列は、 2 段階にネストされています。

"He said ~"she said ~~~"Hi ~~~" ~" "

まず、次のように解釈されます。

He said "she said ~"Hi ~" "

更に、次のように解釈されます。

she said "Hi"

最終的には、次のように解釈されます。

Hi

22 PowerBuilder


例 2 よくある例として、データウィンドウのプロパティを設定するModify 関数の引数に指定する文字列があります。この引数には、引用符を複雑に用いて何段階かにネストされた文字列を指定しなければならない場合があります。どちらの引用符を使うかについては、PowerBuilder がその文字列をどう解析するかを考慮します。次の二重引用符で囲まれた文字列は、 Modify 関数の引数です。ティルダの数を少なくするために、単一引用符と二重引用符を併用しています。

"bitmap_1.Invert='0~tIf(empstatus=~~'A~~',0,1)'"

二重引用符により、引数が文字列として解釈されます。単一引用符で囲まれた Invert プロパティに代入される式の文字列、さらに、式の中に単一引用符で囲まれた文字列 A が含まれています。まず、 Modify 関数に対する引数が評価され、その後、Invert プロパティに単一引用符で囲まれた式の文字列が代入されます。式の中の 2 つのティルダは 1 つのティルダとして解釈され、Invert プロパティに代入される文字列は次のようになります。

'0[tab]If(empstatus=~'A~',0,1)'

最終的には、ティルダと単一引用符は単一引用符として解釈され、プロパティの式が評価されて、該当するビットマップの色が設定されます。

例 3 文字列をネストする際には、いろいろな方法で引用符を指定できます。以下の Modify 関数に対する式は、同じ結果になります。

"emp.Color = ~"0~tIf(stat=~~~"a~~~",255,16711680)~"""emp.Color = ~"0~tIf(stat=~~'a~~',255,16711680)~"""emp.Color = '0~tIf(stat=~~'a~~',255,16711680)'""emp.Color = ~"0~tIf(stat='a',255,16711680)~""

引用符とティルダの規則文字列の中で引用符をネストして用いる際に参考にしてください。

• ティルダの右隣の引用符は、文字列の終わりとしてではなくリテラルとして扱われます。

• 単一引用符（'）の対は、ティルダと二重引用符（~"）の対の代わりに用いることができます。

• 2 つのティルダと単一引用符（~~'）の対は、 3 つのティルダと二重引用符（~~~"）の対の代わりに用いることができます。

Time 時（00 ～ 23）、分（00 ～ 59）、秒（00 ～ 59）、および秒未満（最大 6桁）からなる 00:00:00 ～ 23:59:59.999999 の 24 時間形式の時刻です。

マイクロ秒をサポートする DBMS では、PowerBuilder データベースインタフェースによって、マイクロ秒がサポートされています。


Any データ型

リテラルの使い方時（00 ～ 23）、分（00 ～ 59）、秒（00 ～ 59）、および秒未満（最大 6 桁）からなる 00:00:00 ～ 23:59:59.999999 の 24 時間形式の時刻です。時分秒はコロンで区切り、秒未満は小数点で区切ります。

21:09:15 // 午後 9 時 9 分 15 秒

06:00:00 // 午前 6 時

10:29:59 // 午前 10 時 30 分 1 秒前

10:29:59.9 // 午前 10 時 30 分 0.1 秒前

UnsignedInteger、UnsignedInt、または UInt

0 ～ 65535 の 16 ビットの符号なし整数です。

UnsignedLong または ULong

0 ～ 4294967295 の 32 ビットの符号なし整数です。

Any データ型概要 PowerBuilder では、 Any データ型もサポートしています。 Any データ型

は、標準データ型、オブジェクトデータ型、構造体、および配列など、何種類もの値を保持できます。 Any データ型はその状況に応じて姿を変えるカメレオンのようなもので、代入された値のデータ型を使用します。

Any データ型は EAServer コンポーネント定義では使えないPowerBuilder の Any データ型は PowerScript 固有のもので、EAServer コンポーネントの IDL ではサポートされていません。 CORBA にも、実行時任意のリーガル IDL 型になれる Any データ型がありますが、意味論的には PowerBuilder Any データ型と同じではありません。 PowerBuilderの Any データ型はこのコンポーネントインタフェース定義から除外することが必要ですが、コンポーネント内部では使用できます。

宣言と代入 Any データ型の変数は、ほかの変数を宣言するのと同じように宣言します。また、Any データ型の配列は、配列の各要素に対して異なるデータ型の値を代入できます。

Any データ型の変数に値を代入するときは、代入文を使用します。 Anyデータ型の変数には配列も代入できます。

24 PowerBuilder


Any データ型の変数に値を代入した後は、ClassName 関数を用いて変数の実際のデータ型を判別できます。

any la_spreadsheetdatala_spreadsheetdata = ole_1.Object.cells(1,1).valueCHOOSE CASE ClassName(la_spreadsheetdata)

CASE "integer"...

CASE "string"...

END CHOOSE

以下の規則は、 Any データ型の変数に対する代入文に適用されます。

• Any データ型の変数には、どんなデータ型の値でも代入できます。

• Any データ型の変数を適切なデータ型の変数に代入するには、 Anyデータ型の変数が保持している値のデータ型を知っていなければなりません。

制約事項 Any データ型の変数に配列を代入した場合は、配列要素にはアクセスできません。適切なデータ型の配列変数に Any データ型の変数を代入してから、配列要素にアクセスしてください。なお、Any データ型の配列変数に配列を代入した場合は、 Any データ型の配列要素に直接アクセスできます。

Any データ型の変数に構造体を代入した場合は、ドット（.）表記を使用して構造体の要素にアクセスすることはできません。適切なデータ型の構造体に Any データ型の変数を代入してから、構造体の要素にアクセスしてください。

Any データ型の変数に値を代入した後は、その変数をデータ型のない汎用的な Any データ型の変数（代入前の状態）には戻せません。 Anyデータ型の変数に NULL 値を設定しても、別のデータ型の値を代入しなければ、 Any データ型の変数は、前に代入した値のデータ型を保持します。

演算子と式 Any データ型の変数が保持する値のデータ型が、演算子に対して適切な場合は、Any データ型の変数に対して演算ができます。値のデータ型が演算子に対して適切でない場合、アプリケーションの実行時にエラーとなります。

たとえば、Any データ型の変数 ia_1 と ia_2 が数値データを保持している場合、以下のステートメントは有効です。

any la_3la_3 = ia_1 - ia_2


Any データ型

ia_1 と ia_2 が文字列を保持している場合は、連結演算子が使用できます。

any la_3la_3 = ia_1 + ia_2

しかし、 ia_1 に数値が保持され、 ia_2 に文字列が保持されている場合は、アプリケーションの実行時にエラーとなります。

データ型変換の関数 PowerScript のデータ型を変換する関数は、引数にAny データ型の変数も指定できます。 Any データ型の変数は、関数を呼び出したとき、その関数の引数のデータ型に変換できる値を保持していなければなりません。

たとえば、Any データ型の変数 ia_any が文字列を保持している場合は、String 型の変数に代入できます。

ls_string = ia_any

変数 ia_any が数値を保持している場合、 String 関数を呼び出して文字列

に変換できます。

ls_string = String(ia_any)

ほかの関数関数の引数が Any データ型を認めない場合は、 Any データ型の変数に正しいデータ型の値が保持されていても、変換関数を使わずに Any データ型の変数を使用することはできません。スクリプトをコンパイルするときに、 Unknown function や Function not foundなどのコンパイルエラーとなります。

たとえば、次の Len 関数の引数に指定した式は、データウィンドウのString 型のカラムの値を示す式ですが、この式のデータ型は Any データ型です。

IF Len(dw_notes.Object.Notes[1]) > 0 THEN // 無効

次の Len 関数の引数に指定した式は、String 関数を使用して Any データ型の式を String 型に変換しているので有効です。

IF Len(String(dw_notes.Object.Notes[1])) > 0 THEN

Any データ型の式スクリプトがコンパイルされるときにデータ型がわからないデータをアクセスする式は、 Any データ型です。これに該当するのは、 OLE オブジェクトやデータウィンドウオブジェクトのデータをアクセスする式です。

myoleobject.application.cells(1,1).valuedw_1.Object.Data[1,1]dw_1.Object.Data.empid[99]

26 PowerBuilder


これらの式に指定したオブジェクトを変更すると、式のデータ型も変更されます。

データウィンドウオブジェクトのデータを参照する式には、 Any データ型の配列、構造体、構造体の配列を返すものもあります。データウィンドウ式の値を代入する際にパフォーマンスをよくするには、 Anyデータ型の変数は使用しないで、適切なデータ型の配列や構造体にデータウィンドウ式の値を代入する必要があります。

Any データ型の使用上の注意

あらかじめデータ型がわかっている場合は、適切なデータ型の変数を使用する代わりに、 Any データ型の変数を使用するのは避けてください。それには 2 つの理由があります。

• Any データ型の変数を使用すると、実行時の処理が遅くなるPowerBuilder はデータ型を判別するために、代入や式を実行する前に多くの処理を行います。特に、適切なデータ型の変数の代わりに、Any データ型の変数を使用した式をループ処理で何度も実行する場合は、パフォーマンスに大きな影響を及ぼします。

• Any データ型の変数を使用している場合は、コンパイル時にデータ型のチェックをしない Any データ型以外のデータ型は、コンパイル時に、データ型が正しいかどうかがチェックされます。 Any データ型の変数を使用している場合は、コンパイル時に見つかるようなエラーが、アプリケーションを実行するまで見つけることができません。

システムオブジェクトデータ型データ型としてのオブジェクト

システムオブジェクトデータ型は PowerScript 独自のデータ型です。ブラウザの［システム］タブを選択して、すべてのシステムオブジェクトをリスト表示することができます。

PowerBuilder のアプリケーションでは、ウィンドウ、メニュー、コマンドボタン、リストボックス、グラフなどのオブジェクトを操作します。内部的には、PowerBuilder はこれらの各オブジェクトをデータ型として定義しています。通常、開発者は、これらのオブジェクトをデータ型として意識する必要はなく、 PowerBuilder の各ペインタによってオブジェクトを定義して使用するだけです。


システムオブジェクトデータ型

しかし、データ型の階層構造によって、 PowerBuilder がシステムオブジェクトをどのように管理しているかを知っていなければならない場合があります。たとえば、ウィンドウのインスタンスを作成するには、Window 型の変数を定義します。また、ウィンドウ内でポップアップするメニューのインスタンスを作成するには、Menu 型の変数を定義します。

PowerBuilder は、システムオブジェクトをクラスの階層構造によって管理しています。オブジェクトの各データ型がクラスに相当します。先祖オブジェクトと子孫オブジェクトの継承階層関係は、クラスによって形成されています。

例ブラウザに表示されているすべてのクラスは、実際にアプリケーションの中で使用できるデータ型で、変数を定義できます。データ型がどんなクラスの変数でも定義できます。

たとえば、次のコードでは、ウィンドウとメニューの変数を定義しています。

window mywinmenu mymenu

ウィンドウ上に複数のコマンドボタンが配置されており、その中で最後にクリックされたボタンの情報を必要とする場合には、CommandButton 型の変数を宣言して、その変数にウィンドウ上の情報が必要なボタンを割り当てることができます。

// ウィンドウのインスタンス変数として定義します。commandbutton LastClicked

// ウィンドウ上のコマンドボタンの Clicked イベントに対するスクリプトに、以下のように記述します。// これは、ユーザが最後にクリックした// コマンドボタンの情報を提供するものです。LastClicked = This

LastClicked 変数は CommandButton 型のため、 CommandButton コントロールのすべてのプロパティを持っています。上記のスクリプトを実行すると、 LastClicked 変数のプロパティ値は、ウィンドウ内で最後にクリックされたボタンと同じになります。

データ型を介したオブジェクトインスタンスの操作についての詳細は、 80 ページの「オブジェクトについて」を参照してください。

28 PowerBuilder


カタログデータ型カタログデータ型について

カタログデータ型（Enumerated Data Type）は、システムオブジェクトデータ型と同じように PowerScript 独自のデータ型です。カタログデータ型には、以下の 2 通りの用途があります。

• 関数の引数として

• オブジェクトやコントロールのプロパティを指定するため

ブラウザの［カタログデータ型］タブを選択して、すべてのカタログデータ型とその値をリスト表示することができます。

独自のカタログデータ型を作成することはできません。代わりに、定数変数セットを宣言し、初期値を設定することができます。 47 ページの「定数の宣言」を参照してください。

カタログデータ型には、あらかじめ決められた値だけを代入できます。また、カタログデータ型の値の最後には感嘆符（!）が添えられます。たとえば、テキストの配置を指定するカタログデータ型のAlignment プロパティには、 Center!、 Left!、 Right! の 3 つの値のうち、いずれか 1 つを代入できます。

mle_edit.Alignment=Right!

不適切な構文カタログデータ型の値を記述するときには、値を引用符で囲まないでください。コンパイルエラーが発生します。

カタログデータ型の利点

カタログデータ型では、標準データ型に優っている点として、カタログデータ型が必要となるとき、コンパイラがそのデータをチェックし、そのデータ型が正しいものであることを確認できます。たとえば、カタログデータ型の変数にほかのデータ型や不正な値を設定した場合は、コンパイルされません。

EAServer での PowerBuilder データ型EAServer コンポーネントインタフェースはすべて標準 CORBA IDL で定義されています。次の表は、 Jaguar Manager で使用される事前定義されたデータ型、同等の CORBA IDL 型、およびマップされるPowerBuilder データ型を示したものです。


EAServer での PowerBuilder データ型

表 2-1: EAServer での PowerBuilder データ型

Jaguar Manager CORBA IDL PowerBuilderInteger （16 ビット） Short Integer

Integer （32 ビット） Long Long

Integer （64 ビット） Long long LongLongBoolean Boolean BooleanFloat Float RealDouble Double DoubleString String StringBinary BCD::Binary BlobDecimal BCD::Decimal DecimalMoney BCD::Money DecimalDate MJD::Date DateTime MJD::Time TimeTimestamp MJD::Timestamp DateTimeResultSet TabularResults::ResultSet ResultSetResultSets TabularResults::ResultSets ResultSetsVoid Void なし

30 PowerBuilder

第 3 章宣言

この章についてこの章では、変数、定数、配列の宣言方法とスクリプトでのそれらの参照方法、リモートプロシージャコール（RPC）の宣言方法、およびダイナミックリンクライブラリ（DLL）内の外部関数の宣言方法について説明します。

内容

変数の宣言概要 PowerBuilder スクリプトで変数を使うには、まず、変数のデータ

型と名前を指定して宣言しなければなりません。

変数は、標準データ型、オブジェクトデータ型、構造体として宣言できます。オブジェクトデータ型には、ブラウザに表示されるシステムオブジェクトや、システムオブジェクト型から派生したユーザ定義オブジェクトがあります。変数を宣言する際、ほとんどのデータ型の変数に初期値を指定できます。また、宣言した変数には、スクリプトで常に値を代入できます。

変数の宣言場所スコープ PowerScript 変数を宣言する場所を選択して、スコープを決定しま

す。インスタンス変数を宣言するときは、特定のスクリプトからの変数へのアクセスを制限するアクセスキーワードを指定できます。

項目ページ

変数の宣言 31

定数の宣言 47

配列の宣言 48

外部関数の宣言 58

リモートプロシージャコールとしての DBMS ストアドプロシージャの宣言

66


変数の宣言

次の表に、変数の 4 つのスコープを示します。

表 3-1: PowerScript の変数のスコープ

グローバル変数、インスタンス変数、共有変数の宣言

グローバル変数、インスタンス変数、共有変数は、アプリケーション、ウィンドウ、ユーザオブジェクト、またはメニューの各ペインタのスクリプトビューで定義できます。グローバル変数は、関数ペインタで定義することもできます。

1 スクリプトビューの最初のドロップダウンリストで［Declare］を選択します。

2 スクリプトビューの 2 番目のドロップダウンリストで、宣言する変数の型を選択します。

3 スクリプトビューのスクリプト作成領域で、宣言を記述します。

ローカル宣言そのオブジェクトまたはコントロールのスクリプト内で、オブジェクトまたはコントロールに対してローカル変数を宣言します。

スコープ説明

グローバル

変数が宣言されたアプリケーション内のどのスクリプトからでもアクセスできます。どのオブジェクトの定義にも依存しません。

インスタンス

変数が宣言されたオブジェクトに属し、そのオブジェクトのインスタンスに関連付けられます。オブジェクトのプロパティとみなすことができます。アクセスキーワードは、ほかのオブジェクトのスクリプトがインスタンス変数にアクセスできるかどうかを決定します。インスタンス変数は、アプリケーションオブジェクト、ウィンドウ、ユーザオブジェクト、メニューの各オブジェクトのインスタンスに属します。

共有変数が宣言されたオブジェクトの定義に属し、そのオブジェクトのすべてのインスタンスで共有されます。共有変数は、オブジェクトを閉じて再度開いても、オブジェクトを閉じる前の値を保持しています。

共有変数のアクセスレベルは常にプライベートで、オブジェクトとそのオブジェクトに関連付けられたコントロールのスクリプトだけがアクセスできます。インスタンス変数は、アプリケーションオブジェクト、ウィンドウ、ユーザオブジェクト、メニューの各オブジェクトのインスタンスに属します。

ローカル変数が宣言されたスクリプトからだけアクセスできる一時的な変数です。スクリプトの実行が終了すると、変数の値は破棄されます。

32 PowerBuilder

第 3 章宣言

SQL カーソルの宣言グローバル、共有、インスタンス、またはローカルの SQL カーソルも宣言できます。スクリプトビューで、特定のスクリプトを開くか、変数宣言スコープを選択し、DECLARE SQL 文を記述するか、またはペインタバーかポップアップメニューから［SQL 貼付］を選択します。

変数の使い方概要 PowerBuilder スクリプトで変数の値を使用または設定するには、変数

に名前を付けます。変数はコンパイル時に認識されなければなりません。つまり、あるスコープ内で宣言されていなければなりません。

変数の値が必要なときは、スクリプトのどこででも変数を使えます。たとえば、関数の引数や代入文で使うことができます。

変数の参照順序スクリプトの実行中に修飾子のない変数の参照があった場合、PowerBuilder は、その変数を以下の順序で検索します。

1 ローカル変数

2 共有変数

3 グローバル変数

4 インスタンス変数

指定された名前の変数が見つかると、すぐにその変数の値が使用されます。

グローバル変数の参照グローバル変数を参照するには、スクリプトでその変数の名前を指定します。ただし、そのグローバル変数と同じ名前のローカル変数や共有変数がある場合は、ローカル変数または共有変数が先に見つかります。

同じ名前のローカル変数や共有変数でマスクされているグローバル変数を参照するには、変数名の前にグローバルスコープ記号（::）を付けます。

::globalname

たとえば、次のステートメントでは、 total という名前のローカル変数とグローバル変数の値を比較します。

IF total < ::total THEN ...


変数の宣言

インスタンス変数の参照

アプリケーションでオブジェクトのインスタンスが開かれている場合は、スクリプトでそのオブジェクトのインスタンス変数を参照できます。どのオブジェクトのインスタンス変数を参照するかに応じて、インスタンス変数が宣言されているオブジェクトの名前でインスタンス変数名を修飾する必要があります。

修飾子のない名前の使い方以下の場合、インスタンス変数をオブジェクト名で修飾しなくても参照できます。

• アプリケーションレベルの変数は、アプリケーションオブジェクトのスクリプトで参照できる

• ウィンドウレベルの変数は、ウィンドウのスクリプトと、そのウィンドウにあるコントロールのスクリプトで参照できる

• ユーザオブジェクトレベルの変数は、ユーザオブジェクトのスクリプトと、そのユーザオブジェクトにあるコントロールのスクリプトで参照できる

• メニューレベルの変数は、メニューオブジェクトのスクリプト、つまり最上位レベルのメニュー、またはメニュー項目として含まれているメニューオブジェクトのスクリプトのどちらかで参照できる

たとえば、ウィンドウ w_emp にインスタンス変数 EmpID が宣言されている場合、 w_emp やそのウィンドウのコントロールのスクリプトでは、次に示すように、修飾子を使わずに変数 EmpID を参照できます。

sle_id.Text = EmpID

修飾子の使い方上記以外では、ドット（.）表記を使って、インスタンス変数名をオブジェクト名で修飾する必要があります。

object.instancevariable

この条件は、パブリックのインスタンス変数だけに適用されます。プライベートのインスタンス変数は、修飾子の有無にかかわらず、変数が宣言されているオブジェクトの外部から参照することはできません。

たとえば、ウィンドウ w_emp の外部のスクリプトから w_emp のインスタンス変数 EmpID を参照するには、ウィンドウ名でインスタンス変数を修飾する必要があります。

sle_ID.Text = w_emp.EmpID

34 PowerBuilder

第 3 章宣言

次の場合も、インスタンス変数を参照するには、修飾子が必要です。たとえば、ウィンドウ w_emp にインスタンス変数 EmpID が宣言されており、そのウィンドウには Clicked スクリプトにローカル変数 EmpIDが宣言されているコマンドボタンがあるとします。そのスクリプトでインスタンス変数を参照する場合も、修飾する必要があります。

Parent.EmpID

修飾子としての代名詞の使い方

変数を参照するときにあいまいにならないように、オブジェクト変数には常に修飾子を使うとよいでしょう。修飾子を使えば、変数がローカル、インスタンス、共有のどのスコープで宣言されているかが明確になります。

修飾子を使ったままの汎用コードを記述するには、代名詞 This やParent を使ってオブジェクトを参照します。代名詞を使えば、参照するオブジェクトが変わっても、そのスクリプトを変更せずにそのまま使用できます。

ウィンドウのスクリプトでのウィンドウ変数ウィンドウのスクリプトで、ウィンドウのインスタンス変数を参照するには、代名詞 This を使います。たとえば、ウィンドウに index という名前のインスタンス変数が宣言されている場合、同じ名前のローカル変数やグローバル変数がない限り、そのウィンドウのスクリプトでは、以下の 2 つのステートメントは同じです。

index = 5This.index = 5

コントロールのスクリプトでのウィンドウ変数ウィンドウ上のコントロールのスクリプトで、ウィンドウ（コントロールの親）のインスタンス変数を参照するには、代名詞 Parent を使います。たとえば、「index」という名前のローカル変数やグローバル変数がない限り、ウィンドウにあるコントロールのスクリプトでは、以下の 2 つのステートメントは同じです。

index = 5Parent.index = 5

変数名の重複ミス「index」という名前のローカル変数やグローバル変数がある場合は、変数を参照するときに修飾子を使用しないと、ローカル変数またはグローバル変数が参照されます。オブジェクト変数を参照するつもりならば、これはプログラムのミスです。インスタンス変数とグローバル変数で同じ名前を使用すると、コンパイラはメッセージを表示します。


変数の宣言

変数宣言のための構文単純な構文最も単純な構文で PowerScript 変数を宣言する場合は、データ型と変数

名のみ記述します。次に例を示します。 datatype variablename

完全な構文完全な構文を使うと、アクセスレベルと初期値を指定できます。配列や、 Blob 型、 Decimal 型など一部のデータ型には、以下のような追加情報を指定できます。

{ access } datatype { { size } } { { precision } } variablename { = value }{, variablename2 { = value2 } }

36 PowerBuilder

第 3 章宣言

表 3-2: 変数宣言のパラメータ

例インスタンス変数の宣言

integer ii_total = 100 // 全体の株date id_date // 株が購入された日付

グローバル変数の宣言

string gs_name

共有変数の宣言

time st_process_startstring ss_process_name

パラメータ説明

access （オプション）

（インスタンス変数のみ）変数に対するアクセスキーワード。詳細については、 42 ページの「インスタンス変数へのアクセス」を参照してください。

datatype 変数のデータ型。標準データ型、システムオブジェクト、事前に定義した構造体を指定できます。

Blob 型と Decimal 型は、カッコに任意の値を記述して、データのサイズや精度を指定できます。

{ size } （オプション）

Blob 型の場合のみ。変数のサイズをバイト数で指定して中カッコで囲みます。 size を省略すると、Blob 型変数の初期サイズは 0 となり、 PowerBuilder によって実行時に用途に応じたサイズに調整されます。スクリプトで宣言した Blob 型変数のサイズを超えるデータを代入すると、超過分を切り捨てたデータが保持されます。

{ precision } （オプション）

（Decimal 型のみ）中カッコで囲んだ小数点以下の桁数。精度を指定しなければ、実行時にスクリプトでその変数に割り当てられた精度が用いられます。

variablename 変数の名前。 5 ページの「識別子の命名」で前述したとおり、名前は PowerScript で有効な識別子でなければなりません。同じデータ型の複数の配列を一度に宣言するには、配列名をカンマで区切ります。各配列には初期値を設定できます。

value （オプション）

変数の初期値となる適切なデータ型のリテラルまたは式。

Blob 型の変数は、初期値を指定できません。

詳細については、 39 ページの「変数の初期値」を参照してください。


変数の宣言

ローカル変数の宣言

string ls_city = "Boston"integer li_count

Blob 型変数の宣言以下のステートメントは、 Blob 型の変数ib_Emp_Picture を初期サイズ 0 で宣言します。データが代入されたときに、変数のサイズが調整されます。

blob ib_Emp_Picture

以下のステートメントは、 Blob 型の変数 ib_Emp_Picture のサイズを100 バイトで宣言します。

blob{100} ib_Emp_Picture

Decimal 型変数の宣言以下のステートメントは、Decimal 型で精度が小数点以下 2 桁の共有変数、 sc_Amount と sc_dollars_accumulated を宣言します。

decimal{2} sc_Amountdecimal{2} sc_dollars_accumulated

以下のステートメントは、 Decimal 型で精度が小数点以下 4 桁の変数、lc_Rate1 と lc_Rate2 を宣言します。

dec{4} lc_Rate1, lc_Rate2

以下のステートメントは、 Decimal 型で精度が小数点以下 0 桁の変数lc_Balance を宣言します。

decimal{0} lc_Balance

以下のステートメントは、 Decimal 型の変数 lc_Result に精度を指定しません。変数 lc_Result は、 Decimal 型で精度が小数点以下 2 桁の変数、lc_Op1 と lc_Op2 が代入された後は、小数点以下 4 桁の Decimal 型となります。

dec lc_Resultdec{2} lc_Op1, lc_Op2lc_Result = lc_Op1 * lc_Op2

変数のデータ型

PowerScript 変数は、以下のデータ型のいずれかで宣言できます。

• 標準データ型（Integer 型や String 型）

• オブジェクトやコントロール（window 型や CommandButton 型など）

38 PowerBuilder

第 3 章宣言

• 開発者が定義したオブジェクトや構造体（mywindow という名前のウィンドウなど）。スクリプトのコンパイル時、定義したオブジェクトがアプリケーションのライブラリ探索パス内のライブラリになければならない

変数の名前

アプリケーションの設計段階で、 PowerScript 変数の命名規約を標準化しておくとよいでしょう。命名規約を決めておくと、スクリプトが理解しやすくなり、変数名の衝突を防ぐこともできます。一般的には変数名に、スコープとデータ型を認識する接頭辞を付けます。たとえば、インスタンス変数の名前の先頭には、 ii_count や is_empname のようにi を付け、Integer 型のローカル変数の名前は li_total、Integer 型のグローバル変数の名前は gi_total などにします。

命名規約についての詳細は『PowerBuilder ユーザーズガイド』マニュアルを参照してください。

変数名としての X と Y

x と y を一般的な変数名として使うこともできますが、PowerBuilder では、 x と y は、オブジェクトの画面上の座標を指定するプロパティでもあります。 x と y を変数として宣言しないで使っても、コンパイルエラーにはなりません。ただし、PowerBuilder は、ユーザがオブジェクトを移動するとみなして処理します。したがって、アプリケーション内で予期しない結果になることがあります。

変数の初期値

PowerScript 変数を宣言する場合、その変数のデフォルトの初期値を使用したり、宣言時に初期値を指定できます。

変数のデフォルト値変数を宣言する場合に変数に初期値を設定しないときは、次の表に示すように、そのデータ型のデフォルト値が変数に設定されます。


変数の宣言

表 3-3: 変数のデフォルト値

初期値としてのリテラルの指定

変数の宣言時に変数に初期値を設定するには、変数とそのデータ型に適切なリテラルを等号（=）で結びます。特定のデータ型のリテラルについての詳細は、 19 ページの「標準データ型」を参照してください。

次の宣言では、 Integer 型の変数 li_count の初期値に 5 を設定します。

integer li_count=5

次の宣言では、Integer 型の変数 li_a と li_b の初期値にそれぞれ 5 と 10を設定します。

integer li_a=5, li_b=10

次の宣言では、 String 型の変数 ls_method の初期値に文字列「UPS」を設定します。

string ls_method="UPS"

次の宣言では、String 型の変数 ls_headers の初期値にタブで区切られた3 つの単語を設定します。

string ls_headers = "Name~tAddress~tCity"

次の宣言では、Integer 型の変数 li_a と li_c の初期値にそれぞれ 1 と 100を設定し、 Integer 型の変数 i_b に Integer 型のデフォルト値 0 を設定します。

integer li_a=1, li_b, li_c=100

次の宣言では、 Date 型の変数 ld_StartDate の初期値に 1993 年 2 月 1 日を設定します。

date ld_StartDate = 1993-02-01

変数のデータ型デフォルト値

Blob サイズ 0、つまり空の Blob 型変数

Char （または Character） ASCII コード値の 0Boolean FALSEDate 1900-01-01 （1900 年 1 月 1 日）

DateTime 1900-01-01 00:00:00

数値型（Integer、 Long、 LongLong、Decimal、 Real、 Double、UnsignedInteger、 UnsignedLong）

0

String 空文字列（""）Time 00:00:00 （午前 0 時）

40 PowerBuilder

第 3 章宣言

初期値としての式の指定

次のように、既存の変数または式の値を、変数の初期値として設定できます。

integer i = 100integer j = i

このように宣言すると、スクリプトをコンパイルしたときに、 2 つ目の変数の初期値として最初の式の値が設定されます。変数の初期値は、アプリケーションの実行時に再評価されません。

式の値が変わる場合式の値は、アプリケーションの実行時ではなくコンパイル時に、変数に設定されます。したがって、式の値は現行の条件に基づいた値ではありません。式の値がアプリケーションの実行時に変わる場合は、変数を宣言するときに初期値として式の値を設定しないでください。このような場合は、変数の宣言と値の代入を別々のステートメントに記述します。

次の宣言では、変数 d_date の値に、スクリプトがコンパイルされた日付が設定されます。

date d_date = Today( )

次の宣言では、変数 d_date の値に、アプリケーションが実行された日付が設定されます。

date d_dated_date = Today( )

共有変数の初期化スクリプトで共有変数を使うと、その共有変数はオブジェクトの最初のインスタンスが開かれたときに初期化されます。オブジェクトを閉じても、共有変数の値は、アプリケーションを終了するまで保持されます。このため、アプリケーションを終了しないで再びオブジェクトを開くと、共有変数にはオブジェクトを閉じたときの値がそのまま保持されています。

たとえば、ウィンドウのスクリプトで共有変数 Count に 20 を設定してウィンドウを閉じ、アプリケーションを終了しないで再びウィンドウを開いても、 Count の値は 20 のままです。

ウィンドウのインスタンスを複数使用する場合上記の例で、ウィンドウのインスタンスが複数存在する場合は、すべてのインスタンスで Count の値が 20 になります。共有変数は、ウィンドウのすべてのインスタンスで共有されるので、ウィンドウのインスタンスのいずれかで Count の値を変更すると、ほかのインスタンスのCount の値も変更されます。


変数の宣言

インスタンス変数の初期化

インスタンス変数は、宣言されているウィンドウ、メニュー、またはアプリケーションの各オブジェクトが開かれるときに初期化されます。変数の初期値は、変数のデータ型のデフォルト値か、変数の宣言時に指定した値が設定されます。

オブジェクトを閉じるとインスタンス変数の値は破棄され、再びオブジェクトを開くと、インスタンス変数が再び初期化されます。

ウィンドウのインスタンスを複数使用する場合ウィンドウのインスタンスが複数存在する場合に、そのインスタンスのいずれかのスクリプトを作成するときは、インスタンスごとに異なる値をインスタンス変数に保持できます。たとえば、ウィンドウのインスタンスの内容に基づいてフラグを設定するには、インスタンス変数を使います。

共有変数を使用する場合以下のような変数が必要な場合は、インスタンス変数のかわりに共有変数を使います。

• オブジェクトの複数のインスタンスで、同じ値を保持する場合

• オブジェクトを閉じた後も、変数の値を保持する場合

インスタンス変数へのアクセス

説明 36 ページの「変数宣言のための構文」では、インスタンス変数を宣言するときに、その変数にアクセスキーワードを指定できることを説明しました。この節では、それらのキーワードについて説明します。

インスタンス変数にアクセス権を指定すると、その変数の参照レベルを制御でき、どのスクリプトでその変数名を認識できるかが決まります。

指定したアクセス権について、修飾子キーワードを使って操作上のアクセス権を制御できます。つまり、どのスクリプトが変数の値を読み込めるか、およびどのスクリプトが変数の値を変更できるかを指定できます。

構文 { access-right } { readaccess } { writeaccess } datatype variablename

次の表に、インスタンス変数に対するアクセス権を指定するためのパラメータを示します。

42 PowerBuilder

第 3 章宣言

表 3-4: インスタンス変数を宣言するときにアクセス権を指定するためのパラメータ


access-right （オプション）

インスタンス変数を参照できるスクリプトの範囲を指定するキーワード。値は、次のとおりです。

• PUBLIC －（デフォルト）変数が宣言されているアプリケーション内のすべてのスクリプトが変数を参照できます。別のオブジェクトのスクリプトで変数を参照するときは、ドット（.）表記を使用して変数名を修飾し、その変数が属すオブジェクトを識別します。

• PROTECTED －変数が宣言されているオブジェクトのスクリプトとそのオブジェクトの子孫スクリプトが変数を参照できます。

• PRIVATE －変数が宣言されているオブジェクトのスクリプトだけが変数を参照できます。そのオブジェクトの子孫スクリプトは、変数を参照できません。

readaccess （オプション）

スクリプトで変数の値の参照を制限するキーワード。値は、次のとおりです。

• PROTECTEDREAD －変数が宣言されているオブジェクトのスクリプトとその子孫スクリプトだけが変数を参照できます。

• PRIVATEREAD －変数が宣言されているオブジェクトのスクリプトだけが変数を参照できます。

access-right が PUBLIC の場合、どちらのキーワードでも指定できます。 access-right が PROTECTED の場合、PRIVATEWRITE だけが指定できます。 access-rightが PRIVATE の場合は、ほかのスクリプトからのアクセスを完全に制限するので、readaccess は指定できません。 readaccess を省略すると、すべてのスクリプトで変数を参照できます。


変数の宣言

解説アクセス修飾子を使うと、特定のオブジェクト変数に対するオブジェクトのアクセスをさらに制御できます。一般的には、パブリック変数を宣言して、オブジェクトのオーナだけがその変数を修正できるようにします。

public protectedwrite integer ii_count

アクセス権キーワードをラベルとして指定することによって、同じアクセス権が指定された宣言をグループ化できます。次の「アクセス権キーワードの別の形式」を参照してください。

エクスポートされるオブジェクトの構文を見ると、アクセス修飾子SYSTEMREAD や SYSTEMWRITE が使われている場合があります。これらのキーワードが指定された変数にアクセスできるのは、PowerBuilderだけです。このような変数をスクリプトや関数で参照することはできません。また、インスタンス変数を宣言する場合に、これらのキーワードを使うことはできません。

例インスタンス変数を宣言するには、適切なペインタで［宣言｜インスタンス変数］を選択します。

インスタンス変数の宣言では、アクセスキーワードを使って、変数へのアクセスを制御します。

writeaccess （オプション）

スクリプトで変数の値の変更を制限するキーワード。値は、次のとおりです。

• PROTECTEDWRITE －変数が宣言されているオブジェクトのスクリプトとその子孫スクリプトだけが変数を変更できます。

• PRIVATEWRITE －変数が宣言されているオブジェクトのスクリプトだけが変数を変更できます。

access-right が PUBLIC の場合、どちらのキーワードでも指定できます。 access-right が PROTECTED の場合、PRIVATEWRITE だけが指定できます。 access-rightが PRIVATE の場合は、ほかのスクリプトからのアクセスを完全に制限するので、readaccess は指定できません。

writeaccess を省略すると、すべてのスクリプトで変数を変更できます。

datatype 有効なデータ型 36 ページの「変数宣言のための構文」を参照してください。

variablename 有効な識別子。36 ページの「変数宣言のための構文」を参照してください。


44 PowerBuilder

第 3 章宣言

private integer ii_a, ii_npublic integer ii_Subtotalprotected integer ii_WinCount

次のプロテクト変数は、変数が宣言されたオブジェクトのスクリプトでのみ変更できます。そのオブジェクトの子孫スクリプトからは、変数を参照することができます。

protected privatewrite string is_label

次の変数のアクセスレベルは、デフォルトのパブリックですが、変数が宣言されたオブジェクトのスクリプトでのみ変数を変更できます。

privatewrite real ir_accum, ir_current_data

次の変数は、変数が宣言されたオブジェクトのスクリプトでのみ、変数を読み込むまたは書き込むことができます。ただし、変数名はパブリックレベルで保存されます。

public privateread privatewrite integer ii_reserved

オブジェクトの外部で認識されないプライベート変数次の例では、ウィンドウ w_emp に、プライベートの Integer 型インスタンス変数 ii_int を宣言したとします。

private integer ii_int

スクリプトで、 w_myemp という名前のウィンドウのインスタンスを宣言します。変数 ii_int のアクセスレベルはプライベートなので、ウィンドウのスクリプト以外のスクリプトから変数を参照することはできません。したがって、プライベート変数 ii_int を参照しようとすると、コンパイル時に変数が定義されていないというエラーが発生します。

w_emp w_myemp

w_myemp.ii_int = 1 // 変数が定義されていません。

アクセスが制限されたパブリック変数次の例では、ウィンドウ w_empに、書き込みアクセスをプライベートに制限したパブリックの Integer型インスタンス変数 ii_int を宣言したとします。

public privatewrite integer ii_int

上記の例と同じスクリプトを記述した場合、コンパイル時に変数への書き込みができないというエラーが発生します。変数のアクセスレベルはパブリックなので変数は認識されますが、書き込みアクセスは許可されません。

w_emp w_myemp

w_myemp.ii_int = 1 // 変数への書き込みは行えません。


変数の宣言

アクセス権キーワードの別の形式

説明アクセス権キーワードをラベルとして指定することによって、アクセス権に応じて PowerScript 変数の宣言をグループ化できます。ラベルは、グループの先頭行に記述し、後にコロン（:）が続きます。

構文 access-right:

{ readaccess } { writeaccess } datatype variablename

{ access-right } { readaccess } { writeaccess } datatype variablename

{ readaccess } { writeaccess } datatype variablename

ラベルを付けた宣言のグループ内のいずれかの変数に対して、ラベルに指定したアクセス権とは別のアクセス権キーワードを指定すると、その変数のアクセス権だけを上書きできます。それ以外の変数では、ラベルに指定したアクセス権が有効です。

例以下の宣言では、インスタンス変数に対して、アクセス権をラベルで指定します。最終行に宣言されている変数では、ラベルのパブリックがプライベートに上書きされます。

Private:integer ii_a=10, ii_b=24string is_Name, is_Address1Protected:integer ii_Unitsdouble idb_Resultsstring is_LnamePublic:integer ii_Weightstring is_Location="Home"private integer ii_test

以下のプロテクト宣言では、変数 idb_Results と is_Lname への書き込みを制限します。

Protected:integer ii_Unitsprivatewrite double idb_Resultsprivatewrite string is_Lname

46 PowerBuilder

第 3 章宣言

定数の宣言説明初期値を設定できる標準データ型は、変数ではなく定数として宣言で

きます。定数を宣言するには、宣言内にキーワード CONSTANT を指定し、初期値を代入します。

構文 CONSTANT { access } datatype constname = value

次の表に、定数を宣言するときに使用するパラメータを示します。

表 3-5: 定数を宣言するためのパラメータ

解説定数を宣言する場合は、初期値を指定する必要があります。そうしないとコンパイルエラーが発生します。また、定数を宣言した後に値を代入した場合、つまり子孫オブジェクト内で定数を再定義した場合も、コンパイルエラーが発生します。

例 PowerScript は、大文字と小文字を区別しませんが、以下のローカル定数の例では、定数名に大文字を使います。

constant string LS_HOMECITY = "Boston"constant real LR_PI = 3.14159265


CONSTANT 変数のかわりに定数を宣言する。 CONSTANT キーワードは、 access キーワードの前か後に指定できます。


（インスタンス定数のみ）定数に対するアクセスキーワード。詳細については、 42 ページの「インスタンス変数へのアクセス」を参照してください。

datatype 定数の標準データ型。 Decimal 型の場合、中カッコで囲んだデータの精度を指定できます。 Blob 型を定数に

することはできません。

PowerBuilder のデータ型についての詳細は、 19 ページの「標準データ型」を参照してください。

constname 定数の名前。 5 ページの「識別子の命名」で前述したとおり、名前は PowerScript で有効な識別子でなければなりません。

value 定数の値となる適切なデータ型のリテラルまたは式。value は必須です。詳細については、 39 ページの「変数の初期値」を参照してください。


配列の宣言

配列の宣言説明配列とは、インデックス番号を持つ、同じデータ型の要素の集まりで

す。 PowerBuilder では、配列には 1 次元と多次元の配列があります。 1次元配列では、サイズを固定または可変にできます。多次元配列は固定サイズです。配列の各次元は、 2,147,483,647 バイトの要素を持つことができます。

配列を宣言するときには、変数名の後に角カッコを記述します。固定長配列を宣言する場合は、角カッコの中に次元サイズを指定します。

構文 { access } datatype variablename { d1, ..., dn } { = { valuelist } }

次の表に、配列を宣言するときに使用するパラメータを示します。

48 PowerBuilder

第 3 章宣言

表 3-6: 配列を宣言するためのパラメータ



（インスタンス変数のみ）変数に対するアクセスキーワード。詳細については、 42 ページの「インスタンス変数へのアクセス」を参照してください。

datatype 変数のデータ型。標準データ型、システムオブジェクト、事前に定義した構造体を指定できます。

Decimal 型の場合、 datatype の後に中カッコで任意の値を記述して、データの精度を指定できます。 36ページの「変数宣言のための構文」を参照してください。

decimal {2} variablename [ ]配列では、サイズを指定した固定長の Blob 型はサポートされません。 datatype の後に Blob 型のサイズを指定しても無視されます。

variablename 変数の名前。 5 ページの「識別子の命名」で前述したとおり、名前は、 PowerScript で有効な識別子でなければなりません。同じデータ型の複数の配列を一度に宣言するには、角カッコで囲まれた次元のサイズと一緒に、配列名をカンマで区切ります。

[ { d1, ..., dn } ] 固定長配列の各次元のサイズを指定する、角カッコで囲まれた次元数分の整数値（各次元につき、 d1 から dn）。1 次元の可変長配列は、角カッコだけを指定します。可変長配列のサイズの変更方法についての詳細は、53 ページの「可変長配列のサイズ」を参照してください。

固定長配列は、指定した整数値の数によって次元の数は決定され、その配列が使用できるメモリサイズが確定されます。固定長配列では、 TO 表記を使用して、次元サイズではなく各次元に対する要素の範囲を指定できます。TO 表記を指定すれば、各次元の下限を変更できます。upperbound は lowbound より大きくなければなりません。

[ d1lowbound TO d1upperbound {, ... ,dnlowbound TO dnupperbound } ]


配列の宣言

例次の例では、可変長配列を宣言します。

integer li_stats[ ] // Integer 型の配列decimal {2} ld_prices[ ] // 小数点以下 2 桁の Decimal 型

// の配列blob lb_data[ ] // 可変長の Blob 型

// の配列date ld_birthdays[ ] // Date 型の配列string ls_city[ ] // String 型の配列

// 各文字列の長さは// 任意

次のステートメントでは、可変長の Decimal 型の配列を宣言します。この宣言では、配列の精度を指定しないので、配列の各要素の精度は、割り当てられる値の精度をとります。

dec lc_limit[ ]

固定長配列次の例では、 1 次元の固定長配列を宣言します。

integer li_TaxCode[3] // 3 つの要素を持つ Integer 型の配列。string ls_day[7] // 7 つの要素を持つ String 型の配列。blob ib_image[10] // 10 個の要素を持つ可変サイズの

// Blob 型の配列。dec{2} lc_Cost[10] // 10 個の要素を持つ Decimal 型の

// 配列。// 各要素の値は// 小数点以下 2 桁// です。

decimal lc_price[20] // 20 個の要素を持つ Decimal 型の// 配列。// 各要素の精度は、// 割り当てられる値の精度です。

配列のインデックス番号を変更する TO 表記の使い方以下の固定長配列では、 TO 表記を使って配列のインデックス番号の範囲を変更します。

real lr_Rate[2 to 5] // 4 つの要素を持つ Real 型の配列。 // 各要素は Rate[2] から

Rate[5] です。integer li_Qty[0 to 2] // 3 つの要素を持つ Integer 型

{ valuelist } （オプション）

配列の各要素の初期値リスト。初期値はカンマで区切られ、リスト全体は中カッコ（{}）で囲まれます。初期値の数は配列の要素数よりも多くてはいけません。初期値のデータ型は、datatype と一致しなければなりません。


50 PowerBuilder

第 3 章宣言

の配列。string ls_Test[-2 to 2] // 5 つの要素を持つ String 型の配列。integer li_year[76 to 96] // 21 個の要素を持つ Integer 型の配列。string ls_name[-10 to 15] // 26 個の要素を持つ String 型の配列。

TO の間違った使い方配列の各次元において、 1 番目のインデックス番号より 2 番目の方が大きくなければなりません。したがって、以下の宣言は無効です。

integer li_count[10 to 5] // 10 は 5 よりも大きいので // 無効です。

integer li_price[-10 to -20] // -10 は -20 よりも大きい// ので無効です。

2 次元以上の配列次の例では、 6 つの要素を持つ 2 次元の Integer 型配列を宣言します。各要素は、 li_score[1,1]、 li_score[1,2]、 li_score[1,3]、li_score[2,1]、 li_score[2,2]、 li_score[2,3] です。

integer li_score[2,3]

次の宣言では、各次元のインデックス番号を、1 ～ 5 および 10 ～ 25 に指定します。

integer li_RunRate[1 to 5, 10 to 25]

次の例では、 45,000 個の要素を持つ 3 次元配列を宣言します。

long ll_days[3, 300, 50]

以下の宣言では、 2 次元と 3 次元の添え字の範囲を変更します。

integer li_staff[100, 0 to 20, -5 to 5]

以下の例は、多次元配列の宣言です。

string ls_plant[3,10] // 30 個の要素を持つ String 型の// 2 次元配列です。

dec{2} lc_rate[3,4] // 12 個の要素を持つ Decimal 型の// 2 次元配列です。// 精度は小数点以下 2 桁です。

次の例では、 3 つの Decimal 型の配列を宣言します。 decimal{3} lc_first[10],lc_second[15,5],lc_third[ ]


配列の宣言

配列要素の値概要配列の各要素は、宣言時に指定したデータ型のデフォルト値で初期化

されます。たとえば、次のように、 Integer 型の配列を宣言します。 integer li_TaxCode[3]

各要素 li_TaxCode[1]、 li_TaxCode[2]、 li_TaxCode[3] は、すべて 0 に初期化されます。

基本的なデータ型のデフォルト値についての詳細は、 39 ページの「変数の初期値」を参照してください。

1 次元配列 1 次元配列では、配列を宣言するときに、配列要素に初期値を指定することで、データ型のデフォルト値を上書きできます。初期値は、中カッコの中に値をカンマで区切って指定します。配列内のすべての要素に初期値を指定する必要はありませんが、最初の要素に初期値を指定していない場合は、それ以降の要素に初期値を指定することはできません。

多次元配列多次元配列の場合も同様、初期値をカンマで区切って指定します。初期値を配列要素に代入すると、最初の次元が最も速く設定され、最後の次元が最も遅く設定されます。つまり、 2 次元目のインデックス番号が 1 つ変わるごとに 1 次元目のすべての要素に初期値が設定され、3次元目のインデックス番号が 1 つ変わるごとに 2 次元目のすべての要素に初期値が設定されるという処理を繰り返して、配列内のすべての要素に初期値が設定されます。

値の代入中カッコの中に値を指定することで、配列を宣言した後に値を代入できます。

integer li_Arr[]Li_Arr = {1, 2, 3, 4}

例例 1 次のステートメントでは、 3 つの初期値が設定された 1 次元の配列を宣言します。

real lr_Rate[3]={1.20, 2.40, 4.80}

例 2 次のステートメントでは、 2 次元配列を初期化します。 integer li_units[3,4] = {1,2,3, 1,2,3, 1,2,3, 1,2,3}

初期値は、以下のように設定されます。

Li_units[1.1]、 [1.2]、 [1.3]、 [1.4] は、すべて 1 になるLi_units[2.1]、 [2.2]、 [2.3]、 [2.4] は、すべて 2 になるLi_units[3,1]、 [3,2]、 [3,3]、 [3,4] は、すべて 3 になる

52 PowerBuilder

第 3 章宣言

例 3 次のステートメントでは、 3 次元配列の最初の半分の要素を初期化します。

integer li_units[3,4,2] = & {1,2,3, 1,2,3, 1,2,3, 1,2,3}

初期値は、以下のように設定されます。

Li_units[1,1,1]、 [1,2,1]、 [1,3,1]、 [1,4,1] は、すべて 1 になるLi_units[2.1,1]、 [2.2,1]、 [2.3,1]、 [2.4,1] は、すべて 2 になるLi_units[3.1,1]、 [3.2,1]、 [3.3,1]、 [3.4,1] は、すべて 3 になるLi_units[1,1,2]、 [1,2,2]、 [1,3,2]、 [1,4,2] は、すべて 0 になるLi_units[2,1,2]、 [2,2,2]、 [2,3,2]、 [2,4,2] は、すべて 0 になるLi_units[3,1,2]、 [3,2,2]、 [3,3,2]、 [3,4,2] は、すべて 0 になる

可変長配列のサイズ概要可変長配列には、変数名の後に、数値が指定されていない角カッコ

（［］）を記述します。 PowerBuilder は、実行時に用途に応じて配列のサイズを定義します。サイズの制約はメモリ容量だけです。可変長配列として宣言できるのは、 1 次元配列だけです。

可変長配列はサイズを宣言しないので、 TO 表記を使って配列のインデックスの下限を変更することはできません。したがって、可変長配列のインデックスの下限は常に 1 です。

EAServer コンポーネントでの TO 句付きの配列の使用PowerBuilder から配布される EAServer コンポーネントのプロキシを生成し、ここに TO 句を使用する配列を含む場合、 CORBA IDL では TO句がサポートされていないため、プロキシオブジェクトでは範囲が単一値として表わされます。たとえば、Int ar1[5 TO 10] は、Int ar1[6]として表わされ、このとき [6] は配列要素の数を表わします。クライアントアプリケーションは、範囲ではなく単一値を使用する配列を宣言することが必要です。

メモリの割り当て可変長配列の要素に初期値を設定すると、その要素にメモリが割り当てられます。初期値は、固定長配列の場合と同様、中カッコの中に値を指定します。次のステートメントは、 code[1] に 11、 code[2] に 242、code[3] に 27 を設定します。配列の要素数は、初期状態では 3 つですが、より大きいインデックス番号の要素に値を代入すると要素数は変更されます。

integer li_code[ ]={11,242,27}


配列の宣言

以下のステートメントでは、可変長配列を宣言し、 3 つの配列要素に値を代入します。

long ll_price[ ]ll_price[100] = 2000ll_price[50] = 3000ll_price[110] = 5000

これらのステートメントが最初に実行されるとき、次のようにメモリが割り当てられます。

• ll_price[100]=2000 のステートメントでは、 ll_price[1] からll_price[100] までの 100 個の Long 型の要素にメモリが割り当てられる。次に、 ll_price[1] から ll_price[99] の要素に Long 型のデフォルト値である 0 が代入され、 ll_price[100] に 2000 が代入される

• ll_price[50]=3000 のステートメントでは、新しくメモリが割り当てられることはなく、配列 ll_price の 50 番目の要素に 3000 が代入される

• ll_price[110]=5000 のステートメントでは、新たに ll_price[101]から ll_price[110] までの 10 個の Long 型の要素にメモリが割り当てられる。次に、ll_price[101] から ll_price[109] に Long 型のデフォルト値である 0 が代入され、 ll_price[110] に 5000 が代入される

配列についての詳細

この節では、以下について詳しく説明します。

• 配列を別の配列に代入する方法

• 配列に値を代入するための配列リストの使い方

• 配列を指定するときに発生するエラー

配列を別の配列に代入する方法

概要配列を別の配列に代入する場合、 PowerBuilder は、以下の規則に従って配列の要素を 1 つずつ対応させます。

1 次元配列可変長配列への代入代入先の配列と代入元の配列は、同じ配列になります。

integer a[ ], b[ ]a = {1,2,3,4}b = a

54 PowerBuilder

第 3 章宣言

固定長配列への代入代入元の配列のサイズが代入先の配列のサイズより小さい場合は、代入元の配列のすべての値が代入先の配列にコピーされます。代入先の配列で余っている要素には、 0 が設定されます。次の例では、 b[5] と b[6] に 0 が設定されます。

integer a[ ], b[6]a = {1,2,3,4}b = a

代入元の配列のサイズが代入先の配列のサイズより大きい場合は、代入元の配列から代入先の配列の要素分だけ値がコピーされ、代入元の配列で余っている値は無視されます。次の例では、配列 b に配列 a の最初の 3 つの要素だけがコピーされます。

integer a[ ], b[3]a = {1,2,3,4}b = a

多次元配列多次元配列では、次元順に値を保持するので、 [1,1]、 [2,1]、 [3,1] のように 1 次元目から順に値が設定されます。

多次元配列を別の配列に代入する場合、 PowerBuilder は、代入元の多次元配列を、要素が次元順に並んだ 1 次元配列とみなします。次にPowerBuilder は、前述の 1 次元配列の代入規則に従って、多次元配列を別の配列に代入します。

次に示すように、配列を代入できない場合もあります。

多次元配列から多次元配列への代入 2 つの配列の次元が一致する場合は、代入先の配列に代入元の配列が正確にコピーされます。

integer a[2,10], b[2,10]a = b

代入元の配列と代入先の配列が共に多次元配列でも、次元が一致しない場合は代入できません。このような場合は、コンパイル時にエラーが発生します。

integer a[2,10], b[4,10]

a = b // コンパイルエラー

1 次元配列から多次元配列への代入 1 次元配列を多次元配列に代入できます。値は多次元配列の次元順に対応付けされます。

integer a[ ], b[2,2]b = a

多次元配列から 1 次元配列への代入多次元配列を 1 次元配列に代入できます。代入元の配列は、配列要素が次元順に並んだ 1 次元配列とみなされて、代入先の配列に代入されます。

integer a[ ], b[2,2]a = b


配列の宣言

例 a、 b、 c の 3 つの配列を宣言します。配列 c は、 1 次元の可変長配列、配列 a と b は、次元が異なる多次元配列です。

integer c[ ], a[2,2], b[3,3] = {1,2,3,4,5,6,7,8,9}

配列 b の要素は、次のとおりです。

次のステートメントでは、配列 a と b の次元が異なるのでコンパイルエラーが発生します。

a = b // コンパイルエラー

次のステートメントでは、配列 b を 1 次元配列とみなして、配列 c に代入し、

c = b

1 次元配列とみなされた配列 a に、配列 c を代入します。

a = c

配列 a の要素は、次のとおりです。

配列リストを使って配列 a を初期化しても、同じ結果になります。

integer a[2,2] = {1,2,3,4}

次のセクションでは、配列リストについて説明します。

配列に値を代入するための配列リストの使い方

概要 PowerBuilder での配列リストとは、中カッコの中に指定した値のリストのことで、配列の初期化に使われます。配列リストは 1 次元配列として扱われ、 54 ページの「配列を別の配列に代入する方法」で前述したとおり、配列の代入規則に従って代入先の配列に値が代入されます。

1 for b[1,1] 4 for b[1,2] 7 for b[1,3]

2 for b[2,1] 5 for b[2,2] 8 for b[2,3]

3 for b[3,1] 6 for b[3,2] 9 for b[3,3]

1 for a[1,1] 3 for a[1,2]

2 for a[2,1] 4 for a[2,2]

56 PowerBuilder

第 3 章宣言

例次の宣言では、可変長配列に 4 つの初期値を設定します。

integer a[ ] = {1,2,3,4}

次の宣言では、固定長配列に 4 つの初期値を設定します。残りの配列要素の値は 0 に設定されます。

integer a[10] = {1,2,3,4}

次の宣言では、固定長配列に 4 つの初期値を設定します。配列のサイズが 4 に設定されているので、配列リストの残りの値は無視されます。

integer a[4] = {1,2,3,4,5,6,7,8}

次の宣言では、1 次元目に 1、2、3、2 次元目に残りの値が設定されます。

integer a[3,2] = {1,2,3,4,5,6}

3 次元配列を行と列を持つページとみなすと、次の宣言では、 1 ページ目の 1 列目に 1 と 2、 2 列目に 3 と 4 がそれぞれ設定され、 2 ページ目の 1 列目に 5 と 6 が設定されます。

2 ページ目の 2 列目には、 0 が設定されます。

integer a[2,2,2] = {1,2,3,4,5,6}

配列を指定するときに発生するエラー

固定長配列 PowerBuilder では、宣言時に指定したサイズを超える配列要素を参照しようとすると、実行時にエラーが発生します。次に例を示します。

int test[10]

test[11]=50 // 実行時エラーが発生します。test[0]=50 // 実行時エラーが発生します。int trial[5,10]

trial [6,2]=75 // 実行時エラーが発生します。trial [4,11]=75 // 実行時エラーが発生します。

1 4

2 5

3 6

1 3 5 0

2 4 6 0


外部関数の宣言

可変長配列可変長配列の場合、現行のサイズより大きな配列要素に値を代入するとサイズが拡張されます。ただし、最大サイズを超えるまたは最小サイズを下回る要素を参照しようとすると、実行時にエラーが発生します。

integer li_stock[ ]li_stock[50]=200

// 配列に 50 個の要素を設定します。IF li_stock[51]=0 then Beep(1)

// 実行時エラーが発生します。IF li_stock[0]=0 then Beep(1)

// 実行時エラーが発生します。

外部関数の宣言説明外部関数は、 PowerScript 以外の言語で記述された関数で、ダイナミッ

クリンクライブラリに格納されています。 Windows では、動的ライブラリには DLL の拡張子が付きます。 PowerBuilder で作成されたコンポーネントを UNIX サーバに配布する場合、呼び出される動的ライブラリには、その UNIX オペレーティングシステムによって .so、 .sl、または .a の拡張子が付きます。外部関数は、動的ライブラリをサポートする言語であれば、どのような言語で記述されていても使用できます。

スクリプトで外部関数を使用するには、まず、その関数を次のいずれかの関数として宣言しなければなりません。

• グローバル外部関数アプリケーション内のどこからでも使用できます。

• ローカル外部関数特定の種類のウィンドウ、メニュー、ユーザオブジェクト、またはユーザ定義関数に定義されます。これらの関数はオブジェクト定義の一部なので、オブジェクト自身のスクリプトで常に使用できます。また、これらの関数をほかのスクリプトで使用できるようにすることも可能です。

外部関数の宣言方法と呼び出し方法を理解するには、外部関数ライブラリの開発者から提供されるマニュアルを参照してください。

構文外部関数の構文外部関数を宣言するには、次の構文を使います。

{ access } FUNCTION returndatatype name ( { { REF } datatype1 arg1,..., { REF } datatypen argn } ) LIBRARY "libname"ALIAS FOR "extname"

58 PowerBuilder

第 3 章宣言

外部サブルーチンの構文また、次の構文を使って、外部サブルーチンを宣言できます。外部サブルーチンは、外部関数と同じですが、値を戻しません。

{ access } SUBROUTINE name ( { { REF } datatype1 arg1, ...,{ REF } datatypen argn } ) LIBRARY "libname"ALIAS FOR "extname"

次の表に、外部関数とサブルーチンを宣言するときに使用するパラメータを示します。



表 3-7: 外部関数またはサブルーチンを宣言するためのパラメータ

解説ローカル関数のアクセスレベルの指定ローカル外部関数を宣言するとき、アクセスレベルを指定します。つまり、その関数にアクセスできるスクリプトの範囲を指定できます。

次の表に、ローカル外部関数をアクセスレベル付きで宣言した場合に、そのローカル外部関数を使用できるスクリプトの範囲を示します。


access（オプション）

ローカル外部関数の場合のみ。ローカル外部関数のアクセスレベルとして Public、 Protected、または Private のいずれかを指定します。デフォルトは Public です。詳細については、次の「解説」の「ローカル関数のアクセスレベルの指定」を参照してください。

FUNCTION または SUBROUTINE

呼び出しの種類を指定するキーワード。このキーワードによって、戻り値の取り扱い方法が決定されます。戻り値がある場合は FUNCTION を指定し、戻り値がないまたは VOID を戻す場合は SUBROUTINE を指定します。

returndatatype 関数の戻り値のデータ型。

name DLL に保存されている関数またはサブルーチンの名前。 REF REF の後の引数が参照渡しであることを指定するキー

ワード。関数は arg に値を格納できます。この値には、PowerBuilder のほかのスクリプトからアクセスできます。

datatype arg 関数またはサブルーチンの引数のデータ型と名前。引数リストは、DLL 内の関数定義と一致していなければなりません。各 datatype arg の前に REF を指定できます。

引数の受け渡しについての詳細は、『アプリケーションテクニック』マニュアルを参照してください。

LIBRARY "libname" キーワードの後の libname に、関数またはサブルーチンが格納されている DLL の名前を指定します。 Windowsの DLL の拡張子は、通常、 DLL です。 UNIX 上のEAServer に配布されるコンポーネントの場合、ファイルの拡張子はそのオペレーティングシステムによって.so、 .sl、または .a になります。

ALIAS FOR "extname" （オプション）

キーワード。 extname には、動的ライブラリで定義されている関数名を指定します。動的ライブラリで定義されている名前と異なる名前をスクリプトで使う場合、またはデータベース内の名前が PowerScript で使う名前としては不適切な場合は、 ALIAS FOR "extname" を指定し、PowerScript 名と外部名を関連付けなければなりません。

60 PowerBuilder

第 3 章宣言

表 3-8: ローカル外部関数のアクセスレベル

ローカル外部関数の access キーワードによるアクセスレベルは、インスタンス変数の access-right キーワードの場合と同じです。

実行時における動的ライブラリの使用

Windows プラットフォームで PowerBuilder アプリケーションを実行するには、以下のディレクトリのいずれかに DLL が存在しなければなりません。

• 現行ディレクトリ

• Windows ディレクトリ

• Windows の System サブディレクトリ

• DOS パスにあるディレクトリ

PowerBuilder カスタムクラスユーザオブジェクトを EAServer コンポーネントとして配布する場合、参照する動的ライブラリはすべてサーバ上で使用できる状態にあることが必要です。宣言時にライブラリのロケーションを指定しない場合、ライブラリが、アクセス可能なロケーションにインストールされていることを確認してください。

• Windows サーバ上では、 DLL はサーバの実行可能ファイルのアプリケーションパス上にあることが必要です。

• UNIX サーバ上では、共有ライブラリのロケーションがサーバのライブラリパス環境変数（たとえば、 Solaris 上では LD_LIBRARY_PATH）にリストされているか、または、ライブラリが EAServer インストールの lib ディレクトリ内にあることが必要です。

例 PowerBuilder 付属のアプリケーション examples では、以下のような外部関数が、ユーザオブジェクト u_external_function_win32 にローカル外部関数として宣言されています。ユーザオブジェクト関数で外部関数を呼び出しますが、ユーザオブジェクト関数は同じユーザオブジェクトの定義の一部なので、関数を呼び出すときに、ユーザオブジェクト名を表記する必要はありません。

アクセスレベルローカル外部関数を使用できるスクリプト

Public アプリケーション内のすべてのスクリプト

Private 関数が宣言されているオブジェクトのイベントのスクリプト。そのオブジェクトの子孫スクリプトでは使用できません。

Protected 関数が宣言されているオブジェクトのスクリプトとその子孫スクリプト。



例 1 次の宣言では、 PowerBuilder は WINMM.DLL 内のサウンドを再生するのに必要な関数を呼び出します。

// サウンドを再生します。FUNCTION boolean sndPlaySoundA (string SoundName,

uint Flags) LIBRARY "WINMM.DLL"FUNCTION uint waveOutGetNumDevs () LIBRARY "WINMM.DLL"

examples アプリケーション内の関数 uf_playsound が外部関数を呼び出します。関数 uf_playsound は、引数 as_filename と ai_option で呼び出され、これらの引数を外部関数 sndPlaySoundA に渡します。 ai_option の値は、以下に示すように、 Windows のマニュアルでの定義と同じです。

// mmystem.h で定義されるオプション。// これらの値は OR 演算して使用してもかまいません。// #define SND_SYNC 0x0000

// 同期的に再生します（デフォルト）。// #define SND_ASYNC 0x0001

// 非同期的に再生します。// #define SND_NODEFAULT 0x0002

// デフォルトのサウンドを使用しません。// #define SND_MEMORY 0x0004

// lpszSoundName はメモリファイルをポイントします。// #define SND_LOOP 0x0008

// 次の sndPlaySound までサウンドを繰り返します。// #define SND_NOSTOP 0x0010

// 現在再生中のサウンドを止めません。

uint lui_numdevs

lui_numdevs = WaveOutGetNumDevs() IF lui_numdevs > 0 THEN

sndPlaySoundA(as_filename,ai_option)RETURN 1

ELSERETURN -1

END IF

例 2 次は、 Windows の GetSysColor 関数の宣言です。

FUNCTION ulong GetSysColor (int index) LIBRARY "USER32.DLL"

次のステートメントでは、外部関数を呼び出します。引数 index と戻り値については、 Windows のマニュアルに記述されています。

RETURN GetSysColor (ai_index)

62 PowerBuilder

第 3 章宣言

例 3 次は、 Windows の GetSysColor 関数の宣言です。

FUNCTION int GetSystemMetrics (int index) LIBRARY "USER32.DLL"

以下のステートメントでは、外部関数を呼び出し、画面の高さと幅を取得します。

RETURN GetSystemMetrics(1)RETURN GetSystemMetrics(0)

外部関数の引数のデータ型

PowerBuilder では、外部関数を宣言する場合、引数のデータ型は、外部関数の定義で宣言されているデータ型と一致しなければなりません。この節では、外部関数のデータ型と PowerBuilder のデータ型の対応について説明します。また、構造体を値渡しするときのバイトアラインメントについても説明します。

表から、外部関数の宣言で使用する PowerBuilder のデータ型を探します。 PowerBuilder のどのデータ型を使用するかは、外部関数のソースコードでのデータ型によって異なります。最初の項目には、外部関数のソースコードでのデータ型、 2 番目の項目には、データ型についての詳しい説明、 3 番目の項目には、外部関数の宣言で使用するPowerBuilder のデータ型を示します。

Boolean Windows 上における BOOL 型は 16-bit の符号付きです。 PowerBuilder では、 Boolean 型として宣言します。

ポインタ表 3-9: PowerBuilder のポインタのデータ型

Windows ポインタ LPBYTE、 LPDWORD、 LPINT、 LPLONG、 LPVOID、LPWORD など 32-bit の FAR ポインタは、PowerBuilder では Long データ型として宣言します。 HANDLE 型は 32 bit の符号なしとして定義され、PowerBuilder では UnsignedLong 型として宣言します。

PSTR や NPSTR といった Near ポインタデータ型は、PowerBuilder ではサポートされていません。

ソースコードのデータ型サイズ，符号，精度 PowerBuilder のデータ型

* （任意のポインタ） 32-bit のポインタ Longchar * 可変長のバイト配列 Blob



文字と文字列表 3-10: PowerBuilder の文字と文字列のデータ型

Windows における 32-bit の FAR ポインタ LPSTR 型は、PowerBuilder では String 型として宣言します。

参照引数参照により文字列を外部関数として渡す場合、すべてのメモリ管理がPowerBuilder で行われます。 String 型文字列は、戻り値を保持できるだけの長さがあることが必要です。必要な長さがあるかどうかを確認するには、まず String 型変数を宣言し、次に Space 関数を使って、関数の予想される戻り値の最大文字数分の空白を変数に埋め込みます。

固定小数点の値表 3-11: PowerBuilder の固定小数点数値のデータ型

Windows 定義の WORD 型は、PowerBuilder では UnsignedInteger、DWORD型は UnsignedLong として宣言されます。 Short 型の戻り値や引数がある外部関数を呼び出すことはできません。

浮動小数点の値表 3-12: PowerBuilder の浮動小数点数値のデータ型

PowerBuilder では、 Windows の 80-bit の Double 型をサポートしていません。

ソースコードのデータ型サイズ，符号，精度

PowerBuilder のデータ型

char 8-bit の符号付き Char 型string ヌルで終わる可変長の

バイト配列への 32-bitポインタ

String 型



short 16-bit の符号付き Integer

unsigned short 16-bit の符号なし UnsignedInteger int 32-bit の符号付き Long

unsigned int 32-bit の符号なし UnsignedLong

long 32-bit の符号付き Long

unsigned long 32-bit の符号なし UnsignedLong

longlong 64-bit の符号付き LongLong



float 32-bit の単精度 Real

double 64-bit の倍精度 Double

64 PowerBuilder

第 3 章宣言

Date 型と Time 型 PowerBuilder の Date 型、 DateTime 型、 Time 型は構造体で、 C 言語で記述された外部関数に直接対応するものはありません。

構造体の値渡し C 言語で記述された外部関数の定義とアラインメントが PowerBuilderの構造体のコンポーネントと同じであれば、構造体をその外部関数に渡すことができます。 DLL や共有ライブラリは、バイトアラインメントを指定してコンパイルしなければなりません。つまり、パディングを行わずに構造体内のフィールドを配置するということです。

外部関数の呼び出しグローバル外部関数 PowerBuilder では、グローバル外部関数の呼び出しには、ユーザ定義

グローバル関数やシステム関数を呼び出す場合と同じ構文を使います。そのほかのグローバル関数と同様、グローバル外部関数をトリガまたはポストすることはできますが、動的に呼び出すことはできません。

ローカル外部関数オブジェクト関数の呼び出しには、ローカル外部関数を呼び出す場合と同じ構文を使います。ローカル外部関数をトリガまたはポストしたり、動的に呼び出すことができます。

詳細については詳細については、 113 ページの「 PowerBuilder の関数とイベントの呼び出し構文」を参照してください。

外部変数の定義

32-bit プラットフォームのシーケンスの標準呼び出しをサポートする言語であれば、どの言語で記述された外部関数でも使用できます。Windows 上のライブラリで独自に作成した関数を呼び出す場合、その関数のエクスポートが必要になります。コンパイラによっては、関数のプロトタイプまたはリンカ定義（.DEF）ファイル内でエクスポートできます。外部関数の使い方についての詳細は、『アプリケーションテクニック』マニュアルを参照してください。



リモートプロシージャコールとしての DBMS ストアドプロシージャの宣言説明 PowerBuilder では、次のようにドット表記を使って、結果集合のない

ストアドプロシージャをリモートプロシージャコール（RPC）として呼び出すことができます。

object.function

Sybase、 Oracle、 Informix、そのほかストアドプロシージャをサポートする ODBC データベースのデータベースプロシージャを呼び出すことができます。

RPC は、 Oracle の PL/SQL 表や入力と出力の両方として定義されたパラメータをサポートします。オーバーロードされたプロシージャを呼び出すこともできます。

対象トランザクションオブジェクト

構文 FUNCTION rtndatatype functionname ( { { REF } datatype1 arg1,...,{ REF } datatypen argn } ) RPCFUNC { ALIAS FOR "spname" }

SUBROUTINE functionname ( { { REF } datatype1 arg1 , ..., { REF } datatypen argn } ) RPCFUNC { ALIAS FOR "spname" }

66 PowerBuilder

第 3 章宣言

表 3-13: RPC を宣言するためのパラメータ

解説たとえば、 Void を戻す場合など、関数が値を戻さない場合は、関数ではなくサブルーチンとして宣言します。

RPC 宣言は、常にトランザクションオブジェクトに関連付けられます。これらをローカル外部関数として宣言します。接続しているデータベースがストアドプロシージャをサポートしていれば、ローカル外部関数の宣言ビューで、データベース内のストアドプロシージャの一覧にアクセスできます。

引数説明

FUNCTION または SUBROUTINE

呼び出しの種類を指定するキーワード。このキーワードによって、戻り値の取り扱い方法が決定されます。戻り値がある場合は FUNCTION を指定し、戻り値がないまたは VOID を戻す場合は SUBROUTINE を指定します。

rtndatatype FUNCTION で宣言した場合、関数の戻り値のデータ型。

functionname PowerBuilder で呼び出すデータベースプロシージャの名前。 DBMS での名前と異なる名前を使う場合は、ALIASFOR を指定し、DBMS 名と PowerBuilder 名を関連付けなければなりません。

REF REF の後の引数が参照渡しであることを指定します。ストアドプロシージャは arg に値を格納できる。この値には、 PowerBuilder のほかのスクリプトからアクセスできます。

参照により文字列を渡す場合、すべてのメモリ管理がPowerBuilder で行われます。 String 型文字列は、戻り値を保持できるだけの長さがあることが必要です。必要な長さがあるかどうかを確認するには、まず String 型変数を宣言し、次に Space 関数を使って、関数の予想される戻り値の最大文字数分の空白を変数に埋め込みます。

datatype arg ストアドプロシージャの引数のデータ型と名前。引数リストは、データベース内のストアドプロシージャ定義と一致していなければなりません。各 datatype arg の前にREF を指定できます。

RPCFUNC キーワード。この宣言は、 DLL の外部関数ではなく、DBMS のストアドプロシージャであることを示します。外部関数の宣言についての詳細は、58 ページの「外部関数の宣言」を参照してください。

ALIAS FOR "spname" （オプション）

キーワード。spname にはデータベース内のプロシージャの名前を指定します。データベース内の名前と異なる名前をスクリプトで使う場合、またはデータベース内の名前が PowerScript で使うには不適切な場合は、ALIAS FOR"spname" を指定し、PowerScript 名とデータベース名を関連付けなければなりません。



詳細については、『アプリケーションテクニック』マニュアルを参照してください。

例例 1 次は、ストアドプロシージャ GIVE_RAISE_PROC の宣言です。この宣言は、ユーザオブジェクトペインタで、トランザクションオブジェクトに対して行っています。宣言の内容は 1 行で表示されます。

FUNCTION double GIVE_RAISE(ref double SALARY) RPCFUNC ALIAS FOR "GIVE_RAISE_PROC"

次のスクリプトでは、関数を呼び出します。

double val = 20000double rvrv = SQLCA.give_raise(val)

例 2 次のストアドプロシージャ SPM8 の宣言では、スクリプトで使用する名前と DBMS 名が同じなので、ALIAS FOR 句は必要ありません。

FUNCTION integer SPM8(integer value) RPCFUNC

次のスクリプトでは、ストアドプロシージャ SPM8 を呼び出します。

int myresultmyresult = SQLCA.spm8(myresult)IF SQLCA.sqlcode <> 0 THEN

messagebox(" エラー ", SQLCA.sqlerrtext)END IF

68 PowerBuilder

第 4 章演算子と式

この章についてこの章では、 PowerScript がサポートしている演算子、および式における演算子の使用方法について説明します。

内容

演算子概要演算子は、算術演算、数値、テキストおよび論理値の比較、論理

値に対する論理演算、さらに文字列や Blob 値の連結に用います。

3 種類の演算子 PowerScript では、以下の 3 種類の演算子をサポートしています。

• 算術演算子 : 数値型のデータに使用できる

• 関係演算子 : すべてのデータ型のデータに使用できる

• 連結演算子 : String 型のデータに使用できる

データウィンドウオブジェクトで使用する演算子データウィンドウ式の演算子の使用法については、データウィンドウに関するマニュアルを参照してください。

算術演算子説明次に PowerBuilder 算術演算子を示します。

項目ページ

演算子 69

演算子の優先順位 74

PowerBuilder 式のデータ型 75


演算子

表 4-1: 算術演算子

解説後置式演算式算術演算子と代入式を連結する後置式演算子（++、+= など）についての詳細は、 124 ページの「値の代入文」を参照してください。

減算オプションダイアログボックスの［スクリプト］タブの［識別子にハイフンを表示］がチェックされている場合、減算演算子および-- 演算子の前後には必ずスペースを入れなければなりません。それ以外の場合は、 PowerBuilder はその式を識別子として解釈します。

識別子におけるハイフンについての詳細は、 5 ページの「識別子の命名」を参照してください。

乗除乗算と除算は最大精度（最大有効桁数 16 ～ 18 桁）を確保して実行されます。 Decimal 型の数値は、代入時にその有効桁数に応じて、切り捨てではなく四捨五入されます。

NULL 値を含む計算算術式に NULL 値が含まれている場合、計算結果は NULL 値になります。これは、 NULL を未定義の値と考えれば容易に理解できます。

NULL 値についての詳細は、9 ページの「 NULL 値」を参照してください。

エラーとオーバーフロー算術演算子を使用するときは、以下の問題に注意する必要があります。

• 0 の除算、負の値の累乗などを行うと、実行時にエラーが発生します。

• Real 型、 Double 型、および Decimal 型の値がオーバーフローすると、実行時にエラーが発生します。

• 符号付き、または符号なしの Integer 型および Long 型の値がオーバーフローした場合は、結果がまるめられます。ただし、計算の過程で Integer 型のオペランドが Long 型に昇格する場合は、Integer型の変数に結果が代入されるまで、まるめは発生しません。

演算子意味使用例

+ 加算 Total=SubTotal+Tax

- 減算 Price=Price-iscount

識別子名にハイフンが使用できる場合は、減算演算子の前後にスペースを入れる必要があります。

* 乗算 Total=Quantity*Price

/ 除算 Factor=Discount/Price

^ 累乗 Rank=Rating^2.5

70 PowerBuilder


データ型の昇格についての詳細は、 75 ページの「 PowerBuilder 式のデータ型」を参照してください。

例減算次のステートメントは、常に A から B を減算するという意味です。

A - B

DashesInIdentifiers が 1 に設定されている場合、次のステートメントはA-B という名前の変数を意味します。 DashesInIdentifiers が 0 に設定されている場合は、 A から B を減算するという意味になります。

A-B

除算の精度以下の例は、 Decimal 型の値をさまざまな演算子で処理しています。

decimal {4} a,b,d,e,fdecimal {3} c

a = 20.0/3 // a の値は 6.6667b = 3 * a // b の値は 20.0001c = 3 * a // c の値は 20.000d = 3 * (20.0/3) // d の値は 20.0000e = Truncate(20.0/3, 4) // e の値は 6.6666f = Truncate(20.0/3, 5) // f の値は 6.6667

NULL 値の連結以下の代入文で変数 c の値が NULL の場合、変数 a の値はすべて NULL になります。

integer a, b=100, c

SetNULL(c)

a = b+c // すべての代入文で a の値が NULL になります。a = b - ca = b*ca = b/c

オーバーフロー以下の例は、オーバーフローが起きた後の変数 i の値を示しています。

integer ii = 32767

i = i + 1 // i の値は -32768 になります。


演算子

関係演算子説明 PowerBuilder では、論理式で関係演算子を使って 2 つ以上のオペラン

ドを評価します。関係式を論理演算子で接続して、より複雑な論理式を作成することもできます。

論理式を評価した結果は、常に TRUE か FALSE です。

次の表に、関係演算子と論理演算子を示します。

表 4-2: PowerBuilder の関係演算子と論理演算子

解説文字列の比較 PowerBuilder では、文字列を比較するときに大文字と小文字が区別されます。また、末尾部分の空白も区別されます。

大文字と小文字を区別しない文字列の比較方法についての詳細は、1350 ページの「 Upper」および 835 ページの「 Lower」を参照してください。

末尾部分の空白を削除するには、 RightTrim 関数を使います。先頭部分の空白を削除するには、 LeftTrim 関数を使います。先頭と末尾部分の空白を削除するには、 Trim 関数を使います。これらの関数の詳細については、1085 ページの「 RightTrim」、801 ページの「 LeftTrim」、1335 ページの「 Trim」を参照してください。

NULL 値の評価 NULL 値を含んだ論理式を作成すると、 AND 演算子とOR 演算子は、通常とは異なる結果を返します。 NULL を TRUE でもFALSE でもない未定義の値と考えれば容易に理解できます。

NULL 値についての詳細は、9 ページの「 NULL 値」を参照してください。

例大文字と小文字の比較テキストは同じでも大文字と小文字が異なる 2つの文字列を比較すると、これらは同じとみなされません。ただし、Upper 関数や Lower 関数を使うと、両方の文字列の大文字と小文字は区別されないため、文字の並びだけで比較できます。


= 等しい if Price=100 then Rate=.05 > より大きい if Price>100 then Rate=.05 < より小さい if Price<100 then Rate=.05

<> 等しくない if Price<>100 then Rate=.05 >= 大きいまたは等しい if Price>=100 then Rate=.05 <= 小さいまたは等しい if Price<=100 then Rate=.05 NOT 論理否定 if NOT Price=100 then Rate=.05

AND 論理積 if Tax>3 AND Ship <5 then

Rate=.05

OR 論理和 if Tax>3 OR Ship<5 then Rate=.05

72 PowerBuilder


City1 = "Austin"City2 = "AUSTIN"

IF City1 = City2 ... // FALSE を返します。

City1 = "Austin"City2 = "AUSTIN"

IF Upper(City1) = Upper(City2)... // TRUE を返します。

比較対象文字列の末尾部分の空白次の例では、一方の文字列の末尾部分に空白があるため、 2 つの文字列は同じとみなされません。

City1 = "Austin"City2 = "Austin "

IF City1 = City2 ... // FALSE を返します。

NULL 値が含まれる論理式次の例では、変数 f が NULL に設定されているため、式には NULL 値が含まれます。

boolean d, e = TRUE, fSetNull(f)

d = e and f // d の値は NULLd = e or f // d の値は TRUE

連結演算子説明 PowerBuilder では、連結演算子は、同じデータ型の 2 つの変数を連結

します。 String 型と Blob 型の変数を連結できます。

次の表に、連結演算子を示します。

表 4-3: PowerBuilder の連結演算子

例例 1 以下の例は、複数の文字列を連結します。 string Test

Test = "over" + "stock" // Test の値は "overstock" となります。string Lname, Fname, FullNameFullName = Lname + ', ' + Fname

// FullName の値は、姓と名をカンマとスペースで区切った // 文字列となります。


+ 連結 "cat " + "dog"


演算子の優先順位

例 2 以下の例は、データをファイルから読み込んで、 Blob 型の変数に Blob 値を次々と連結します。

integer i, fnum, loopsbflob tot_b, b. . .FOR i = 1 to loops bytes_read = FileRead(fnum, b) tot_b = tot_b + bNEXT

演算子の優先順位優先順位 PowerBuilder の式で用いる演算子は、一定の優先順位に基づいて評価

されます。優先順位が同じ演算子については、左から右に評価されます。

次に、演算子を優先順位の高い順に示します。

表 4-4: 演算子の優先順位

順序の変更方法式を評価する順序を変更するには、カッコを使用します。PowerBuilderは、まず、カッコ内のグループを評価します。カッコがネストされている場合は、内側のグループから外側のグループへと評価していきます。

たとえば、 (x+(y*(a+b))) の式は、まず、 a+b が評価され、次に、その和に y が乗算され、最後に、その積に x が加算されます。

演算子用途

( ) グループ化（下記の「式のグループ化」を参照）

+, - 単項加減（正の数と負の数を表す）

^ 累乗

*, / 乗除

+, - 加減、文字列連結

=, >, <, <=, >=, <> 関係演算子

NOT 論理否定

AND 論理積

OR 論理和

74 PowerBuilder


PowerBuilder 式のデータ型概要関数やイベントの引数に式を渡すとき、式のデータ型は重要です。式

のデータ型は、引数の定義と互換性がなければなりません。関数が多重定義されている場合は、引数のデータ型がどの関数を呼び出すかを決定します。

数値データ型、 String データ型、 Char データ型の 3 種類のデータ型があります。

数値データ型概要数値データ型は、互いに互換性があります。

PowerBuilder での処理

PowerBuilder は、計算や代入を行うとき、必要に応じてデータ型を変換します。数値式のオペランドのデータ型は、演算子とほかのオペランドのデータ型によって、より高い優先順位のデータ型に変換されます。

数値式の評価時におけるデータ型の昇格

優先順位次に、PowerBuilder の数値データ型を優先順位の高い順に示します。優先順位は、各データ型の値の範囲に基づいています。

DoubleRealDecimalLongLongUnsignedLongLongUnsignedIntegerInteger

データ型の昇格規則オペランドのデータ型式のオペランドが異なるデータ型の場合は、優先順位の低いデータ型のオペランドが、優先順位の高いデータ型に変換されます。

符号なしと符号付き符号なしのデータ型は、符号付きのデータ型より優先順位が高いです。符号なしのデータ型のオペランドと符号付きのデータ型のオペランドがある場合は、両方のオペランドのデータ型が優先順位の高い符号なしのデータ型に変換されます。たとえば、 Long型のオペランドと UnsignedInteger 型のオペランドの場合は、両方のオペランドのデータ型が、 UnsignedLong 型に変換されます。


PowerBuilder 式のデータ型

演算子演算子は、式のデータ型に対して以下のように影響します。

• +、 -、 * 加算、減算、乗算では、 Long 型のオペランドに対する演算結果は、最低限の精度が得られます。計算を行う前に、 Integer 型のオペランドは Long 型へ変換され、式の結果のデータ型は Long 型になります。オペランドのデータ型が Long 型より高い優先順位である場合、ほかのオペランドのデータ型はオペランドのデータ型の規則に基づいて同じデータ型に変換されます。

• / と ^ 除算と累乗では、 Double 型のオペランドに対する演算結果は、最低限の精度が得られます。すべてのオペランドのデ－タ型はDouble 型に変換され、式の結果のデータ型は Double 型になります。

• 関係演算子関係演算子は、数値データ型に対するデータ型の変換は発生しません。

リテラルのデータ型式のオペランドがリテラルの場合、リテラルのデータ型はリテラルの値によって決まります。リテラルのデータ型は、リテラルとほかのオペランドのデータ型の昇格に影響します。

表 4-5: 式内のリテラルオペランドのデータ型

範囲外LongLong 型の範囲を超える整数のリテラルは、コンパイルエラーになります。

代入とデータ型

概要代入は、式を評価しません。代入文では、式の結果のデータ型が、左辺の変数のデータ型に変換されます。

c = a + b

式 a+b のデータ型は、変数 a と b のデータ型によって決定されます。そして、式の結果のデータ型は、変数 c のデータ型に変換されます。

リテラルデータ型

Long 型の範囲内にある小数点も累乗指数もない整数 Long

Long 型の範囲を超える整数（ただし UnsignedLong の範囲内）

UnsignedLong

UnsignedLong 型の範囲を超える整数（ただし LongLong の範囲内）

UnsignedLong

小数点のある（ただし累乗指数のない）数値 Decimal

小数点と累乗指数がある数値 Double

76 PowerBuilder


代入時のオーバーフロー

PowerBuilder は、計算結果が正確に算出できるようにデータ型の変換を行います。しかし、精度の低いデータ型の変数に式の結果を代入すれば、オーバーフローする可能性があります。

例 1 以下の例をみてください。

integer a = 32000, b = 1000long dd = a + b

d の最終的な値は、 33000 です。この例では、以下のように計算されます。

Integer 型の変数 a を Long 型に変換しますInteger 型の変数 b を Long 型に変換しますLong 型の変数、 a と b を加算します結果を Long 型の変数 d に代入します。

変数 d は Long 型なので、値 33000 を代入してもオーバーフローしません。

例 2 以下の例では、 Integer 型の変数に式の結果を代入します。

integer a = 32000, b = 1000, clong ec = a + be = c

c と e の値は、 -32536 になります。以下のように計算されます。

Integer 型の変数 a を Long 型に変換しますInteger 型の変数 b を Long 型に変換しますLong 型の変数、 a と b を加算しますLong 型の結果を Integer 型に変換して、変数 c に代入しますInteger 型の変数 c を Long 型に変換して、変数 e に代入します

変数 c への代入は、 Long 型の結果が切り捨てられるため、オーバーフローとまるめが発生します。変数 c を変数 e に代入しても、失った情報は復元できません。

String 型と Char 型の間の変換概要明示的な Char 型のリテラルはありません。

以下の規則にしたがって、String 型リテラルは Char 型に変換されます。

• String 型リテラルを Char 型の変数に代入すると、String 型リテラルの先頭の文字だけが変数に代入される。次に例を示します。

char c = "xyz"


PowerBuilder 式のデータ型

この例では、文字 x が Char 型の変数 c に代入される

• 特殊文字（改行、用紙送り、 8 進、 16 進など）は、次のように文字列変換を用いて、 Char 型変数に代入できる

char c = "~n"

さらに、 String 型の変数を Char 型の変数に代入する場合も、同じ規則に従って変換されます。 Char 型の変数を String 型の変数に代入すると1 文字の文字列になります。

String 型の Char 型配列への代入

文字列の代入には、ほかのデータ型と同じように Char 型の配列を使用できます。以下の規則にしたがって、文字列が Char 型の配列に代入されます。

• 可変長の Char 型配列の場合は、文字列の内容がそのまま Char 型の配列の要素としてコピーされる

• 固定長の Char 型配列のサイズが文字列のサイズより小さいか等しい場合は、文字列は切り詰められて Char 型の配列に代入される

• 固定長の Char 型配列のサイズが文字列のサイズより大きい場合は、末尾に 0 を付けて Char 型の配列に代入される。配列の中の残りの文字は未決定である

Char 型配列の String 型への代入

Char 型の配列を String 型の変数に代入すると、配列の内容は文字列の末尾を示す 0 （存在する場合）までコピーされます。

式における String 型と Char 型配列の使い方

String 型と Char 型の配列の両方を使用する式は、 Char 型の配列がString 型に変換された後で評価されます。例は次のとおりです。この例では、 Char 型の変数 c の内容を String 型に昇格してから文字列「x」と比較します。

char c. . .if (c = "x") then

PowerScript 関数における Char 型の使い方

String 型の引数がある PowerScript 関数に Char 型または Char 型配列を渡すと、前述の変換規則にしたがって、データ型が変換されます。

78 PowerBuilder

第 5 章構造体とオブジェクト

この章についてこの章では、構造体とオブジェクトの基本的なコンセプトと、PowerScript におけるオブジェクトと構造体の定義方法、宣言方法、使用方法について解説します。

内容

構造体について概要構造体は、 1 つ以上の変数（要素とも呼ばれます）を 1 つの名前の

もとにグループ化した集合体です。変数は、標準データ型、オブジェクトデータ型、ほかの構造体など、どんなデータ型でも定義できます。

構造体の定義構造体ペインタやオブジェクトペインタ（ウィンドウ、メニュー、ユーザオブジェクトなど）で構造体を定義するということは、構造体の定義を作成するということです。構造体を使用するためには、構造体を宣言しなければなりません。構造体を宣言すると、構造体のインスタンスが自動的に生成されます。構造体がスコープから外れると、そのインスタンスが破棄されます。

構造体の定義についての詳細は、『PowerBuilder ユーザーズガイド』マニュアルを参照してください。

構造体の宣言構造体ペインタでグローバル構造体 str_emp_data を定義した場合、スクリプトやオブジェクトのインスタンス変数で構造体のインスタンスを宣言します。オブジェクトペインタで構造体を定義した場合は、そのオブジェクトのインスタンス変数とスクリプトだけが、その構造体のインスタンスを宣言できます。

以下の宣言は、構造体 str_emp_data のインスタンスを 2 つ宣言します。

str_emp_data str_emp1, str_emp2

項目ページ

構造体について 79

オブジェクトについて 80

オブジェクトと構造体の代入 87


オブジェクトについて

構造体変数への参照スクリプトでは、ドット（.）表記を使用して、構造体の変数を参照します。

structurename.variable

以下のステートメントでは、構造体 str_emp_data の変数に値を代入します。

str_emp1.emp_id = 100str_emp1.emp_lname = "Jones"str_emp1.emp_salary = 200

str_emp2.emp_id = 101str_emp2.emp_salary = str_emp1.salary * 1.05

インスタンス変数としての構造体

構造体がオブジェクトの定義の一部として宣言されている場合は、ドット（.）表記を使用して、構造体名を修飾できます。

objectname.structurename.variable

以下の宣言は、ウィンドウ w_customer のインスタンス変数とします。

str_cust_data str_cust1

ウィンドウ w_customer のスクリプトにおける以下のステートメントは、構造体 str_cust_data の変数を参照します。構造体の宣言がウィンドウ w_customer の定義の一部なので、代名詞 This は任意です。

This.str_cust1.name

オブジェクトについてオブジェクトとはオブジェクト指向プログラミングでは、オブジェクトは、データとそ

のデータを操作するメソッドを保持している独立したモジュールです。 PowerBuilder のほとんどのエンティティは、オブジェクトです。PowerBuilder のオブジェクトには、ウィンドウやウィンドウのコントロールなどのビジュアルオブジェクト、 Transaction や Error などの非ビジュアルオブジェクト、開発者が作成するユーザオブジェクトがあります。

80 PowerBuilder


オブジェクトクラスは、オブジェクトの定義です。ウィンドウ、メニュー、アプリケーション、構造体、またはユーザオブジェクトの各ペインタで、オブジェクトの定義を作成します。ペインタでは、次のようにオブジェクトの定義を作成します。つまり、オブジェクトの一部となるコントロールを追加、オブジェクトのプロパティに初期値を設定、インスタンス変数と関数を定義、イベントや関数のスクリプトを記述、という手順になります。

オブジェクトのインスタンスは、アプリケーションの実行時に作成されるオブジェクトクラスのコピーです。オブジェクトに対してメモリを割り当て、オブジェクトクラスの定義に基づいてオブジェクトを定義する場合は、オブジェクトのインスタンスを作成します。

オブジェクトへの参照は、オブジェクトのインスタンスへのハンドルです。オブジェクトを操作するには、そのオブジェクトへの参照が必要です。適切なデータ型の変数にオブジェクトへの参照を代入できます。

システムオブジェクトとユーザオブジェクト

PowerBuilder がサポートするオブジェクトは、 2 つに分類できます。PowerBuilder が定義するシステムオブジェクト（システムクラスとして参照される）と開発者がペインタで定義するユーザオブジェクトです。

システムオブジェクト PowerBuilder のシステムオブジェクトまたはシステムクラスは、基本クラスである PowerObject から継承されます。システムクラスは、開発者が定義するオブジェクトの先祖です。システムクラスの階層を見るには、ブラウザの［システム］タブで、「PowerObject」を選択し、ポップアップメニューから［階層の表示］と［この下をすべて表示］を選択します。

ユーザオブジェクト適切なペインタでオブジェクトクラスの定義を作成します。ペインタには、ウィンドウ、メニュー、アプリケーション、構造体、ユーザオブジェクトペインタがあります。開発者が定義するオブジェクトは、システムクラスか開発者が作成した別のクラスから継承されます。

ペインタでオブジェクトを定義する場合、多くのクラスから継承されます。ウィンドウペインタやユーザオブジェクトペインタで作成するオブジェクトの定義は、システムクラスである Window クラスやUserObject クラスから継承されます。また、開発者が使用するコントロールも、そのコントロールに対応したシステムクラスから継承されます。



ユーザオブジェクトについて2 種類のユーザオブジェクト

ユーザオブジェクトには、ビジュアルユーザオブジェクトとクラスユーザオブジェクトの 2 種類があります。

ビジュアルユーザオブジェクト

ビジュアルユーザオブジェクトとは、一定の動作を行う、再利用可能なコントロールまたはコントロールの集合です。標準、カスタム、外部の 3 種類があります。

表 5-1: ビジュアルユーザオブジェクトの種類

クラスユーザオブジェクト

クラスユーザオブジェクトは、プロパティと関数で構成されます。イベントを含む場合もあります。画面での表示機能はありません。標準とカスタムの 2 種類があります。

ビジュアルユーザオブジェクト説明

標準標準の PowerBuilder コントロールから継承されます。プロパティを設定したり、スクリプトを記述して、コントロールを拡張できます。

先祖のコントロールと同じイベントとプロパティがあります。また、開発者はユーザイベントを定義して、独自のイベントを追加できます。

カスタム Userobject システムクラスから継承されます。開発者は、ユーザオブジェクトに複数の PowerBuilderコントロールを配置し、そのコントロールのイベントに対するスクリプトを記述できます。

ユーザオブジェクトに配置したコントロールは、先祖のコントロールと同じイベントとプロパティがあります。また、開発者はユーザイベントを定義して、独自のイベントを追加できます。

外部 DLL で定義されたビジュアルなコントロールを表示するユーザオブジェクトです。このコントロールは、 PowerBuilder オブジェクトの階層構造体の一部ではありません。 DLL の開発元は、コントロールの提示を管理するスタイルビット（Stylebit）に関する情報を提供します。

また、コントロールのイベント、関数、プロパティに関する情報も、 DLL の開発元が提供します。

外部ユーザオブジェクトは、 OCX を保持できるOLE 2.0 カスタムコントロールとは異なります。

82 PowerBuilder


表 5-2: クラスユーザオブジェクトの種類

ユーザオブジェクトの定義と使い方についての詳細は、『PowerBuilderユーザーズガイド』マニュアルを参照してください。

オブジェクトのインスタンス作成クラスとインスタンスオブジェクトクラスとインスタンスが同じ名前のときに、 2 つが同じ

物ではないことを認識してください。たとえば、ウィンドウペインタでウィンドウを定義する場合は、オブジェクトクラスを定義します。

1 つのインスタンス Open 関数の構文 1 でウィンドウを開く場合は、そのオブジェクトのインスタンスを作成します。クラス定義とインスタンスは、どちらも同じ名前です。アプリケーションにおいて、w_main は w_main 型のグローバル変数です。

Open(w_main)

この方法でウィンドウを開く場合は、オブジェクトのインスタンスは1 つしか開けません。

複数のインスタンスウィンドウクラスのインスタンスを複数開く場合は、それぞれのオブジェクトへの参照を保持するための変数を定義します。

w_main w_1, w_2Open(w_1)Open(w_2)

また、 Open 関数でクラス名を指定して、ウィンドウを開くことができます。

クラスユーザオブジェクト説明

標準 Transaction オブジェクトや Error オブジェクトなどの、組み込みの PowerBuilder クラスオブジェクトから継承されます。開発者は、インスタンス変数や関数を追加して、オブジェクトを拡張できます。

PowerBuilder クラスオブジェクトにはイベントがあるものがあります。このイベントに対するスクリプトを記述するには、クラスユーザオブジェクトを定義しなければなりません。

カスタム開発者が独自に設計するオブジェクトです。インスタンス変数、イベント、関数を定義して、アプリケーション特定のプログラミングをカプセル化します。



window w_1, w_2Open(w_1, "w_main")Open(w_2, "w_main")

クラスユーザオブジェクトの場合は、オブジェクトへの参照を保持するための変数を定義して、 CREATE 文でオブジェクトのインスタンスを作成します。

uo_emp_data uo_1, uo_2uo_1 = CREATE uo_emp_datauo_2 = CREATE uo_emp_data

1 つのオブジェクトに対して、そのオブジェクトへの参照を複数持つことができます。適切なデータ型の変数にオブジェクトへの参照を代入するか、オブジェクトへの参照を別のオブジェクトに渡して、オブジェクトの情報の取得や変更ができます。

オブジェクトデータ型の変数と代入についての詳細は、 86 ページの「構造体としてのユーザオブジェクト」を参照してください。

先祖と子孫の使い方子孫オブジェクト PowerBuilder では、オブジェクトクラスを別のクラスから継承できま

す。継承されたオブジェクト（子孫オブジェクト）には、先祖のインスタンス変数、イベント、関数すべてが継承されます。子孫オブジェクトは、変数、イベント、関数を追加して、子孫オブジェクトを拡張させることができます。子孫オブジェクトを変更した後も、先祖オブジェクトを変更すれば、子孫オブジェクトには先祖オブジェクトの変更が反映されます。

インスタンスの作成子孫オブジェクトのインスタンスを作成すると、そのすべての先祖クラスのインスタンスも作成されます。プログラムは、先祖オブジェクトのインスタンスにアクセスできません。ただし、スコープ演算子を使用すれば、先祖の関数やイベントにアクセスできます。

84 PowerBuilder


ガベージコレクションガベージコレクションの機能

PowerBuilder のガベージコレクションメカニズムは、メモリ内の参照されていないオブジェクトや参照元のないオブジェクトを自動的にチェックし、このようなオブジェクトが見つかると削除することによって、ほとんどのメモリリークに対処しています。 DESTROY 文を使ってオブジェクトを明示的に破棄しなくても、ガベージコレクションを使用して破棄できます。これによって、別のプロセスで使用されたオブジェクトや、ポストされたイベントや関数への参照によって渡されたオブジェクトを破棄するときの実行時エラーを防ぐことができます。

ガベージコレクションが発生する状況

ガベージコレクションが発生するのは、以下のような場合です。

• 参照がオブジェクトから削除されるときオブジェクトへの参照とは、値が object 型のすべての変数です。変数がスコープからはずれたり、変数に異なる値が代入されると、PowerBuilder がオブジェクトへの参照を削除し、残りの参照をカウントして、参照が残っていなければオブジェクトを破棄します。

• ガベージコレクションの間隔時間を超えた場合 PowerBuilder がシステム起動イベントの実行を完了した場合、設定されたガベージコレクションの受け渡し間隔を超えていれば、ガベージコレクションが行われます。デフォルトの間隔は 0.5 秒です。ガベージコレクションの受け渡しによって、循環参照を持つもの（互いを参照している以外に参照されていないオブジェクト）を含め、参照できないオブジェクトとクラスは削除されます。

イベントと関数のポストイベントや関数をポストしてオブジェクト参照を渡す場合、ポストした時間からイベントや関数が実際に実行されるまでの間にガベージコレクションが適用されるのを防ぐため、オブジェクトへの内部参照が追加されます。この内部参照は、イベントや関数が実行されると削除されます。

ガベージコレクション適用の例外

コレクションが適用されないオブジェクトもいくつかあります。

• ビジュアルオブジェクト画面に表示されるオブジェクトは、画面で作成され、表示されるときに内部参照が追加されるため、コレクションの対象となりません。ビジュアルオブジェクトは、閉じられると明示的に破棄されます。



• タイミングオブジェクト実行中のタイミングオブジェクトは、タイミングオブジェクトに対する Start 関数によって内部参照が追加されるため、コレクションの対象となりません。 Stop 関数により、内部参照は削除されます。

• 共有オブジェクト登録された共有オブジェクトは、SharedObjectRegister関数によって内部参照が追加されるため、コレクションの対象となりません。内部参照は、 SharedObjectUnregister 関数によって削除されます。

ガベージコレクション発生の制御

PowerBuilder では、ガベージコレクションは自動的に発生しますが、GarbageCollect、GarbageCollectGetTimeLimit、GarbageCollectSetTimeLimit の関数を使用すると、その場で強制的にガベージコレクションを発生させたり、参照カウントのチェック間隔を変更できます。ガベージコレクションの間隔を非常に長く設定することによって、ガベージコレクションを実質的に無効にすることもできます。

構造体としてのユーザオブジェクト

PowerBuilder では、クラスユーザオブジェクトは、構造体と同じような機能を提供します。クラスユーザオブジェクトのインスタンス変数は、構造体の変数と似た集合体を形成します。スクリプトでは、構造体の変数と同じように、ドット（.）表記を使用して、クラスユーザオブジェクトのインスタンス変数を参照します。

ユーザオブジェクトの利点

ユーザオブジェクトは、ユーザオブジェクト関数やユーザオブジェクト構造体を定義できるうえ、先祖クラスから継承することもできます。しかし、構造体は、関数の定義はできません。

メモリ割り当ての違いユーザオブジェクトに対するメモリの割り当ては、構造体と異なります。オブジェクト変数は、オブジェクトへの参照です。したがって、変数を宣言しても、オブジェクトに対してメモリを割り当てません。オブジェクトを宣言した後に、CREATE 文でオブジェクトのインスタンスを作成しなければなりません。また、ユーザオブジェクトに対する代入も、同じように異なります（次の「オブジェクトと構造体の代入」で解説します）。

インスタンスを自動生成するオブジェクト

メソッドと継承を持つユーザオブジェクトに、構造体のメモリ割り当てと同じ機能を持たせる場合は、インスタンスを自動生成するユーザオブジェクトを定義します。

86 PowerBuilder


インスタンスを自動生成するユーザオブジェクトは、開発者がインスタンスを作成したり破棄する必要がありません。構造体と同じように、オブジェクトを宣言したときにインスタンスが作成され、スコープから外れたときに、インスタンスが破棄されます。インスタンスを自動生成するオブジェクトに対する代入は、構造体と同じような動作をします。したがって、通常のオブジェクトの代入と異なり、制約事項があります。

カスタムクラスユーザオブジェクトを自動生成するには、ユーザオブジェクトのプロパティシートのポップアップメニューから［インスタンスの自動生成］チェックボックスをオンにします。

オブジェクトと構造体の代入PowerBuilder では、オブジェクトの代入は、構造体やインスタンスを自動生成するオブジェクトの代入とは異なります。

• 構造体を、同じ定義を持つ別の構造体に代入すると、構造体のすべての変数の値がコピーされ、構造体データの 2 つ目のコピーができます。

• オブジェクトデータ型の変数を同じオブジェクトデータ型の別の変数に代入すると、そのオブジェクトの参照がコピーされ、どちらの変数も同じオブジェクトを参照するようになります。オブジェクト自体は、コピーされません。

構造体の代入

構造体をデータ型とする変数を宣言すると、その構造体のインスタンスが作成されます。

str_emp_data str_emp1, str_emp2 // 2 つの構造体の// インスタンス

構造体を同じ定義を持つ別の構造体に代入すると、構造体のすべての変数の値がコピーされ、構造体データの 2 つ目のコピーができます。

str_emp1 = str_emp2

代入は、構造体のすべての変数の値を同じデータ型の別の構造体にコピーします。各変数は、構造体 str_emp_data のインスタンスです。


オブジェクトと構造体の代入

構造体の代入の制限構造体の定義が異なる場合、構造体の変数の定義が同じでも、構造体の代入はできません。

たとえば、以下の代入はできません。

str_emp str_person1str_cust str_person2

str_person2 = str_person1 // 代入できません

構造体を関数の引数として渡す方法についての詳細は、 107 ページの「関数とイベントへの引数の渡し方」を参照してください。

オブジェクトの代入

オブジェクトデータ型の変数を宣言すると、オブジェクトの参照が宣言されます。

uo_emp_data uo_emp1, uo_emp2 // 2 つのオブジェクトの参照

CREATE 文を使用して、オブジェクトのインスタンスを作成します。

uo_emp1 = CREATE uo_emp_data

オブジェクトデータ型の変数を同じオブジェクトデータ型の別の変数に代入すると、オブジェクトのインスタンスへの参照がコピーされます。オブジェクトのインスタンス自体は、コピーされません。

uo_emp2 = uo_emp1 // 両方とも同じオブジェクトのインスタンスを参照します

先祖オブジェクトと子孫オブジェクト

先祖オブジェクトと子孫オブジェクト間の代入も、オブジェクトへの参照のコピーと同じようにして行われます。

たとえば、uo_emp_data は、uo_emp_active と uo_emp_inactive のそれぞれのユーザオブジェクトの先祖ユーザオブジェクトとします。

この先祖オブジェクトデータ型の変数を宣言します。

uo_emp_data uo_emp1, uo_emp2

子孫オブジェクトのインスタンスを作成して、先祖オブジェクトの変数に子孫オブジェクトへの参照を代入します。

uo_emp1 = CREATE USING "uo_emp_active"

uo_emp1 を uo_emp2 に代入すると、両方の変数は子孫オブジェクトuo_emp_active のインスタンスを参照します。

uo_emp2 = uo_emp1

88 PowerBuilder


オブジェクトを関数の引数として渡す方法についての詳細は、 107ページの「関数とイベントへの引数の渡し方」を参照してください。

自動生成するユーザオブジェクトの代入

インスタンスを自動生成するユーザオブジェクトを宣言すると、そのオブジェクトのインスタンスが自動的に生成されます（構造体と同じです）。［インスタンスの自動生成］オプション設定がされているユーザオブジェクトに対しては、 CREATE 文は使用できません。以下の例では、 uo_emp_data には、［インスタンスの自動生成］オプションが設定されています。

uo_emp_data uo_emp1, uo_emp2 // 2 つのオブジェクトインスタンス

インスタンスを自動生成するユーザオブジェクトを別のインスタンスを自動生成するユーザオブジェクトに代入すると、オブジェクト全体がコピーされます。

uo_emp1 = uo_emp2

インスタンスを自動生成するユーザオブジェクトへの参照は、 1 つしかありません。

関数の引数渡しインスタンスを自動生成するユーザオブジェクトを関数の引数に渡すと、構造体を渡したときと同じような動きをします。

• 値渡しは、オブジェクトのコピーを渡します。

• 参照渡しは、ほかの標準データ型と同様に、オブジェクトへの参照を渡します。

• 読み出し専用は、オブジェクトのコピーを渡しますが、コピーを修正できません。

コピーの制約事項オブジェクトデータ型が一致するか、コピー先のオブジェクトがそのオブジェクトの先祖で、インスタンスを自動生成しない場合だけ、インスタンスを自動生成するユーザオブジェクトの代入ができます。

規則 1 インスタンスを自動生成するユーザオブジェクトを別のインスタンスを自動生成するユーザオブジェクトに代入する場合は、両方同じオブジェクトデータ型でなければなりません。


オブジェクトと構造体の代入

規則 2 インスタンスを自動生成する子孫オブジェクトを先祖オブジェクトの変数に代入する場合は、先祖オブジェクトに［インスタンスの自動生成］オプションが設定されていてはいけません。先祖オブジェクトの変数には、その子孫オブジェクトのコピーへの参照が保持されます。

規則 3 先祖オブジェクトを子孫オブジェクトの変数に代入する場合は、先祖オブジェクトが子孫オブジェクトのインスタンスを保持していなければ、実行時エラーが起きます。

例以下に例を示します。宣言文は次のとおりです。なお、 uo_emp_activeと uo_emp_inactive はインスタンスを自動生成するユーザオブジェクトで、インスタンスを自動生成しないユーザオブジェクト uo_emp_dataの子孫オブジェクトとします。

uo_emp_data uo_emp1 // 先祖uo_emp_active uo_empa, uo_empb // 子孫uo_emp_inactive uo_empi // 別の子孫

規則 1 の例上記で宣言したユーザオブジェクトで、インスタンスを別のインスタンスに代入します。異なるオブジェクトデータ型の代入は、コンパイルエラーになります。

uo_empb = uo_empa // 有効、同じオブジェクトデータ型uo_empa = uo_empi // 無効、異なるオブジェクトデータ型

規則 2 の例以下の代入をすると、 uo_emp1 に子孫オブジェクトuo_empa のコピーが保持されます。 uo_emp1 のオブジェクトデータ型である uo_emp_data は、［インスタンスの自動生成］オプションを設定してはいけません。 uo_emp_data に［インスタンスの自動生成］オプションが設定されている場合は、コンパイルエラーになります。

uo_emp1 = uo_empa

規則 3 の例 uo_emp1 がその子孫オブジェクト uo_empa のインスタンスを保持している場合だけ、代入できます。

uo_empa = uo_emp1

uo_emp1 にその子孫オブジェクトのインスタンスが保持されていない場合は、実行時エラーが起きます。

関数とイベントへの引数の渡し方についての詳細は、107 ページの「関数とイベントへの引数の渡し方」を参照してください。

90 PowerBuilder

第 6 章関数とイベントの呼び出し

この章についてこの章では、まず、関数やイベントのさまざまな使い方を理解するのに役立つ予備知識を説明し、次に、関数とイベントを呼び出す構文について説明します。

内容

関数とイベントについて関数とイベントの重要性 PowerScript 言語には、式や代入文で使用できる PowerScript 関数が

用意されています。

関数とイベントの種類 PowerBuilder のオブジェクトには、そのオブジェクトで使用できるイベントと関数があります。独自のユーザ定義関数とユーザイベントを定義すれば、オブジェクトを拡張することができます。また、オブジェクトにローカル外部関数を宣言することもできます。PowerScript 言語には、どのオブジェクトにも属さないシステム関数もあります。また、外部関数やリモートプロシージャコールを宣言して、独自のグローバル関数を定義できます。

次の表に、関数とイベントの種類の一覧を示します。

項目ページ

関数とイベントについて 91

関数とイベントの検索と実行方法 94

関数とイベントのトリガまたはポスト 96

静的呼び出しと動的呼び出し 98

関数とイベントの多重定義、上書き、拡張 105

関数とイベントへの引数の渡し方 107

戻り値の使い方 110

PowerBuilder の関数とイベントの呼び出し構文 113

先祖オブジェクトの関数とイベントの呼び出し 117


関数とイベントについて

表 6-1: 関数とイベントの種類

分類用語定義

イベントイベントスクリプトの実行を開始できる、オブジェクトやコントロールのアクション。エンドユーザはアクション（オブジェクトをクリックするかデータを入力します）によって、イベントを起動できます。また、別のスクリプトのステートメントでもイベントを起動できます。

ユーザイベント

オブジェクトの機能を拡張するために定義するイベント。引数やリターンコードを指定します。また、イベントが Windows システムメッセージに対応するかどうかも指定します。ユーザイベントの定義方法についての詳細は、『PowerBuilder ユーザーズガイド』マニュアルを参照してください。

システムイベント - または組み込みイベント

PowerBuilder であらかじめ定義されているオブジェクトに対するイベント。システムイベントは通常、エンドユーザのアクションやシステムメッセージによって起動されます。PowerBuilder は、あらかじめ定義されているイベントに引数を渡すので、そのイベントに対するスクリプトで引数が参照できます。システムイベントは、 Long 型のリターンコードを指定するか、リターンコードがないかのどちらかです。

関数関数特定の処理を実行するプログラムまたはルーチン

システム関数オブジェクトに関連付けられていないPowerScript 関数

オブジェクト関数

オブジェクトに関連付けられた関数。PowerBuilder はあらかじめ定義されたオブジェクト関数を用意しています。また、開発者が独自に関数を定義することもできます。

ユーザ定義関数

開発者が定義する関数。関数ペインタでグローバル関数を定義し、スクリプトビューを持つほかのペインタでオブジェクト関数を定義します。

グローバル関数

アプリケーション内のすべてのスクリプトから呼び出すことができる関数。 PowerScript のシステム関数はグローバルにアクセスできます。

92 PowerBuilder


関数とイベントの比較関数とイベントには次のような類似点があります。

• 引数と戻り値がある

• 動的または静的に呼び出すことができる（グローバル関数やシステム関数は動的に呼び出すことはできない）

• 関数やイベントの呼び出しをポストまたはトリガできる

関数とイベントの相違点は以下のとおりです。

• 関数はグローバルかオブジェクトの定義の一部。イベントはオブジェクトに関連付けられている

• イベントと関数の検索方法は異なる

• 定義されていないイベントの呼び出しはエラーにならないが、定義されていない関数の呼び出しはエラーになる

• オブジェクトレベルの関数は多重定義できるが、イベント（とグローバル関数）は多重定義できない

• 関数を定義するときは、関数へのアクセスを制限できるが、イベントを定義するときは、スコープレベルを記述できない

• 関数を継承する場合、子孫のスクリプト内で先祖関数を呼び出すことによって、先祖関数を拡張できる。また、先祖関数の定義を上書きすることもできる。イベントを継承する場合、デフォルトではイベントのスクリプトが拡張される。スクリプトを拡張するか、上書きするかを選択できる

関数ローカル外部関数

オブジェクトに属す外部関数。ウィンドウペインタやユーザオブジェクトペインタなどで宣言します。外部関数の定義は別のライブラリ内にあります。

グローバル外部関数

アプリケーション内のすべてのスクリプトで呼び出すことができる外部関数。各種ペインタで宣言します。外部関数の定義は別のライブラリ内にあります。

リモートプロシージャコール

スクリプトから呼び出すことのできるデータベースのストアドプロシージャ。RPC は、グローバルまたはローカル（オブジェクトに属します）で宣言できます。ストアドプロシージャの定義はデータベースにあります。

分類用語定義


関数とイベントの検索と実行方法

どちらを使うかスクリプトをユーザ定義関数かユーザイベントのどちらで記述するかは、アプリケーションの設計時に決めます。スクリプトをどちらで記述してもパフォーマンスに違いはありません。開発者がユーザイベントの定義かユーザ定義関数の定義のどちらのインタフェースを好むか、エラー処理をどのようにするか、多重定義をするかなどを考慮して決定します。

イベントか関数のどちらか一方しか使用しないということはないでしょうが、管理を容易にするために、通常の処理にはイベントか関数のどちらかを使用するように決めた方がよいでしょう。

関数とイベントの検索と実行方法PowerBuilder は、一致する関数やイベントを、その名前と引数リストに基づいて検索します。 PowerBuilder は、引数のデータ型に互換性があれば（すべての数値型など）、一致するとみなします。データ型は正確に一致する必要はありません。 PowerBuilder は、互換性のあるデータ型の優先順位に従って、あるデータ型が別のデータ型とどのくらいの近さで一致するかをチェックします。

関数とイベントの大きな違いは、検索方法です。

関数の検索

関数を呼び出すときは、一致する関数が見つかるまで検索し、関数が見つかると検索が終了し、その関数が実行されます。関数名が同じで引数が異なる場合は、関数の多重定義と呼びます。詳細については、105 ページの「関数とイベントの多重定義、上書き、拡張」を参照してください。

修飾子のない関数名関数名をオブジェクト名で修飾していない場合は、名前と引数が一致する関数が検索され、最初に見つかった関数が実行されます。PowerBuilder は、次の順序で一致する関数を検索します。

1 グローバル外部関数

2 グローバル関数

3 オブジェクト関数とローカル外部関数。オブジェクトが子孫の場合は、継承階層の最下位の階層レベルから順に一致する関数が検索される

94 PowerBuilder


4 システム関数

修飾子のある関数名オブジェクト関数とグローバル関数が同じ名前の場合、オブジェクト関数を呼びだすには、ドット（.）表記を使用してオブジェクト関数を修飾します。修飾子のある関数名を使えば、関数の検索は、そのオブジェクトの先祖の階層（上記の検索順の 3 番）までしか行われません。以下に例を示します。

dw_1.Update( )w_employee.uf_process_list()This.uf_process_list()

オブジェクトの継承階層内で関数を検索する場合は、一致する子孫関数のかわりに、先祖関数を呼び出すことができます。

先祖関数を呼び出す構文については、 117 ページの「先祖オブジェクトの関数とイベントの呼び出し」を参照してください。

イベントの検索

子孫オブジェクトのイベントは、デフォルトでは先祖イベントの拡張です。イベントを呼び出すときは、そのオブジェクトの継承階層の最下位のレベルから順に、最上位のレベルに達するか先祖オブジェクトを上書きするイベントが見つかるまで、イベントが検索されます。次に、上位の階層レベルの先祖イベントから下位の階層レベルの子孫イベントへと、検出されたすべてのイベントが実行されます。

関数とイベントの検索次の図に、関数の検索方法とイベントの検索方法の違いを示します。


関数とイベントのトリガまたはポスト

関数とイベントのトリガまたはポストトリガ PowerBuilder では、関数やイベント（以下、 2 つを総称してメソッドと

呼ぶ）をトリガすると、メソッドはすぐに呼び出されます。メソッドの戻り値は、呼び出し元のスクリプトで使用できます。

ポストメソッドをポストすると、メソッドは呼び出し元のオブジェクトのキューに追加され、順番が来ると実行されます。ほとんどの場合、現行のスクリプトが終了すると実行されます。ただし、別のシステムイベントが、メソッドが実行される前に発生した場合は、キュー内でのメソッドの位置はそのシステムイベントの後になることがあります。メソッドの戻り値は、呼び出し元のスクリプトでは使用できません。

メソッドをポストすると、呼び出し元のスクリプトはメソッドの戻り値を使用できません。ポストされたメソッドは、サブルーチンの呼び出しとみなすことができます。

状態情報をチェックする前に処理を終了しなければならない場合や、さらに処理が続くような場合、ポスト機能を使用します。次の例 2 を参照してください。

PowerBuilder メッセージの優先

PowerBuilder によってポストされたすべてのイベントは、 Windows システムのキューとは別のキューによって処理されます。 PowerBuilderによってポストされたメッセージは、 Windows によってポストされたメッセージよりも先に処理されるため、 Windows のメッセージをポストするイベントの中でポストされた PowerBuilder のイベントは、Windows のメッセージよりも先に処理されます。

たとえば、エディットマスクコントロールに文字が入力されると、PowerBuilder の pdm_keydown イベントが Windows のメッセージWM_CHAR をポストしてこの文字を入力します。入力された文字をエディットマスクコントロールから別のコントロールにコピーしたい場合は、コードを pdm_keydown イベントの中でポストされるイベントの中に記述してはいけません。この処理は、pdm_keyup にマップされたイベントなど、 WM_CHAR メッセージが処理された後で発生するイベントの中で行う必要があります。

POST の制約条件メソッドをポストすると、呼び出し元のスクリプトではメソッドの戻り値が使用できません。したがって、以下の制約があります。

• 式のオペランドには、ポストされた関数やイベントを使用できません。

• 関数の引数には、ポストされた関数やイベントを使用できません。

• カスケード呼び出しでは、最後のメソッドの呼び出しだけ POST を使用できます。

96 PowerBuilder


以下のステートメントは、コンパイルエラーになります。どちらのステートメントも戻り値が必要です。

IF POST IsNull( ) THEN ...w_1.uf_getresult(dw_1.POST GetBorderStyle(2))

EAServer での非同期処理

EAServer コンポーネントの呼び出しのコンテキストでは、 POST の使用はサポートされていません。 EAServer クライアントで共有オブジェクトの呼び出しをポストすることにより非同期処理をシミュレートにする方法については、オンラインヘルプの SharedObjectGet 関数を参照してください。 EAServer における非同期処理の詳細については、EAServer のマニュアルで ThreadManager モジュールと MessageServiceモジュールについての説明を参照してください。

TriggerEvent 関数と PostEvent 関数旧バージョンとの互換性のため、TriggerEvent 関数と PostEvent 関数は使用できますが、呼び出されたイベントに引数を渡すことはできません。PowerBuilder のメッセージオブジェクトで、イベントにデータを渡さなければなりません。

ポストの例以下に、イベントをポストする例を示します。

例 1 サンプルアプリケーションで、ウィンドウ w_activity_manager のOpen イベントは、ユーザオブジェクト u_app_actman に属する関数uf_setup と uf_set_tabpbsystem を呼び出します。関数がポストされるので、 Open イベントは関数が呼び出される前に終了することができます。エンドユーザは、ウィンドウを表示させながらセットアップ処理を行うことができます。

guo_global_vars.iuo_app_actman.POST uf_setup()guo_global_vars.iuo_com_actman.POST uf_set_tabpgsystem(0)

例 2 サンプルアプリケーションで、ユーザオブジェクトu_tabpg_amroadmap 内のツリービューコントロール tv_roadmap のDoubleClicked イベントは、ツリービュー項目を処理する関数をポストします。関数がポストされなければ、項目の展開ボタンが設定される前に、項目のピクチャを変更するかどうかをチェックするスクリプトが実行されます。

parent.POST uf_process_item ()


静的呼び出しと動的呼び出し

静的呼び出しと動的呼び出し関数とイベントの呼び出し

関数とイベントの呼び出しには、関数やイベントの種類と定義された検索方法に応じて、 3 つの方法があります。

表 6-2: PowerBuilder による関数とイベントの呼び出し方法

静的または動的な呼び出しの指定

オブジェクト関数やイベントでは、静的または動的な呼び出しを指定して、 PowerBuilder がいつオブジェクト関数やイベントを検索するかを指定できます。静的な呼び出しには STATIC キーワード、動的な呼び出しには DYNAMIC キーワードを指定します。 DYNAMIC キーワードは、オブジェクトに関連付けられた関数だけに適用されます。グローバル関数やシステム関数は、動的に呼び出すことはできません。

静的呼び出し

PowerBuilder は、デフォルトでは関数とイベントの静的な呼び出しをします。つまり、スクリプトをコンパイルするときに、メソッドの名前と引数のデータ型を照合することによって、メソッドを識別します。コンパイル時に、一致するメソッドがオブジェクトに存在しなければなりません。

関数の種類コンパイル条件コメント

グローバル関数とシステム関数

必須。関数はスクリプトがコンパイルされるときに存在しなければなりません。

関数は、コンパイル時に存在していなければならず、直接呼び出されます。関数は多重定義できません。したがって、実行時に同じ名前の別の関数が呼ばれることはありません。

静的に検索されるオブジェクト関数

必須。関数はスクリプトがコンパイルされるときに存在しなければなりません。

関数は多重定義できます。関数は、コンパイルするときに存在しなければなりませんが、実行時に別のクラスがインスタンス化された場合は、そのクラスの関数がかわりに呼び出されます。

動的に検索されるオブジェクト関数

任意。関数はスクリプトがコンパイルされるときに、その存在をチェックされません。

関数は多重定義できます。実際に呼び出される関数は、実行時に決定されます。

98 PowerBuilder


静的呼び出しの結果静的呼び出しでは、コンパイル時に識別された関数やイベントが実行されるとは限りません。たとえば、先祖オブジェクトをデータ型として変数を定義し、その先祖オブジェクトには関数が定義されているとします。その変数に子孫オブジェクトのインスタンスを代入します。子孫オブジェクトに先祖関数（コンパイル時に見つけられた先祖の関数）を上書きする関数がある場合は、その子孫関数が実行されます。

動的呼び出し

PowerBuilder で動的呼び出しを指定すると、スクリプトをコンパイルするときは、関数やイベントの存在がチェックされません。実行時には適切な関数やイベントが存在していなければなりません。

動的呼び出しは、関数やイベントの実行時に、その関数やイベントが検索されます。このようにすれば柔軟性が提供され、先祖オブジェクトに存在しない子孫オブジェクトの関数やイベントを呼び出すことができます。

動的呼び出しの結果以下の例は、動的呼び出しの結果を示します。

• 関数 Set （戻り値 Integer 型）が定義されている先祖ウィンドウ w_a

• 2 つの関数を持つ子孫ウィンドウ w_a_desc。関数 Set （戻り値Integer）型は、先祖関数を上書きする。関数 Set （戻り値 String 型）は、関数の多重定義

例 1 先祖ウィンドウクラス w_a のウィンドウ mywindow を開いたとします。

w_a mywindowOpen(mywindow)

次の表に、関数 Set を静的または動的に呼び出したときの結果を示します。

ステートメント結果

mywindow.Set(1)関数が先祖ウィンドウ w_a でみつけられるので正しくコンパイルされます。

実行時は、先祖の関数 Set （Integer型）が実行されます。

mywindow.Set("hello")コンパイルできません。呼び出し元の関数と一致する関数が w_a にありません。



例 2 子孫のウィンドウクラス w_a_desc として mywindow を開くとします。

w_a mywindowOpen(mywindow, "w_a_desc")

次の表に、子孫のウィンドウクラスで、関数 Set を静的または動的に呼び出したときの結果を示します。

動的呼び出しの欠点パフォーマンスが遅い動的呼び出しは、実行時に呼び出される関数が検索されるので、静的呼び出しよりパフォーマンスが悪くなります。パフォーマンスが要求される場合は、動的呼び出しをしないように、アプリケーションを設計します。

エラーチェックが少ない動的呼び出しを使用すると、コンパイラによるエラーチェックを行いません。動的に呼び出される関数は、実行時に使用できないことがあるので、アプリケーションの実行時エラーを起こす可能性が高くなります。したがって、静的呼び出しで対応できる場合は、動的呼び出しを使用しないでください。

mywindow.DYNAMIC Set("hello")DYNAMIC キーワードが指定されているので正しくコンパイルされます。

実行時は一致する関数が見つからないため、実行時エラーになります。


mywindow.Set(1)関数が先祖ウィンドウ w_a でみつけられるので正しくコンパイルされます。

実行時は、子孫の関数 Set （Integer型）が実行されます。

mywindow.Set("hello")コンパイルできません。呼び出し元の関数と一致する関数が先祖にありません。

mywindow.DYNAMIC Set("hello")DYNAMIC キーワードが指定されているので正しくコンパイルされます。

実行時は、子孫の関数 Set（String 型）が実行されます。


100 PowerBuilder


動的呼び出しの使用例サンプルアプリケーションで、先祖ウィンドウ w_datareview_frame は、メニュー m_datareview_framemenu のメニュー項目で呼び出される関数を定義します。関数の静的呼び出しがコンパイルできるように、関数には何も記述されていないスクリプトがあります。先祖ウィンドウw_datareview_frame の子孫であるほかのウィンドウには、先祖関数を上書きする子孫関数のスクリプトがあります。

関数 wf_print は先祖関数の 1 つです。先祖関数には何も記述されていないスクリプトがあり、各子孫ウィンドウの子孫スクリプトには適切なスクリプトが記述されています。

guo_global_vars.ish_currentsheet.wf_print ()

メニュー m_file のメニュー項目 m_export で呼び出される関数 wf_exportは、先祖ウィンドウでは定義されていません。メニュー項目 m_exportの以下のスクリプトは、関数 wf_export の呼び出しに DYNAMIC キーワードを使用します。スクリプトが実行されると、変数 ish_currentsheet の値は、関数 wf_export の定義がある子孫ウィンドウのインスタンスになります。

guo_global_vars.ish_currentsheet.DYNAMIC wf_export()

関数とイベントを動的に呼び出すときのエラー

関数やイベントを動的に呼び出す場合、何も影響しなかったり、実行時エラーになったりと、そのときの状況に応じてさまざまな結果をもたらします。次の表に、条件別にエラーの状態を示します。

関数関数の動的呼び出しの規則は、関数が存在しなければならないことを除けば、イベントと似ています。関数が見つからない場合は、実行時エラーが起きます。イベントはスクリプトがなくても定義できますが、関数を定義するときは、スクリプトがなければなりません。次のようなステートメントを考えてみてください。

1 次のステートメントは戻り値を無視します。

object.DYNAMIC funcname( )

2 次のステートメントは Integer 型の戻り値を必要とします。

int li_intli_int = object.DYNAMIC funcname( )

3 次のステートメントは Any 型の戻り値を必要とします。

any la_anyla_any = object.DYNAMIC funcname( )



次の表は、これらのステートメントを例として使用しています。

表 6-3: 動的な関数の呼び出しエラー

イベント次のようなステートメントを考えてみてください。

1 次のステートメントはリターンコードを無視します。

object.EVENT DYNAMIC eventname( )

2 次のステートメントは Integer 型のリターンコードを必要とします。

int li_intli_int = object.EVENT DYNAMIC eventname( )

3 次のステートメントは Any 型のリターンコードを必要とします。

any la_anyla_any = object.EVENT DYNAMIC eventname( )

次の表は、これらのステートメントを例として使用しています。

条件 1 条件 2 結果例

関数が存在しない場合

なし実行時エラー 65 :「動的関数が参照できません」が起きます。

すべてのステートメントで実行時エラー 65 が起きます。

関数が存在し、実行されるが、戻り値が定義されていない場合

スクリプトがリターンコードを必要とする場合

実行時エラー 63 :「戻り値のない関数/ イベントが式の中で使われています」が起きます。

ステートメント 2 と 3 では、実行時エラー63 が起きます。

102 PowerBuilder


表 6-4: 動的なイベントの呼び出しエラー


イベントが存在しない場合

スクリプトがリターンコードを必要としない場合

呼び出しは失敗しますが、エラーは起きません。

ステートメント 1の実行は失敗しますが、エラーは起きません。


Any 型の NULL が返されます。

ステートメント 3では、変数 La_anyに NULL が設定されます。

スクリプトが必要とするリターンコードのデータ型が Any 型でない場合、実行時エラー 19 が起きます。 Any 型のリターンコードを適切なデータ型に変換することはできません。

ステートメント 2では、変数 li_int への代入は実行時エラー 19 が起きます。

イベントが存在するが、実装されない（スクリプトがない）場合

イベントにリターンコードが定義されている場合

定義されたデータ型の NULL が返されます。

イベント eventnameが Integer 型のリターンコードを返すように定義されている場合、ステートメント 2 では、変数 li_int にNULL が設定されます。

イベントにリターンコードが定義されていない場合

Any 型の NULL が返されます。

ステートメント 3では、変数 La_anyに NULL が設定されます。



エラーが起きた場合実行時エラーが起きたときにアプリケーションを終了させないために、動的関数呼び出しを try-catch ブロックで囲むことができます。SystemError イベントでエラーを処理することもできますが、アプリケーションをそのまま継続させないでください。 SystemError イベントでは、エラーの後処理をし、アプリケーションを終了させる必要があります。

try-catch ブロックの使用法については、『アプリケーションテクニック』マニュアルの例外処理の章を参照してください。

引数が一致しない場合関数の引数は、関数定義の一部です。したがって、引数が一致しない場合は（データ型に互換性があれば一致するとみなす）、その関数は異なる関数です。関数が存在しない場合と同じ結果となります。

引数が一致しないイベントを動的に呼び出す場合は、呼び出しは失敗し、制御が呼び出し元のスクリプトに戻ります。実行時エラーは起きません。

エラーのないスクリプトの記述方法

関数とイベントの動的呼び出しは、実行時エラーが起きやすくなります。これらのエラーを回避する方法は、関数とイベントを静的に呼び出すことです。または、アプリケーションの設計とテストを十分に行って、関数やイベントが、正しいデータ型の戻り値を確実に返すようにします。

エラーをチェックすることで、実行時エラーを回避できるのは、データ型の変換エラーです。

スクリプトが必要とするリターンコードのデータ型が Any 型でない場合、実行時エラー 19 が起きます。 Any 型のリターンコードを適切なデータ型に変換することはできません。

ステートメント 2では、変数 li_int への代入は実行時エラー 19 が起きます。

イベントが存在し、実行されるが、リターンコードが定義されていない場合


実行時エラー 63 :「戻り値のない関数/ イベントが式の中で使われています」が起きます。

ステートメント 2と 3 では、実行時エラー 63 が起きます。


104 PowerBuilder


上記の表で前述したとおり、関数やイベントが定義されていても実装されていない場合、関数やイベントは、 Any 型の変数または定義されたリターンコードのデータ型の変数として、 NULL を戻します。

動的呼び出しで、リターンコードを Any 型の変数に代入する場合、スクリプトでリターンコードを使用する前に、リターンコードが NULL（失敗）かどうかをチェックできます。

以下の例は、リターンコードを使用する前に NULL をチェックします。

any la_anyinteger li_gotvaluela_any = object.DYNAMIC uf_getaninteger( )IF IsNull(la_any) THEN

... // エラー処理ELSE

li_gotvalue = la_anyEND IF

関数とイベントの多重定義、上書き、拡張PowerBuilder で関数を継承する場合、次の「関数の多重定義と上書き」で説明しているように、関数を多重定義するか、その定義を上書きするかを選択できます。

イベントを継承する場合、デフォルトではイベントのスクリプトが拡張されます。 107 ページの「イベントの拡張と上書き」で説明しているように、スクリプトを拡張するか、上書きするかを選択できます。

関数の多重定義と上書き

多重定義する関数を作成するには、ほかの関数の場合と同じように、［挿入｜関数］を使って関数を宣言します。

関数の上書きは、先祖オブジェクトの関数と同じ名前で同じ引数の関数を、子孫オブジェクトで定義することを意味します。子孫オブジェクトでは、スコープ記号（::）を使用しない限り、先祖関数のかわりに子孫関数が常に呼び出されます。


関数とイベントの多重定義、上書き、拡張

関数を上書きするには、ペインタで子孫オブジェクトを開き、スクリプトビューでその関数を選択し、新しいスクリプトを作成します。関数にスクリプトがあることを示すアイコンは、その関数が先祖から継承されている場合、半分影付きになっています。

オブジェクト関数だけが多重定義や上書きができます。グローバル関数は多重定義できません。

多重定義された関数の引数を一致させるときのデータ型の変換

引数に数値を渡す関数と文字列を渡す関数が多重定義されている場合、開発者には、どの引数を指定すれば、どちらの関数が呼び出されるかは明らかです。多重定義された関数の引数のデータ型は、互換性がないほうがよいでしょう。このような多重定義では、アプリケーションに必要な関数を確実に呼び出せます。

問題のある多重定義多重定義された関数の引数のデータ型が互換性がある場合（数値データ型、文字列と文字）、どの関数が呼び出されるかを決定するには、どのようにデータ型が変換されるかを考慮しなければなりません。どの関数が呼び出されるかを決定するのが複雑なため、このような多重定義は望ましくありません。

引数に式を渡して関数を呼び出した場合、式のデータ型が明確でないときがあります。しかし、引数のデータ型は、多重定義された関数のうちどの関数を呼び出すかを決定するので重要です。

数値データ型のデータ型変換は複雑なため、異なる数値データ型の引数を持つ関数は多重定義しないほうがよいでしょう。後で何か変更を行った場合、その変更が変更前と異なる関数を呼び出してしまうと、アプリケーションを実行したときに予期せぬ結果になることがあります。

データ型の昇格の動作方法

式が評価されるときは、定数や変数のデータ型を変換して、演算や文字列の連結をします。

数値算術演算式が評価されるとき、演算子とオペランドのデータ型に応じて、式のデータ型が変換されます。たとえば、式 n/2 は除算なので、式のデータ型は Double 型になります。変数 n のデータ型は、データ型の変換には関係しません。

文字列文字と文字列を連結する式が評価されるとき、文字（Char 型）は文字列（String 型）に変換されます。

データ型の昇格についての詳細は、 75 ページの「 PowerBuilder 式のデータ型」を参照してください。

106 PowerBuilder


データ型の変換関数の使い方

データ型の変換関数を呼び出すことにより、式のデータ型を制御できます。データ型の変換関数を用いて、式のデータ型を変換し、呼び出す関数の引数のデータ型に合わせることができます。

たとえば、式 n/2 は除算なので、式のデータ型は Double 型になります。しかし、呼び出す関数の引数のデータ型が Long 型の場合は、呼び出す関数とオブジェクトに定義されている関数を一致させるために、 Long関数を使用して、式のデータ型を Long 型に変換します。

CalculateHalf(Long(n/2))

イベントの拡張と上書き

PowerBuilder で、子孫オブジェクトでイベントのスクリプトを記述する場合は、先祖で記述したスクリプトを拡張または上書きできます。

イベントの拡張（デフォルト）は、まず先祖スクリプトを実行して、次に子孫のイベントスクリプトを実行します。

イベントの上書きは、先祖スクリプトを無視して、子孫スクリプトだけを実行します。

イベントの多重定義はできません同じ名前で異なる引数のイベントを定義しても、イベントは多重定義できません。イベント名は固有でなければなりません。

拡張または上書きを選択するには、スクリプトビューでスクリプトを開き、メニューの［編集］またはポップアップメニューの［先祖スクリプトを拡張］をオンまたはオフにします。

関数とイベントへの引数の渡し方PowerBuilder では、組み込みまたはユーザ定義の関数とイベントに引数を渡す方法は、 3 種類あります。


関数とイベントへの引数の渡し方

表 6-5: 関数とイベントへの引数の渡し方

オブジェクトの渡し方

関数やイベントの引数にオブジェクトを渡すと、そのオブジェクトのプロパティと関数を参照するときは、オブジェクトが存在しなければなりません。関数を呼び出してもオブジェクトのインスタンスが破棄されていた場合は、 NULL オブジェクトの参照のため実行時エラーになります。これは、参照渡し、値渡し、読み出し専用のいずれの方法で引数を渡したとしてもエラーになります。

たとえば、シングルラインエディットがあるウィンドウがあるとします。ウィンドウの Close イベントで、関数にシングルラインエディットを渡してポストする場合、関数が実行するときにはウィンドウが存在しません。シングルラインエディットに入力した情報を使用するには、引数にオブジェクトを渡すのではなく、オブジェクト名などの情報そのものを渡さなければなりません。

引数の渡し方説明

値渡し（By value）関数やイベントのスクリプトでは、呼び出し元の変数のコピーが使用できます。渡された引数の変更は、変数のコピーだけに影響します。呼び出し元のスクリプトにあるオリジナルの変数は、変更されません。

参照渡し（By reference）関数やイベントのスクリプトに呼び出し元の変数へのポインタが渡されます。渡された引数の変更は、呼び出し元のスクリプトにあるオリジナルの変数を変更します。

読み出し専用関数やイベントで呼び出し元の変数が使用できます。引数の値は定数と同じように扱われます。渡された引数の変更はできません。引数を変更するスクリプトを記述するとコンパイルエラーになります。

読み出し専用は値渡しのようにデータのコピーを作成しないので、いくつかのデータ型ではパフォーマンスがよくなります。読み出し専用によってパフォーマンスがよくなるデータ型は、String 型、Blob型、 Date 型、 Time 型、 DateTime 型です。

ほかのデータ型については、読み出し専用で引数を渡すことによって、開発者に引数が読み出ししか使用されないことを明確にさせます。

108 PowerBuilder


オブジェクトを渡しても、関数ではオブジェクトのコピーは取得できません。参照渡しと値渡しはオブジェクト自身でなく、オブジェクトの参照が渡されます。

値渡しされたオブジェクト

オブジェクトを値渡しすると、オブジェクトへの参照のコピーが渡されます。その参照はオリジナルのオブジェクトをそのまま指しています。渡されたオブジェクトのプロパティを変更すると、オリジナルのオブジェクトが変更されます。ただし、オリジナルのオブジェクトに影響しないで、別のオブジェクトを参照するように引数の値を変更することもできます。

参照渡しされたオブジェクト

オブジェクトを参照渡しすると、オリジナルのオブジェクトの参照へのポインタが渡されます。渡されたオブジェクトのプロパティを変更すると、オリジナルのオブジェクトが変更されます。渡された引数の値を変更して、オリジナルのオブジェクトへの参照を新しいオブジェクトへの参照にすることができます。

読み出し専用で渡されたオブジェクト

オブジェクトを読み出し専用で渡すと、オブジェクトへの参照のコピーが渡されます。新しいオブジェクトを指すように、オリジナルのオブジェクトへの参照を変更することはできませんが（読み出し専用は CONSTANT 宣言に等しいため）、オリジナルのオブジェクトのプロパティを変更することはできます。

構造体の渡し方

引数に構造体を渡す場合は、オブジェクトと違って変数と同じように動作します。

値渡しされた構造体構造体を値渡しすると、構造体のコピーが渡されます。オリジナルの構造体に影響しないで、引数の値を変更することができます。

参照渡しされた構造体構造体を参照渡しすると、構造体への参照が渡されます。引数の値を変更すると、オリジナルの構造体が変更されます。構造体は、スコープの外に出るまで存在するので、 NULL オブジェクトの参照エラーになることはありません。

読み出し専用で渡された構造体

構造体を読み出し専用で渡すと、構造体のコピーが渡されます。引数の値は変更できません。

配列の渡し方

引数が配列の場合は、関数やイベントの定義で引数名の後に角カッコ（［］）を指定します。


戻り値の使い方

引数としての可変長配列

たとえば、関数 uf_convertarray の引数に、 Integer 型の可変長配列を定義するとします。引数の名前を intarray とすると、引数名に intarray[ ]、データ型に integer を指定します。

関数を呼び出すスクリプトで、配列変数を宣言するか、インスタンス変数か受け取った値を使用します。変数の宣言は、次のとおりです。

integer a[]

関数を呼び出すときは配列全体を渡すので、角カッコを省略します。角カッコを指定すると、配列から値を 1 つしか渡せません。

uf_convertarray(a)

引数としての固定長配列

関数 uf_convertarray の引数に、 10 個の要素を持つ Integer 型の固定長配列を定義するとします。引数の名前を intarray とすると、引数名にintarray[10]、データ型に integer を指定します。

渡される変数の宣言は、以下のようになります。

integer a[10]

角カッコを指定しないで関数を呼び出します。

uf_convertarray(a)

配列の次元が一致しない場合渡された配列変数の次元が、関数で定義されている配列引数の次元と一致しない場合は、配列から配列への代入規則が適用されます。詳細については、 48 ページの「配列の宣言」を参照してください。

戻り値の使い方関数とイベントの戻り値は使用できます。

関数

すべての PowerScript 関数は、戻り値を返します。戻り値は、使用することも、無視することもできます。ユーザ定義関数と外部関数は、必ずしも戻り値を返すとは限りません。

戻り値を使用するには、適切なデータ型の変数に戻り値を代入するか、戻り値と同じデータ型の値が使用できる箇所で関数を呼び出します。

110 PowerBuilder


関数のポスト関数をポストすると、その戻り値は使用できません。

例組み込みの Asc 関数は String 型の引数を受け取り、渡された文字列の最初の文字の ASCII コードを返します。

string S1 = "Carton"int Test

Test=32+Asc(S1) // 変数 Test の値は現在 99// です（"C" の ASCII コードは 67 です）。

SelectRow 関数は、最初の引数に行番号を受け取ります。 GetRow 関数の戻り値は、行番号を返します。

dw_1.SelectRow(dw_1.GetRow(), TRUE)

戻り値を無視するには、 1 つのステートメントとして関数を呼び出します。

Beep(4) // Beep 関数は戻り値を返しますが、 // ほとんど必要とされません。

イベント

ほとんどのシステムイベントはリターンコードを返します。リターンコードは Long 型の数値のコードで、イベントごとに特別な意味があります。イベントに対するスクリプトで RETURN 文を使用して、イベントのリターンコードを指定します。

エンドユーザのアクションかシステムメッセージによってイベントが起動された場合、リターンコードはスクリプトにではなくシステムに戻されます。

システムイベントやユーザ定義イベントをスクリプトで起動する場合は、リターンコードは呼び出し元のスクリプトに戻されます。スクリプトでは、そのリターンコードを使用できます。イベントをポストすると、リターンコードは使用できません。


戻り値の使い方

カスケード呼び出しと戻り値の使い方

PowerBuilder のドット（.）表記を使用して、いくつかのオブジェクト関数またはイベントを連続的に呼び出すことができます。関数またはイベントの戻り値は、次に呼び出される関数またはイベントが属すオブジェクトと同じオブジェクトデータ型でなければなりません。

次の構文は、 3 つの関数をカスケード呼び出しする場合の戻り値の関係を示します。

func1returnsobject( ).func2returnsobject( ).func3returnsanything( )

カスケード呼び出しの欠点関数をカスケード呼び出しすると、関数の戻り値をチェックできなくなるため、関数の呼び出しが成功したかどうかを確認することができません。関数の戻り値をチェックする場合、各関数を別々に呼び出し、戻り値を変数に代入します。そして、カスケード呼び出しの最後の関数名の前に、エラーチェックした変数をドット（.）表記で指定できます。

動的呼び出しカスケード呼び出しで DYNAMIC キーワードを使用すると、呼び出されるすべての関数に適用されます。

次の例では、関数 func1 と func2 がどちらとも動的に呼び出されます。

object1.DYNAMIC func1().func2()

カスケード呼び出しで DYNAMIC キーワードを複数使用すると、コンパイルエラーになります。次の例は、エラーになります。

object1.DYNAMIC func1().DYNAMIC func2() // エラー

ポストされた関数とイベント

ポストされた関数やイベントは、呼び出し元のスクリプトに戻り値を戻しません。したがって、カスケード呼び出しの最後の関数またはイベントだけが POST キーワードを使用できます。最後の呼び出しの前の呼び出しは、最後に呼び出される関数またはイベントが属すオブジェクトと同じオブジェクトデータ型の戻り値を戻さなければなりません。

システムイベントシステムイベントのリターンコードのデータ型は Long 型であるか、またはリターンコードがないので、システムイベントはカスケード呼び出しの最後に指定しなければなりません。システムイベントは、次の呼び出しで使用できるオブジェクトを戻しません。

ユーザ定義イベントは、オブジェクトデータ型のリターンコードを定義できます。したがって、ユーザ定義イベントをカスケード呼び出しに指定できます。

112 PowerBuilder


PowerBuilder の関数とイベントの呼び出し構文説明これは、 PowerBuilder のすべての関数とイベントを呼び出すための構

文です。指定するキーワードによって、システム関数、グローバル関数、オブジェクト関数、ユーザ定義関数、外部関数、およびユーザ定義イベントを呼び出すことができます。

構文 { objectname.} { type } { calltype } { when } name ( { argumentlist } )

次の表に、関数とイベントを呼び出すときに使用する引数を示します。


PowerBuilder の関数とイベントの呼び出し構文

表 6-6: 関数とイベントの呼び出しで使用する引数

引数説明

objectname （オプション）

関数またはイベントが定義されているオブジェクトの名前またはその子孫オブジェクトの名前。後にピリオド（.）が続きます。または、 2 つのコロン（::）が続く先祖クラスの名前です。修飾子のない関数名の場合、 PowerBuilder は関数の検索規則に従い、最初に見つけた関数を実行します。

システム関数やグローバル関数の場合は、objectname を省略します。修飾子のない関数名を検索するための検索規則についての詳細は、 94 ページの「関数とイベントの検索と実行方法」を参照してください。

type （オプション）

関数またはイベントのどちらを呼び出すかを指定するキーワード。キーワードは、次のとおりです。

• FUNCTION （デフォルト） • EVENT

calltype （オプション）

PowerBuilder が関数をいつ検索するかを指定するキーワード。キーワードは、次のとおりです。

• STATIC （デフォルト） • DYNAMIC

静的呼び出しと動的呼び出しについての詳細は、 98ページの「静的呼び出しと動的呼び出し」を参照してください。動的呼び出しについての詳細は、 99 ページの「動的呼び出し」を参照してください。

when （オプション）

関数またはイベントを直ちに実行するか、現行のスクリプトが終了した後に実行するかを指定するキーワード。キーワードは、次のとおりです。

• TRIGGER- （デフォルト）関数またはイベントを直ちに実行します。

• POST -関数またはイベントがオブジェクトのキューに追加され、キュー内のほかのメッセージが処理された後で順番が来たら実行します。

トリガとポストについての詳細は、 96 ページの「関数とイベントのトリガまたはポスト」を参照してください。

name 呼び出すオブジェクト関数またはイベントの名前

argumentlist （オプション）

name に渡す値。ここで指定する値のデータ型は、関数またはイベントの定義で宣言されたデータ型に対応しなければなりません。

114 PowerBuilder


解説大文字と小文字の処理関数名とイベント名は大文字と小文字を区別しません。たとえば、以下のステートメントは同じです。

Clipboard("PowerBuilder")clipboard("PowerBuilder")CLIPBOARD("PowerBuilder")

引数の呼び出し type、 calltype、 when キーワードは、 objectname の後であれば、どの順序で指定してもかまいません。

イベントまたは関数によっては、適用されない構文のオプションがあります。たとえば、 PowerScript オブジェクト関数の動的呼び出しは、余分なオーバーヘッドを引き起こすだけです。しかし、異なるオブジェクトに同じ名前のユーザ定義関数がある場合は、その関数を動的に呼び出せば、有効なこともあるでしょう。

ユーザ定義グローバル関数やシステム関数をトリガまたはポストすることはできますが、動的に呼び出すことはできません。

関数の検索指定した名前のグローバル関数が存在しない場合、PowerBuilder は、システム関数を検索する前に、関数の名前と引数が一致するオブジェクト関数を検索します。

先祖オブジェクトの関数とイベントの動的呼び出し PowerBuilder に子孫オブジェクトの関数やイベントを検索させないで、先祖オブジェクトの関数やイベントを検索させる場合は、グローバルスコープ記号（::）を使用します。

グローバルスコープ記号についての詳細は、 117 ページの「先祖オブジェクトの関数とイベントの呼び出し」を参照してください。

カスケード呼び出しドット（.）表記を使用して、カスケード呼び出しを行えます。各関数やイベントの戻り値は、次に呼び出される関数またはオブジェクトが属すオブジェクトと同じオブジェクトデータ型でなければなりません。

カスケード呼び出しについての詳細は、 112 ページの「カスケード呼び出しと戻り値の使い方」を参照してください。

戻り値の使い方関数に戻り値がある場合、別の関数の引数か式のオペランドとして、代入文の右辺に関数を指定できます。

外部関数外部関数を呼び出すには、まず、その関数を宣言しなければなりません。外部関数の宣言についての詳細は、 58 ページの「外部関数の宣言」を参照してください。

例例 1 以下のステートメントは、最も簡単な関数呼び出し構文を使用する各種の関数呼び出しです。


PowerBuilder の関数とイベントの呼び出し構文

以下のステートメントは、システム関数 Asc を呼び出します。

charnum = Asc("x")

以下のステートメントは、データウィンドウコントロールのスクリプトで、データウィンドウ関数を呼び出します。

Update( )

以下のステートメントは、グローバルユーザ定義関数 gf_setup_appl を呼び出します。

gf_setup_appl(24, "Window1")

以下のステートメントは、システム関数 PrintRect を呼び出します。

PrintRect(job, 250, 250, 7500, 1000, 50)

例 2 以下のステートメントは、グローバル関数とシステム関数の呼び出しです。

以下のステートメントは、グローバルユーザ定義関数 gf_setup_appl をポストします。呼び出し元のスクリプトが終了すると、関数が実行されます。

POST gf_setup_appl(24, "Window1")

以下のステートメントは、システム関数 PrintRect をポストします。呼び出し元のスクリプトが終了すると、関数が実行されます。 job で指定された印刷ジョブはまだ開いていなければなりません。

POST PrintRect(job, 250, 250, 7500, 1000, 50)

例 3 以下のステートメントは、コントロールのスクリプトで、そのコントロールが配置されているウィンドウで定義したユーザ定義関数を呼び出します。 FUNCTION、 STATIC、 TRIGGER の各キーワードはデフォルトなので、以下の 2 つのステートメントは同じです。

Parent.FUNCTION STATIC TRIGGER wf_process( )Parent.wf_process( )

例 4 以下のステートメントは、データウィンドウコントロールのClicked イベントに対するスクリプトで同じコントロールのDoubleClicked イベントを呼び出します。システムが Clicked イベントに渡した引数は、 DoubleClicked イベントにそのまま渡されます。DoubleClicked イベントがシステムによって起動された場合は、PowerBuilder が引数を DoubleClicked に渡します。

This.EVENT DoubleClicked(xpos, ypos, row, dwo)

以下のステートメントは、 DoubleClicked イベントをポストします。

116 PowerBuilder


This.EVENT POST DoubleClicked(xpos, ypos, row, dwo)

例 5 変数 iw_a は、先祖ウィンドウデータ型 w_ancestorsheet のインスタンス変数です。

w_ancestorsheet iw_a

メニューには関数 wf_export を呼び出すスクリプトがありますが、その関数は先祖で定義されていないとします。スクリプトをコンパイルするためには、 DYNAMIC キーワードが必要です。

iw_a.DYNAMIC wf_export( )

実行時に、関数 wf_export の定義を持つ子孫ウィンドウを開く場合、子孫ウィンドウのインスタンスは変数 iw_a に割り当てられ、関数wf_export の呼び出しは成功します。

先祖オブジェクトの関数とイベントの呼び出し説明 PowerBuilder では、子孫オブジェクトのインスタンスを作成する場合、

そのクラスが先祖で、子孫オブジェクトに先祖を上書きする関数またはイベントが定義されていても、子孫の関数またはイベントが実行されます。先祖の関数またはイベントを実行するには、グローバルスコープ記号（::）を使って、明示的に先祖の関数またはイベントを呼び出します。

構文 { objectname. } ancestorclass ::{ type } { when } name ( { argumentlist } )

次の表に、オブジェクトの先祖の関数とイベントを呼び出すときに使用する引数を示します。


先祖オブジェクトの関数とイベントの呼び出し

表 6-7: 先祖の関数とイベントの呼び出しで使用する引数

解説 AncestorReturnValue 変数子孫オブジェクトでイベントスクリプトを拡張する場合、コンパイラはローカル変数 AncestorReturnValue を自動的に生成します。先祖イベントスクリプトの戻り値を知る必要がある場合は、この変数を使います。また、先祖スクリプトを上書きし、CALL 構文を使って先祖イベントスクリプトを呼び出す場合にも、この変数が生成されます。

AncestorReturnValue 変数のデータ型は、そのイベントの戻り値に定義されたデータ型と常に一致します。呼び出しに渡される引数は、子孫オブジェクトのイベントに渡される引数になります。

イベントスクリプトの拡張 AncestorReturnValue 変数は、拡張したイベントスクリプトで使用できます。イベントスクリプトを拡張すると、PowerBuilder が次の構文を生成し、イベントスクリプトの先頭に挿入します。

CALL SUPER::event_name

オブジェクトの構文をエクスポートする場合、またはソースエディタに表示する場合、ステートメントの参照のみ可能です。

引数説明

objectname （オプション）

先祖オブジェクトに実行する関数が定義されているオブジェクトの名前

ancestorclass 実行する関数またはイベントがある先祖クラスの名前。ancestorobject が現行のオブジェクトの直近の先祖の場合は、代名詞 Super が指定できます。

type （オプション）

関数またはイベントのどちらを呼び出すかを指定するキーワード。キーワードは、次のとおりです。

• FUNCTION （デフォルト）

• EVENT

when （オプション）

関数またはイベントを直ちに実行するか、現行のスクリプトが終了した後に実行するかを指定するキーワード。キーワードは、次のとおりです。

• TRIGGER- （デフォルト）関数またはイベントを直ちに実行します。

• POST -関数またはイベントがオブジェクトのキューに追加され、キュー内のほかのメッセージが処理された後で順番が来たら実行します。

name 呼び出すオブジェクト関数またはイベントの名前

argumentlist （オプション）

name に渡す値。ここで指定する値のデータ型は、関数またはイベントの定義で宣言されたデータ型に対応しなければなりません。

118 PowerBuilder


次に、拡張したイベントスクリプトの例を示します。

If AncestorReturnValue = 1 THEN

// スクリプトを実行するELSE

// 別のスクリプトを実行するEND IF

イベントスクリプトの上書きイベントスクリプトを上書きする前に、以下の CALL 構文で先祖イベントを呼び出す場合だけ、AncestorReturnValue 変数を使用できます。

CALL SUPER::event_name

または

CALL ancestor_name::event_name

コンパイラは、キーワード SUPER と先祖の名前を区別できません。スクリプトをコンパイルする前に、キーワード SUPER は先祖クラスの名前に置換されます。

CALL イベント構文を使用する場合だけ、 AncestorReturnValue 変数が宣言されて値が代入されます。次の新しいイベント構文を使う場合はこの変数は宣言されません。

ancestor_name::EVENT event_name( )

先祖のイベントスクリプトを上書きするスクリプトに先祖と同じスクリプトを記述できますが、 AncestorReturnValue 変数を使用する前にCALL 文を記述する必要があります。

// 事前処理のためのスクリプトを実行するCALL SUPER::uo_myeventIF AncestorReturnValue = 1 THEN...

CALL 文についての詳細は、127 ページの「 CALL」を参照してください。

例例 1 ウィンドウ w_ancestor にイベント ue_process が定義されているとします。子孫ウィンドウには、同じイベントに対するスクリプトが記述されています。

子孫スクリプトの以下のステートメントは、継承階層内のイベントを検索して、一致するイベントをすべて呼び出します。子孫スクリプトが先祖スクリプトを拡張する場合は、その継承階層の最上位レベルの先祖スクリプトから順番に実行され、子孫スクリプトは最後に実行されます。子孫スクリプトが先祖スクリプトを上書きする場合は、その子孫スクリプトだけが実行されます。

EVENT ue_process( )


先祖オブジェクトの関数とイベントの呼び出し

以下のステートメントは、先祖イベントだけを呼び出します。呼び出し元のスクリプトが別のオブジェクトまたは子孫ウィンドウに属す場合に、このスクリプトは実行できます。

w_ancestor::EVENT ue_process( )

例 2 代名詞 Super を使用して、先祖を参照できます。子孫ウィンドウのスクリプトまたはそのウィンドウ上のコントロールのスクリプトにおいて、以下のステートメントは、その子孫ウィンドウの直近の先祖の Clicked イベントを呼び出します。

Super::EVENT Clicked(0, x, y)

例 3 以下のステートメントは、先祖ウィンドウの関数 wf_myfunc を呼び出します。子孫ウィンドウに wf_myfunc と呼ばれる関数が定義されていても、先祖の関数が呼ばれます。

Super::wf_myfunc( )Super::POST wf_myfunc( )

120 PowerBuilder

第 2 部ステートメント、イベント、および関数

第 7 章 PowerScript のステートメント

この章についてこの章では、 PowerScript の各ステートメントとスクリプト内におけるステートメントの使い方について説明します。

内容項目ページ

値の代入文 124CALL 127CHOOSE CASE 129CONTINUE 131CREATE 132DESTROY 136DO...LOOP 137EXIT 139FOR...NEXT 140GOTO 142HALT 143IF...THEN 144RETURN 146THROW 147THROWS 148TRY...CATCH...FINALLY...END TRY 149


値の代入文

値の代入文機能変数やオブジェクトのプロパティに値を代入します。また、オブジェ

クト変数にオブジェクト参照を代入します。

構文 variablename = expression

解説変数に値を代入するには、代入文を使います。スクリプト内で変数に値を代入するには、以下のように等号（=）を使います。

String1 = "Part is out of stock"TaxRate = .05

複数の変数への代入は不可等号は論理演算子でもあるため、 1 つのステートメントの中で複数の変数に値を代入することはできません。たとえば、次のステートメントは、 A と B に 0 を代入するものではありません。

A=B=0 // このステートメントは A と B に 0 を代入しません。

このステートメントは、まず、 B=0 が TRUE か FALSE かを評価し、次にこの論理値を A に代入します。 A が Boolean 型の変数でなければ、このステートメントはコンパイル時にエラーとなります。

配列への値の代入配列に対しては、以下のように 1 つの代入文で複数の値を代入できます。

int Arr[]Arr = {1, 2, 3, 4}

さらに、配列の内容をコピーすることもできます。たとえば、次のステートメントは、配列 Arr2 の内容を配列 Arr1 にコピーします。

Arr1 = Arr2

後置式演算式次の表に示す PowerScript の後置式演算式を使用して変数に値を代入すれば、パフォーマンスが多少向上します。

引数説明

variablename 値を代入する変数の名前またはオブジェクトのプロパティの名前。 Variablename は、ドット（.）表記を使用して、変数を 1 つ以上のオブジェクト名で修飾できます。

expression 式。式のデータ型は、 variablename のデータ型と互換性がなければなりません。

124 PowerBuilder


表 7-1: 後置式演算式を使用した値の代入

変数名にハイフンを使える場合は、 -- や -= の前にスペースを入れる必要があります。スペースが入っていないと、マイナス符号は変数名の一部とみなされます。詳細については、 5 ページの「識別子の命名」を参照してください。

例例 1 以下のステートメントは、変数 ld_date に、それぞれ値を代入します。

date ld_dateld_date = Today( )ld_date = 1996-01-01ld_date = Date("January 1, 1996")

例 2 以下のステートメントは、 Window データ型の変数に、現行のコントロールの親への参照を代入します。

window lw_current_windowlw_current_window = Parent

例 3 以下のステートメントは、チェックボックス cbk_on を非表示にします。

cbk_on.Visible = FALSE

例 4 以下のステートメントは、代入文ではありません。シングルラインエディット sle_emp の中の文字列を判別します。

IF sle_emp.Text = "N" THEN Open(win_1)

例 5 以下のステートメントは、 2 つの文字列を連結して、その結果をString 型の変数に代入します。

string Text1Text1 = sle_emp.Text+".DAT"

例 6 以下のステートメントでは、後置式演算式を使用しています。 int i = 4

i ++ // i の値は 5。

値の代入文例同等の文

++ i ++ i = i +1-- i -- i = i -1+= i += 3 i = i +3-= i -= 3 i = i -3*= i *= 3 i = i * 3/= i /= 3 i = i / 3^= i ^=3 i = i ^ 3


値の代入文

i -- // i の値は再び 4 となります。i += 10 // i の値は 14。i /= 2 // i の値は 7。

後置式演算子は、後置式代入文だけで使用できます。また、ステートメントの中で、ほかの演算子と一緒に使用することはできません。たとえば、以下のステートメントは無効です。

int i, ji = 12

j = i ++ // このステートメントは無効です。

以下のステートメントは、 ++ が単独で使用されているので有効です。

int i, ji = 12i ++j = i

126 PowerBuilder


CALL機能子孫オブジェクトのスクリプトから先祖オブジェクトのスクリプトを

呼び出します。先祖ユーザオブジェクト、先祖メニュー、先祖ウィンドウの、イベントに対するスクリプトを呼び出すことができます。また、先祖ユーザオブジェクトや先祖ウィンドウ内のコントロールのイベントに対するスクリプトを呼び出すこともできます。

CALL 文を使用して先祖イベントスクリプトを呼び出す場合、AncestorReturnValue 変数が生成されます。 AncestorReturnValue 変数の詳細については、 193 ページの「イベントについて」を参照してください。

構文 CALL ancestorobject {`controlname}::event

解説標準的な構文の使い方原則として、関数やイベントを呼び出す際には標準的な構文を使用してください。標準的な構文についての詳細は、 113 ページの

「 PowerBuilder の関数とイベントの呼び出し構文」を参照してください。

標準的な構文を使用すると、先祖オブジェクトのイベントや関数をトリガまたはポストして、引数を渡すことができます。ただし、標準的な構文では、先祖オブジェクトのコントロールのスクリプトを呼び出すことはできません。

ancestorobject が子孫オブジェクトの直近の先祖の場合は、代名詞 Superを使うことができます。詳細については、 15 ページの「 Super 代名詞」を参照してください。

先祖イベントの呼び出しが行われると、現行イベントに渡される引数は自動的に先祖イベントに伝搬されます。先祖以外のイベントを呼び出し、引数を渡す場合は、新しい構文を使用する必要があります。新しい構文を使用しないと、各引数に NULL が渡されます。

例例 1 次のステートメントでは、先祖ウィンドウのイベントに対するスクリプトを呼び出します。

CALL w_emp::Open


ancestorobject 子孫オブジェクトの先祖

controlname （オプション）

先祖ウィンドウやカスタムユーザオブジェクトに配置されているコントロール名

event 先祖オブジェクトのイベント


CALL

例 2 次のステートメントでは、先祖ウィンドウに配置されているコントロールのイベントに対するスクリプトを呼び出します。

CALL w_emp`cb_close::Clicked

128 PowerBuilder


CHOOSE CASE機能条件式の値（通常は変数）に基づいてプログラムの実行内容を変更し

ます。

構文 CHOOSE CASE testexpressionCASE expressionlist

statementblock{ CASE expressionlist

statementblock . . .CASE expressionlist

statementblock } CASE ELSE

statementblock } END CHOOSE

解説 CHOOSE CASE 文には、最低 1 つの CASE 句が必要です。また、 ENDCHOOSE 文で完結させなければなりません。

CHOOSE CASE 文の次に記述された testexpression と CASE 句のexpressionlist の値が一致した場合には、その expressionlist の直後のstatementblock を実行します。その後、 END CHOOSE 句の次のステートメントを実行します。

CASE 句が複数存在する場合は、testexpression と各 expressionlist に一致する値が見つかるか、CASE ELSE 句または END CHOOSE 句を検出するまで照合を行います。


testexpression スクリプトの実行内容を決定する式

expressionlist 以下のいずれかの式

• 単一の値

• カンマで区切られた値の並び（たとえば、2, 4, 6,8）

• TO 句（たとえば、 1 TO 30）

• IS に続く関係演算子と比較値（たとえば、IS>5）

• 上記の式の任意の組み合わせ。式と式は暗黙的に OR で結合されます（たとえば、1, 3, 5, 7, 9, 27TO 33, IS>42)

statementblock testexpression と expressionlist の値が一致する場合に実行する実行文ブロック


CHOOSE CASE

testexpression と各 expressionlist に一致する値が見つからない場合、CASE ELSE 句が存在すれば、CASE ELSE 句の statementblock を実行します。 CASE ELSE 句が存在しなければ、 END CHOOSE 句の次のステートメントを実行します。

例例 1 以下のステートメントは、変数 Weight の値によって異なった処理を行います。

CHOOSE CASE WeightCASE IS<16

Postage=Weight*0.30Method="USPS"

CASE 16 to 48Postage=4.50Method="UPS"

CASE ELSEPostage=25.00Method="FedEx"

END CHOOSE

例 2 以下のステートメントは、シングルラインエディットコントロールの中のテキストを Real 型の値に変換し、その値によって異なった処理を行います。

CHOOSE CASE Real(sle_real.Text)CASE is < 10.99999

sle_message.Text = "Real Case < 10.99999"CASE 11.00 to 48.99999

sle_message.Text = "Real Case 11 to 48.9999CASE is > 48.9999

sle_message.Text = "Real Case > 48.9999"CASE ELSE

sle_message.Text = "Cannot evaluate!"END CHOOSE

130 PowerBuilder


CONTINUE機能 DO...LOOP または FOR...NEXT 文の中で使用して、ループ内のステート

メントをスキップします。 CONTINUE 文はパラメータを取りません。

構文 CONTINUE

解説 DO...LOOP 文または FOR...NEXT 文の中で CONTINUE 文を使うと、制御は次の LOOP 文または NEXT 文に移ります。その回のループ処理に限って、 CONTINUE 文とループの最終文の間のステートメントがスキップされます。ネストされたループ処理では、CONTINUE 文は現行のループ内でステートメントをスキップします。

制御を現行のループ処理の外に移す場合は、 139 ページの「 EXIT」を参照してください。

例例 1 以下のステートメントは、メッセージボックスを B = 2 と B = 3のときの 2 回だけ表示します。 B > 3 になると、 CONTINUE 文の後のステートメントはループの各反復処理においてスキップされます。

integer A=1, B=1DO WHILE A < 100

A = A+1B = B+1IF B > 3 THEN CONTINUEMessageBox("Hi", "B : " + String(B) )

LOOP

例 2 以下のステートメントは、Count > 15 になるまで B に 1 を加算します。

integer A=0, B=0, CountFOR Count = 1 to 100

A = A + 1IF Count > 15 THEN CONTINUEB = B + 1

NEXT

// 実行後、 A=100、 B=15 となります。


CREATE

CREATE機能指定されたオブジェクトデータ型のオブジェクトのインスタンスを

作成します。 CREATE 文の実行後、作成されたオブジェクトのインスタンスのプロパティは、ドット（.）表記を用いて参照できます。

CREATE 文で作成されたオブジェクトのインスタンスは、同じオブジェクトデータ型の変数に保持できます。

形式 1 では、オブジェクトデータ型を直接指定します。形式 2 では、アプリケーションは動的にオブジェクトデータ型を選択できます。

構文形式 1 （オブジェクトデータ型を直接指定）

objectvariable = CREATE objecttype

形式 2 （アプリケーションは動的にオブジェクトデータ型を選択） objectvariable = CREATE USING objecttypestring

解説 CREATE 文は、任意のクラスユーザオブジェクト（mailSession やTransaction などの標準クラスユーザオブジェクトを含む）を初めて参照するときに使用します。

PowerBuilder は、標準クラスユーザオブジェクトのうち、 Message、Error、 Transaction、 DynamicDescriptionArea、 DynamicStagingArea のデフォルトのオブジェクトインスタンスを 1 つずつ作成します。これらのオブジェクトのインスタンスをほかにも作成する場合は、 CREATE文を使用します。

開いているウィンドウに定義されていないメニューが必要な場合は、CREATE 文でそのメニューのインスタンスを作成します。968 ページの

「 PopMenu」を参照してください。


objectvariable データ型が objecttype のグローバル変数、インスタンス変数あるいはローカル変数

objecttype オブジェクトデータ型


objectvariable データ型が、作成されるオブジェクトのクラスか、そのクラスの先祖と同じクラスである、グローバル変数、インスタンス変数あるいはローカル変数

objecttypestring String 型の値。作成するクラスのデータ型の名前を指定します。

132 PowerBuilder


ビジュアルユーザオブジェクトやウィンドウのインスタンスを作成するには、 CREATE 文ではなく、適切な Open 関数を使います。

以下は、メモリを割り当てるために、 CREATE 文を使用しません。

• Integer や String などの標準データ型

• 環境オブジェクトなどの構造体

• AutoInstantiate が TRUE に設定されているオブジェクト

• Open 関数などの関数を使用してインスタンスを作成したオブジェクト

オブジェクト型の動的指定 CREATE USING 文を使用して、アプリケーションはオブジェクトデータ型を動的に選択できます。通常は、先祖オブジェクトのインスタンスとその子孫オブジェクトのインスタンスを作成するために使用します。特定の子孫オブジェクトは、実行時に選択されます。

たとえば、先祖オブジェクト uo_a に uo_a_desc1 と uo_a_desc2 の 2 つの子孫オブジェクトがある場合、アプリケーションの実行時にインスタンスを作成するオブジェクトを選択できます。

uo_a uo_a_varstring ls_objectname

IF ... THENls_objectname = "uo_a_desc1"

ELSEls_objectname = "uo_a_desc2"

END IFuo_a_var = CREATE USING ls_objectname

作成したインスタンスの破棄作成したオブジェクトのインスタンスの使用後、DESTROY 文を呼び出して、そのオブジェクトのインスタンスが使用したメモリを解放することができます。ただし、 DESTROY 文を呼び出すのは、ほかのオブジェクトによってそのオブジェクトが参照されていない場合のみです。ガベージコレクション機能によって、各オブジェクトへの参照数がカウントされ、参照されていないオブジェクトは自動的に破棄されます。

ガベージコレクションについての詳細は、 85 ページの「ガベージコレクション」を参照してください。

例例 1 以下のステートメントでは、新しいトランザクションオブジェクトのインスタンスを作成し、そのインスタンスを変数 DBTrans に格納します。


CREATE

transaction DBTransDBTrans = CREATE transactionDBTrans.DBMS = 'ODBC'

例 2 以下のステートメントは、アプリケーションがユーザオブジェクトのサービスを必要としている場合に（PFC のサービスオブジェクト）、そのサービスを提供するサービスオブジェクトのインスタンスを作成します。サービスオブジェクトにアクセスするスクリプトでは、サービスオブジェクトの関数を呼び出す前に、サービスオブジェクトのインスタンスが存在するかどうかをチェックします。

サービスオブジェクトのインスタンスを作成するオブジェクトは、インスタンス変数として invo_service を宣言します。

n_service invo_service

オブジェクトの Open イベントで、サービスオブジェクトのインスタンスを作成します。

// あるオブジェクトの Open イベントIF (some condition) THEN

invo_service = CREATE n_serviceEND IF

別のスクリプトがサービスオブジェクト n_service の関数を呼び出す場合、そのスクリプトはサービスオブジェクトのインスタンスが作成されているか、変数 invo_service をチェックします。

IF IsValid(invo_service) THENinvo_service.of_perform_some_work( )

END IF

サービスオブジェクトのインスタンスが作成されている場合は、そのインスタンスを破棄する必要があります。

IF isvalid(invo_service) THEN DESTROY invo_service

例 3 データストアオブジェクトのインスタンスを作成する場合は、データストアオブジェクトを使用する前に、 DataObject プロパティにデータウィンドウオブジェクト名を指定して、SetTransObject 関数を呼び出します。

l_ds_delete = CREATE u_dsl_ds_delete.DataObject = 'd_user_delete'l_ds_delete.SetTransObject(SQLCA)li_cnt = l_ds_delete.Retrieve(lstr_data.name)

134 PowerBuilder


例 4 以下の例は、 n_file_service_class は先祖オブジェクトで、n_file_service_class_ansi と n_file_service_class_dbcs がその子孫オブジェクトです。 2 つの子孫オブジェクトは、アプリケーションにサービスを提供するための関数と変数を持ちます。エンドユーザが DBCS 環境で実行しているかどうかによって、インスタンスを作成する子孫オブジェクトを選択します。

n_file_service_class lnv_fileservicestring ls_objectnameenvironment luo_env

GetEnvironment ( luo_env )IF luo_env.charset = charsetdbcs! THEN

ls_objectname = "n_file_service_class_dbcs"ELSE

ls_objectname = "n_file_service_class_ansi"END IF

lnv_fileservice = CREATE USING ls_objectname


DESTROY

DESTROY機能 CREATE 文で作成したオブジェクトのインスタンスを破棄します。

DESTROY 文の実行後は、破棄されたオブジェクトのインスタンスのプロパティを参照することはできません。

構文 DESTROY objectvariable

解説作成したオブジェクトのインスタンスの使用後、DESTROY 文を呼び出して、そのオブジェクトのインスタンスが使用したメモリを解放することができます。ただし、DESTROY 文を呼び出すのは、ほかのオブジェクトによってそのオブジェクトが参照されていない場合のみです。ガベージコレクション機能によって、各オブジェクトへの参照数がカウントされ、参照されていないオブジェクトは自動的に破棄されます。

ガベージコレクションについての詳細は、 85 ページの「ガベージコレクション」を参照してください。

アプリケーションを終了すると、オブジェクトのインスタンスはすべて自動的に破棄されます。

例例 1 次のステートメントでは、 CREATE 文で作成したトランザクションオブジェクトのインスタンス DBTrans を破棄します。

DESTROY DBTrans

例 2 以下の例は、ウィンドウの Open イベントが発生したときにOLEStorage 変数 istg_prod_pic を作成します。ウィンドウを閉じるときには、 Close イベントのスクリプトでそのオブジェクトを破棄します。変数の宣言は、次のとおりです。

OLEStorage istg_prod_pic

ウィンドウの Open イベントでは、オブジェクトのインスタンスを作成して、 OLE ストレージファイルを開きます。

integer li_resultistg_prod_pic = CREATE OLEStorageli_result = stg_prod_pic.Open("PICTURES.OLE")

ウィンドウの Close イベントでは、変数 istg_prod_pic を破棄します。

integer li_resultli_result = istg_prod_pic.Save( )IF li_result = 0 THEN

DESTROY istg_prod_picEND IF


objectvariable データ型が PowerBuilder オブジェクトの変数

136 PowerBuilder


DO...LOOP機能一般的な反復処理ステートメントです。条件が TRUE である間または

TRUE になるまで実行文ブロックを実行します。

DO... LOOP 文には、以下の 4 つの書式があります。

• DO UNTIL 指定した条件が TRUE になるまで実行文ブロックを実行します。条件の最初の評価が TRUE となる場合、実行文ブロックは実行されません。

• DO WHILE 指定した条件が TRUE の間、実行文ブロックを実行します。条件が FALSE になると反復処理は終了します。条件の最初の評価が FALSE となる場合、実行文ブロックは実行されません。

• LOOP UNTIL 実行文ブロックを最低 1 回実行し、指定した条件がTRUE になるまで実行を続けます。

• LOOP WHILE 実行文ブロックを最低 1 回実行し、指定した条件がTRUE の間は実行を続けます。条件が FALSE になると反復処理は終了します。

DO...LOOP 文では、 DO 文は反復処理する実行文ブロックの始まりを示し、 LOOP 文は終わりを示します。

DO...LOOP 文はネストできます。

構文 DO UNTIL conditionstatementblock

LOOP

DO WHILE conditionstatementblock

LOOP

DOstatementblock

LOOP UNTIL condition

DOstatementblock

LOOP WHILE condition

解説条件が TRUE （WHILE に対して）または FALSE （UNTIL に対して）の場合だけ実行文ブロックを実行したいときには、 DO WHILE 文または DOUNTIL 文を使用します。 DO WHILE 文および DO UNTIL 文は、実行文ブロックを実行する前に条件を評価します。


condition 評価する条件

statementblock 反復処理する実行文ブロック


DO...LOOP

実行文ブロックを最低 1 回実行したいときには、LOOP WHILE 文またはLOOP UNTIL 文を使用します。 LOOP WHILE 文と LOOP UNTIL 文は、実行文ブロックの実行後に条件を評価します。

例 DO UNTIL 以下の DO UNTIL 文は、 A > 15 になるまで Beep 関数ブロックを実行します。

integer A = 1, B = 1

DO UNTIL A > 15Beep(A)A = (A + 1) * B

LOOP

DO WHILE 以下の DO WHILE 文は、 A <= 15 の間だけ Beep 関数ブロックを実行します。


DO WHILE A <= 15Beep(A)A = (A + 1) * B

LOOP

LOOP UNTIL 以下の LOOP UNTIL 文は、A > 15 になるまで Beep 関数ブロックを実行します。

integer A = 1, B = 1DO

Beep(A)A = (A + 1) * B

LOOP UNTIL A > 15

LOOP WHILE 以下の LOOP WHILE 文は、A <= 15 の間 Beep 関数ブロックを実行します。


DOBeep(A)A = (A + 1) * B

LOOP WHILE A <= 15

138 PowerBuilder


EXIT機能 DO...LOOP 文または FOR...NEXT 文の中で用いて、制御を現行のループ

処理の外に移します。 EXIT 文はパラメータを取りません。

構文 EXIT

解説 DO...LOOP 文または FOR...NEXT 文の中で EXIT 文を使用すると、制御がLOOP 文または NEXT 文の後のステートメントに移ります。また、ネストされたループ処理の中で、EXIT 文を使用すると、制御が実行中のループの外に移ります。

ループ処理の制御を次の LOOP 文または NEXT 文に移す方法についての詳細は、 131 ページの「 CONTINUE」を参照してください。

例例 1 以下の EXIT 文は、配列 Nbr の要素の値が 0 のときループ処理を終了します。

int Nbr[10]int Count = 1

// 配列 Nbr に値を代入する処理。

DO WHILE Count < 11IF Nbr[Count] = 0 THEN EXITCount = Count + 1

LOOP

MessageBox("Hi", "現在のカウントの値 : " + String(Count))

例 2 以下の EXIT 文は、配列 Nbr の要素の値が 0 のときループ処理を終了します。

int Nbr[10]int Count

// 配列 Nbr に値を代入する処理。

FOR Count = 1 to 10IF Nbr[Count] = 0 THEN EXIT

NEXT

MessageBox("Hi", "現在のカウントの値 : " + String(Count))


FOR...NEXT

FOR...NEXT機能数値に基づいて反復処理を行います。 1 つまたは複数のステートメン

トを、指定した回数だけ実行するときに使います。

構文 FOR varname = start TO end {STEP increment}statementblock

NEXT

解説 start パラメータと end パラメータ increment が正のとき end は start より大きく、increment が負のとき end は start より小さくなければなりません。

increment が正で start が end より大きい場合、または increment が負でstart が end より小さい場合には、 statementblock は実行されません。

start および end を式で指定している場合、ループのたびに式が評価されます。式の結果の値が変わるとループ回数も変わります。次の例では、 DeleteRow 関数でデータウィンドウの行を削除するので、ループごとに RowCount 関数の戻り値が変わります。

FOR n = 1 TO dw_1.RowCount( )dw_1.DeleteRow(1)

NEXT

加算値に変数を用いるには加算値に変数を使用しなければならない場合には、DO...LOOP 文のいずれかの書式を使用し、ループ処理の間にその変数を加算します。

ネスト FOR...NEXT 文は、ネストできます。各 FOR 文には必ず対応する NEXT 文がなければなりません。

NEXT 文の代わりに END FOR 文を使用することもできます。


varname 反復処理カウンタ変数名。どの数値データ型（Integer、 Double、 Real、 Long、 Decimal）でも可能ですが、 Integer 型が最も高速です。

start varname の開始値

end varname の終了値

increment （オプション）

加算値を表す定数。 Increment は定数で varname と同じデータ型でなければなりません。 increment を入力する場合には STEP 文が必要です。 +1 はデフォルトの加算値です。

statementblock 反復処理する実行文ブロック

140 PowerBuilder


オーバーフローの回避start または end が varname のデータ型の上限値を超える場合、varnameはオーバーフローして無限ループになります。以下のステートメントは、 Integer 型の変数 li_int を使用します。

FOR li_int = 1 TO 50000

end に指定した 50000 は Integer 型の上限を超えています。ループ処理で変数 li_int が加算されると、li_int が 50000 になる前にオーバーフローして無限ループになります。

例例 1 以下のステートメントは、 n >=5 かつ n <=25 の間、 A に 10 を加えます。

FOR n = 5 to 25A = A+10

NEXT

例 2 以下のステートメントは、 n >=5 かつ n <=25 の間、 A に 10 を加え、 n に 5 ずつ加算します。

FOR N = 5 TO 25 STEP 5A = A+10

NEXT

例 3 以下の 2 行のステートメントは、パラメータ increment が負でstart が end より小さいので実行されません。

FOR Count = 1 TO 100 STEP -1

IF Count < 1 THEN EXIT // この 2 行は、 Box[Count] = 10 // 実行されません。NEXT

例 4 以下のステートメントは、ネストされた FOR...NEXT 文です。

Int Matrix[100,50,200]FOR i = 1 to 100

FOR j = 1 to 50FOR k = 1 to 200

Matrix[i,j,k]=1NEXTNEXT

NEXT


GOTO

GOTO機能制御をスクリプトの中のあるステートメントから、ラベルの指示する

別のステートメントに移します。

構文 GOTO label

例例 1 以下の GOTO 文は、 Taxable=FALSE の行をスキップします。

Goto NextStep

Taxable=FALSE // このステートメントは、実行されません。NextStep:Rate=Count/Count4

例 2 次の GOTO 文では、ラベル「OK:」があるステートメントに制御を移します。

GOTO OK...OK:...


label 制御を移したいステートメントを指示するラベル。ラベルの識別子のあとにはコロンを付けます（たとえば、OK: ）。 GOTO 文の中ではラベルにはコロンを付けません。

142 PowerBuilder


HALT機能アプリケーションを終了します。

構文 HALT {CLOSE}

解説キーワード CLOSE を伴わない HALT 文は、直ちにそのアプリケーションを終了します。

キーワード CLOSE を伴った HALT 文は、直ちにそのアプリケーションの Close イベントに対するスクリプトを実行して、アプリケーションを終了します。アプリケーションの Close イベントに対するスクリプトがない場合には、直ちにアプリケーションを終了します。

例例 1 以下のステートメントは、シングルラインエディット sle_passwordに、 String 型の変数 CorrectPassword に保持されている値と一致しないパスワードが入力されると、アプリケーションを終了します。

IF sle_password.Text <> CorrectPassword THEN HALT

例 2 以下のステートメントは、シングルラインエディット sle_passwordに、 String 型の変数 CorrectPassword に保持されている値と一致しないパスワードが入力されると、アプリケーションを終了する前に、そのClose イベントのスクリプトを実行します。

IF sle_password.Text <> CorrectPassword &THEN HALT CLOSE


IF...THEN

IF...THEN機能条件が TRUE の場合は、スクリプトで指定した処理を実行します。単一

行書式の形式 1 と、複数行書式の形式 2 があります。

構文形式 1 （単一行書式） IF condition THEN action1 {ELSE action2}

形式 2 （複数行書式） IF condition1 THEN

action1{ ELSEIF condition2 THEN

action2. . . }{ ELSE

action3 }END IF


condition 評価する条件式

action1 条件が TRUE の場合に実行する処理。処理を指定するステートメントは、IF 文と同じ行の単一文でなければなりません。

action2 （オプション）

条件が FALSE の場合に実行する処理。処理を指定するステートメントは、IF 文と同じ行の単一文でなければなりません。


condition1 評価する最初の条件

action1 condition1 が TRUE の場合に実行する処理。処理は、単一行をセミコロンで区切った複数のステートメント、または複数行で記述されたステートメントでもかまいません。最低 1 つの処理が必要です。

condition2 （オプション）

condition1 が FALSE の場合に実行する処理。IF...THEN 文の中に複数の ELSEIF...THEN 文を記述できます。

action2 condition2 が TRUE の場合に実行する処理。処理は、単一行をセミコロンで区切った複数のステートメント、または複数行で記述されたステートメントでもかまいません。

action3 （オプション）

前の条件のいずれも TRUE でなかった場合に実行する処理。処理は、単一行をセミコロンで区切った複数のステートメント、または複数行で記述されたステートメントでもかまいません。

144 PowerBuilder


解説継続行文字を使用して、単一行書式を複数行に渡って記述できます。

複数行書式の IF...THEN 文は、 END IF で完結させなければなりません。

例例 1 次の単一行書式の IF...THEN 文では、 Num の値が 1 の場合にウィンドウ w_first を開き、それ以外の場合にはウィンドウ w_rest を開きます。

IF Num = 1 THEN Open(w_first) ELSE Open(w_rest)

例 2 次の単一行書式の IF...THEN 文では、シングルラインエディットsle_State の値が "TX" の場合にメッセージを表示します。継続行文字を使用して、単一行のステートメントを 2 行で記述しています。

IF sle_State.text="TX" THEN &MessageBox("Hello","Tex")

例 3 次の複数行書式の IF...THEN 文では、 w_first と w_second の 2 つのウィンドウの X 座標の値を比較します。 w_first が w_second の右側にある場合、 w_first は画面の左端に移動します。

IF w_first.X > w_second.X THENw_first.X = 0

END IF

例 4 次の複数行書式の IF...THEN 文では、アプリケーションに以下の処理を実行させます。

• X と Y が等しい場合、ビープ音を 2 回鳴らす

• X と Z が等しい場合、リストボックス lb_parts を表示し、 5 つ目の項目をハイライト表示する

• X がブランクの場合、リストボックス lb_choose を表示する

• 上記のどの条件も TRUE でない場合は、コマンドボタン cb_emptyを非表示にし、コマンドボタン cb_full を表示する

IF X=Y THENBeep(2)

ELSEIF X=Z THENShow (lb_parts); lb_parts.SetState(5,TRUE)

ELSEIF X=" " THENShow (lb_choose)

ELSEHide(cb_empty)Show(cb_full)

END IF


RETURN

RETURN機能イベントや関数の実行を直ちに停止します。

構文 RETURN { expression }

解説ユーザのアクションによってイベントが起動された場合、そのイベントに対するスクリプトの中に RETURN 文が使用されていると、そのイベントの実行を停止して、ユーザからの次のアクションを待ちます。

また、スクリプトから関数やイベントを呼び出す場合、呼び出された関数やイベントのスクリプトの中に RETURN 文が使用されていると、関数やイベントが呼び出された行に制御を移します（値を返します）。

例例 1 以下のスクリプトを実行すると、システムはビープ音を 1 回鳴らします。 2 番目の Beep 関数は実行されません。

Beep(1)RETURN

Beep(1) // このステートメントは実行されません。

例 2 ユーザ定義関数の中の以下のステートメントは、変数 Arg2 が 0でないときには変数 Arg1 を変数 Arg2 で割った結果を返し、 0 のときには -1 を返します。

IF Arg2 <> 0 THENRETURN Arg1/Arg2

ELSERETURN -1

END IF


expression 関数の戻り値（または式）。戻り値は、関数の定義で指定した戻り値のデータ型と同じでなければなりません。

146 PowerBuilder


THROW機能ユーザ定義例外の例外処理を手動でトリガするときに使用します。

構文 THROW exlvalue

解説 THROW 予約語に続く変数は、 Throwable データ型から派生した有効なオブジェクトインスタンスか、その有効なオブジェクトインスタンスを生成する式であることが必要です。たとえば、次の式を使用できます。

THROW create ExceptionType

ExceptionType は Throwable 型のオブジェクトです。

インスタンス化されていない例外を送出しようとすると、取得する例外情報が NullObjectError のみになり、必要な例外情報を再び取得することができなくなります。

メソッドスクリプトでは、メソッドプロトタイプ内で宣言している例外か、try-catch ブロック内で処理する例外のみ送出できます。プロトタイプの Throws 文内で宣言していなかったり、適切な try-catch ブロックで囲んでいないユーザ定義の例外を送出しようとすると、 PowerScriptコンパイラはエラーメッセージを表示します。

RuntimeError または RuntimeError の子孫が送出されると、行番号情報を含むインスタンス変数が THROW 文の発生する場所に埋め込まれます。エラーが処理され、再び送出されると、この情報は、 NULL に設定されるまで更新されません。

例 long ll_resultll_result = myConnection.ConnectToServer()

ConnectionException exex = create ConnectionExceptionex.connectResult = ll_resultTHROW ex

end if


exlvalue Throwable 型の変数（またはオブジェクトの有効なインスタンスを評価する式）。通常、送出されるオブジェクト型は、 Throwable 型を継承する、システム Exception クラスから派生したユーザ定義例外クラスです。


THROWS

THROWS機能メソッドがトリガする例外型を宣言するのに使用します。メソッドプ

ロトタイプの一部になります。

構文 methodname ( {arguments} ) THROWS ExceptionType { , ExceptionType, ... }

解説内部使用のみ。

PowerBuilder スクリプトの関数呼び出しに THROWS 句をを入力したり追加することはありません。ただし、 PowerBuilder 関数に THROWS 句を追加したり、 pbm イベント ID によって定義されていないユーザイベントに追加することはできます。

関数やイベントのプロトタイプに THROWS 句を追加する方法については、『PowerBuilder ユーザーズガイド』マニュアルを参照してください。例外処理についての詳細は、『アプリケーションテクニック』マニュアルを参照してください。


methodname 例外を送出するメソッドの名前

arguments 例外を送出するメソッドの引数。メソッドによっては、メソッドの引数は省略できます。

ExceptionType Throwable 型のオブジェクト。通常、送出されるオブジェクト型は、システム Exception クラスから派生したユーザ定義の例外クラスです。 1 つのメソッドに対して複数の例外を定義する場合、カンマで例外型を区切ることにより、同じ句内で各例外型を送出できます。

148 PowerBuilder


TRY...CATCH...FINALLY...END TRY機能例外の原因になるコードを分離し、特定の型の例外が発生した場合に

何をすべきかを説明し、例外が発生したかどうかに関わらず、ファイルやネットワークの接続を閉じる（およびオブジェクトを元の状態に戻す）ことができるようにします。

マシンコードマシンコードの DLL を構築する必要がある場合、例外処理は使用できません。マシンコードを構築するプロセスは、例外処理構造をサポートしていないためです。例外処理を使用するコードからマシンコード DLL をコンパイルしようとしても失敗し、エラーメッセージが表示されます。 P コード（PBD）とマシンコード（DLL）のうち、どちらを使うかの判別基準については、『アプリケーションテクニック』マニュアルの配布用アプリケーションのパッケージ化の章を参照してください。

構文 TRYtrystatements

CATCH ( ThrowableType1 exIdentifier1 )catchstatements1

CATCH ( ThrowableType2 exIdentifier2 )catchstatements2

...CATCH ( ThrowableTypeN exIdentifierN )

catchstatementsNFINALLY

cleanupstatementsEND TRY


trystatements 例外を送出する可能性のあるコードのブロック

ThrowableTypeN キャッチする例外のオフジェクト型。 FINALLY ブロックを指定している場合は、 CATCH ブロックを省略可能です。 CATCH ブロックは複数指定することもできます。 try-catch ブロック内の CATCH ブロックごとに、対応する例外オブジェクト型とその型のローカル変数を指定する必要があります。

exIdentifierN ThrowableTypeN 型のローカル変数

catchstatementsN キャッチする例外の処理コード

cleanupstatements クリーンアップコード。 1 つ以上の CATCH ブロックを指定している場合は、FINALLY ブロックを省略可能です。


TRY...CATCH...FINALLY...END TRY

解説 TRY ブロックは、例外を送出する可能性のあるコードを分離するために使用します。なお、 TRY ブロックとは、 TRY キーワードと CATCHキーワードの間のステートメントブロックです。CATCH 句を指定していない場合は、 TRY キーワードと FINALLY キーワードの間のステートメントブロックになります。 TRY ブロック内のステートメントは、ステートメントのブロック全体が実行されたり、そのブロック内の一部のステートメントが例外の送出を引き起こすまで、無条件に実行されます。

TRY ブロック内で送出される例外を処理するには 1 つまたは複数のCATCH ブロックを使用します。例外が送出されると、 TRY ブロックの実行は停止し、その例外が CATCH キーワードの後の識別子が示す型と同じ型、またはその子孫である場合にのみ、最初の CATCH ブロック内のステートメントが実行されます。

送出された例外が最初の CATCH ブロックの識別子と同じ型またはその子孫でない場合、例外はこの CATCH ブロックによる処理を受けません。 CATCH ブロックが複数ある場合は、その出現順に評価が実行されます。例外をどの CATCH ブロックによっても処理できない場合は、FINALLY ブロックのステートメントが実行されます。

例外は、外側にネストされた try-catch ブロックへのコールスタックの解放を続けます。外側にネストされたブロックがない場合、アプリケーションオブジェクトの SystemError イベントが起動します。

送出される例外がない場合、 FINALLY ブロックがあればこのブロックの最初から実行が続行され、なければ END TRY 文に続く行から実行が続行されます。

関連項目 THROW

150 PowerBuilder

第 8 章 SQL 文

この章についてこの章では、埋め込み SQL 文と動的 SQL 文について説明し、さらにそのスクリプトでの使い方を解説します。

内容項目ページ

スクリプトにおける SQL 文の使い方 152CLOSE Cursor 155CLOSE Procedure 156COMMIT 157CONNECT 158DECLARE Cursor 159DECLARE Procedure 160DELETE 162DELETE Where Current of Cursor 163DISCONNECT 164EXECUTE 165FETCH 166INSERT 167OPEN Cursor 168ROLLBACK 169SELECT 170SELECTBLOB 172UPDATE 174UPDATEBLOB 175UPDATE Where Current of Cursor 177

動的 SQL の使い方 177

動的 SQL 書式 1 182





スクリプトにおける SQL 文の使い方

スクリプトにおける SQL 文の使い方PowerScript は、スクリプトにおける標準の埋め込み SQL 文と動的 SQL文をサポートしています。通常、 PowerScript は、これらの SQL 文の中で使用される DBMS 固有のすべての句と予約語をサポートしています。たとえば、 PowerBuilder では、 SELECT 文の中で用いられる DBMS固有の組み込み関数をサポートしています。

埋め込み SQL 文についての詳細は、オンラインヘルプを参照してください。

スクリプトにおける PowerScript 変数の参照

SQL 文の中で定数を参照できる箇所では、 PowerScript 変数をその先頭にコロン（:）を付けることによって代用できます。これにはどのような PowerScript 変数でも使用できます。次の INSERT 文は、定数値を使用しています。

INSERT INTO EMPLOYEE ( SALARY )VALUES ( 18900 ) ;

上記のステートメントを、 PowerScript 変数で定数を参照する形にすると、以下のようになります。

int Sal_varSal_var = 18900INSERT INTO EMPLOYEE ( SALARY )

VALUES ( :Sal_var ) ;

インジケータ変数の使い方

PowerBuilder は、データベース検索後に NULL 値や変換エラーの判別に使用されるインジケータ変数（Indicator Variables）をサポートしています。インジケータ変数は Integer 型で、 FETCH 文や SELECT 文のホスト変数リスト（HostVariableList）において指定します。

各インジケータ変数とインジケータ変数が示している変数は、スペース（カンマは付けない）で区切ります。たとえば、次のステートメントは、インジケータ変数を含まないホスト変数リストです。

:Name, :Address, :City

次のステートメントは、インジケータ変数を含む上記と同じホスト変数リストです。

:Name :IndVar1, :Address :IndVar2, :City :IndVar3

インジケータ変数は、以下のいずれかの値を持ちます。

数値意味

0 有効な NULL 以外の値

-1 NULL 値-2 変換エラー

152 PowerBuilder

第 8 章 SQL 文

エラーの報告あるカラムのデータ型が、関連する変数のデータ型と一致しない場合、すべての DBMS が必ず変換エラーを返すとは限りません。

次のステートメントは、インジケータ変数 IndVar2 を使用して、Addressに NULL 値が入っているかどうかを調べます。

if IndVar2 = -1 then...

また、次のステートメントは、インジケータ変数を使用せずにPowerScript の IsNull 関数を使用して、Address に NULL 値が入っているかどうかを調べます。

if IsNull( Address ) then ...

次のステートメントは、インジケータ変数 IndVar3 を使用して、 Cityに NULL 値を設定します。

IndVar3 = -1

また、次のステートメントは、インジケータ変数を使用せずにPowerScript の SetNull 関数を使用して、 City に NULL 値を設定します。

SetNull( City )

スクリプトにおけるエラー処理

これまで例示した SQL 文のスクリプトにはエラー処理が含まれていませんが、各ステートメントの実行後に、トランザクションオブジェクトの成否コード（SQLCode プロパティ）をテストすることをお勧めします。以下に、 SQLCode プロパティの値とその意味を示します。

DELETE 文、 FETCH 文、および UPDATE 文など、特定のステートメントの実行後には、これらのアクションが少なくとも 1 行に対して適用されたことを確認するため、トランザクションオブジェクトのSQLNRows プロパティもチェックするとよいでしょう。

SQLErrText プロパティと SQLDBCode プロパティ Transaction オブジェクトの String 型の SQLErrText プロパティには、データベースベンダが提供するエラーメッセージが保持されています。また、 Long 型のSQLDBCode プロパティには、データベースベンダが定めたステータスコードが保持されています。

値意味

0 正常に終了しました。

100 検索する行が見つかりません。

-1 エラーが発生し、ステートメントの実行は失敗しました。SQLErrText プロパティまたは SQLDBCode プロパティの値を使用して詳細情報を入手してください。


スクリプトにおける SQL 文の使い方

IF SQLCA.SQLCode = -1 THEN

MessageBox("SQL エラー ", SQLCA.SQLErrText)END IF

標準 SQL 文の貼り付け

以下の SQL 文をスクリプトや関数に貼り付けることができます。

• SQL カーソルおよびストアドプロシージャの宣言

• カーソルを使用する FETCH 文、 UPDATE 文、および DELETE 文

• カーソルを使用しない SELECT 文、 INSERT 文、 UPDATE 文、および DELETE 文

スコープ（適用範囲）の詳細については、 31 ページの「変数の宣言場所」を参照してください。

カーソルおよびストアドプロシージャを、グローバル変数、インスタンス変数、共有変数、またはローカル変数のスコープで宣言できます。カーソルまたはプロシージャは、ペインタバーの［SQL 貼付］ボタンを使用して、スクリプトビューで宣言できます。

ペインタバーの［SQL 貼付］ボタン、またはポップアップメニューの［形式を指定して貼り付け｜ SQL］を使用して、スクリプトビュー、関数ペインタ、およびデータベースペインタの対話型 SQL ビューで標準の埋め込み SQL 文をペイントできます。

サポートしている SQL 文

一般に、PowerScript 言語では、PowerScript がサポートしている SQL 文における DBMS 固有の機能をサポートしています。たとえば、PowerScript は、 SELECT 文中の DBMS 固有の組み込み関数をサポートしています。

しかし、スクリプトのコンパイルが成功するためには、SELECT 句を含むすべての SQL 文に、 FROM 句を含まなければなりません。この問題を解決するためには、 FROM 句を持たない SELECT 文に " ダミー " のテーブルを使用する FROM 句を追加します。次に例を示します。

string resselect user_name() into:res from dummy;select db_name() into:res from dummy;select date('2001-01-02:21:20:53') into:res from dummy;

154 PowerBuilder

第 8 章 SQL 文

CLOSE Cursor機能 CursorName で指定された SQL カーソルをクローズして、 CursorName

の処理を終了します。

構文 CLOSE CursorName ;

解説クローズするカーソルは、その時点で、OPEN 文によってオープンされていなければなりません。また、カーソルを宣言したステートメントの中でトランザクションオブジェクトが指定されているため、 CLOSECursor 文で USING TransactionObject 句を用いることはできません。

CLOSE Procedure 文は、フェッチ後の SQLCode プロパティの値が 100（行が見つからない）のときに実行されるスクリプトの中でよく使用されます。

エラー処理CLOSE Cursor 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例次のステートメントは、カーソル Emp_cursor をクローズします。

CLOSE Emp_cursor ;


CursorName クローズするカーソル名


CLOSE Procedure

CLOSE Procedure機能 ProcedureName で指定された SQL プロシージャをクローズして、

ProcedureName の処理を終了します。

ストアドプロシージャのサポートすべての DBMS がストアドプロシージャをサポートしているとは限りません。

構文 CLOSE ProcedureName;

解説クローズするプロシージャは、その時点で、 EXECUTE 文によって実行されていなければなりません。また、プロシージャを宣言したステートメントの中でトランザクションオブジェクトが指定されているため、CLOSE Procedure 文で USING TransactionObject 句を用いることはできません。

CLOSE Procedure 文は、結果集合を返すプロシージャをクローズするときにのみ使用してください。結果集合を返さないプロシージャは、PowerBuilder によって自動的にクローズされ、 SQLCode プロパティの値に 100 が設定されます。

CLOSE Procedure 文は、フェッチ後の SQLCode プロパティの値が 100（行が見つからない）のときに実行されるスクリプトの中でよく使用されます。

エラー処理CLOSE Procedure 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例次のステートメントは、ストアドプロシージャ Emp_proc をクローズします。

CLOSE Emp_proc ;


ProcedureName クローズするストアドプロシージャ名

156 PowerBuilder

第 8 章 SQL 文

COMMIT機能指定されたトランザクションオブジェクトに対して前回の COMMIT、

ROLLBACK、または CONNECT 以降に行われたすべてのデータベース処理を永久的に更新します。

サーバコンポーネントにおける COMMIT と ROLLBACK の使用サーバコンポーネントの中に埋め込まれた COMMIT コマンドとROLLBACK コマンドは、UseContextObject の DBParm パラメータの設定によって、効果が異なる場合があります。

UseContextObject のパラメータについては、『データベースとの接続』マニュアルを参照してください。トランザクションサーバへのコンポーネントの配布については、『アプリケーションテクニック』マニュアルを参照してください。

構文 COMMIT {USING TransactionObject};

解説 COMMIT 文は、データベースとの接続は解除しませんが、オープンしているカーソルまたはプロシージャをすべてクローズします（PowerBuilder における DISCONNECT 文は、 COMMIT 文を発行することに注意してください）。

エラー処理COMMIT 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例例 1 次のステートメントは、デフォルトトランザクションオブジェクトで指定されたデータベースに対するすべての処理内容をコミットします。

COMMIT ;

例 2 次のステートメントは、トランザクションオブジェクトEmp_tran で指定されたデータベースに対するすべての処理内容をコミットします。

COMMIT USING Emp_tran ;


TransactionObject 前回の COMMIT、 ROLLBACK、または CONNECT以降の、データベースに対するあらゆる処理を確定したいトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。


CONNECT

CONNECT機能指定されたデータベースに接続します。

構文 CONNECT {USING TransactionObject};

解説 CONNECT 文は、デフォルトトランザクションオブジェクトまたは指定されたトランザクションオブジェクトを使用してデータベース操作（INSERT、 UPDATE、または DELETE）を行う前に実行しなければなりません。

エラー処理CONNECT 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例例 1 次のステートメントは、デフォルトトランザクションオブジェクトで指定されたデータベースに接続します。

CONNECT ;

例 2 次のステートメントは、トランザクションオブジェクト Emp_tranで指定されたデータベースに接続します。

CONNECT USING Emp_tran ;


TransactionObject 接続するデータベースに対する必要な接続情報を保持しているトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。

158 PowerBuilder

第 8 章 SQL 文

DECLARE Cursor機能指定されたトランザクションオブジェクトに対してカーソルを宣言

します。

構文 DECLARE CursorName CURSOR FOR SelectStatement {USING TransactionObject};

解説 DECLARE Cursor 文は非実行コマンドであり、変数の宣言に似ています。

ローカルカーソルを宣言するには、スクリプトビューでスクリプトを開き、ペインタバーの［SQL 貼付］を使用するか、［編集｜形式を指定して貼り付け］メニューを選択します。グローバル、インスタンス、または共有のカーソルを宣言するには、スクリプトビューの最初のドロップダウンリストから［Declare］を選択し、 2 つ目のドロップダウンリストから［Global Variables］、［Instance Variables］、または［SharedVariables ］を選択します。

グローバル変数、インスタンス変数，共有変数、およびローカル変数のスコープについては、 31 ページの「変数の宣言場所」を参照してください。

例次のステートメントは、デフォルトトランザクションオブジェクトで指定されたデータベースに対して、カーソル Emp_cur を宣言します。さらに、このステートメントは変数 Sal_var を参照します。この変数には、OPEN Emp_cur 文を実行する前に、適切な値を設定しておく必要があります。

DECLARE Emp_cur CURSOR FORSELECT employee.emp_number, employee.emp_nameFROM employeeWHERE employee.emp_salary > :Sal_var ;


CursorName 有効な PowerBuilder 名SelectStatement 有効な SELECT 文TransactionObject カーソルを宣言するトランザクションオブジェク

ト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。


DECLARE Procedure

DECLARE Procedure機能指定されたトランザクションオブジェクトに対してプロシージャを

宣言します。

ストアドプロシージャのサポートすべての DBMS がストアドプロシージャをサポートしているとは限りません。

構文 DECLARE ProcedureName PROCEDURE FOR StoredProcedureName@Param1=Value1, @Param2=Value2,...{USING TransactionObject};

解説 DECLARE Procedure 文は非実行コマンドであり、変数の宣言に似ています。

ローカルカーソルを宣言するには、スクリプトビューでスクリプトを開き、ペインタバーの［SQL 貼付］を使用するか、［編集｜形式を指定して貼り付け］メニューを選択します。グローバル、インスタンス、または共有のプロシージャを宣言するには、スクリプトビューの最初のドロップダウンリストから［Declare］を選択し、 2 つ目のドロップダウンリストから［Global Variables］、［Instance Variables］、または［SharedVariables］を選択します。



ProcedureName 有効な PowerBuilder 名StoredProcedureName データベース中のストアドプロシージャ名

@Paramn=Valuen ストアドプロシージャで指定されたパラメータ（引数）と有効な PowerBuilder の式。n はパラメータと値の個数を表します。

TransactionObject プロシージャを宣言するトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。

160 PowerBuilder

第 8 章 SQL 文

例例 1 次のステートメントは、デフォルトトランザクションオブジェクトで指定された Sybase ASE のストアドプロシージャ GetName に対して、プロシージャ Emp_proc を宣言するものです。このステートメントは、変数 Emp_name_var と Emp_sal_var を参照します。これらの変数には、EXECUTE Emp_proc 文を実行する前に、適切な値を設定しておく必要があります。

DECLARE Emp_proc procedure for GetName@emp_name = :Emp_name_var, @emp_salary = :Emp_sal_var ;

例 2 次のステートメントは、デフォルトトランザクションオブジェクトで指定された ORACLE のストアドプロシージャ GetName に対して、プロシージャ Emp_proc を宣言するものです。このステートメントは、変数 Emp_name_var と Emp_sal_var を参照します。これらの変数には、EXECUTE Emp_proc 文を実行する前に、適切な値を設定しておく必要があります。

DECLARE Emp_proc procedure for GetName(:Emp_name_var, :Emp_sal_var) ;


DELETE

DELETE機能 Criteria で指定された条件によって TableName で指定されたテーブル

の行を削除します。

構文 DELETE FROM TableName WHERE Criteria {USING TransactionObject};

解説エラー処理DELETE 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。 DELETE 文が正常に終了したかどうかは、 SQLCode をテストして成否コードを調べれば確認できます。ただし、 WHERE 句で指定した条件に合う行がなく、 1 行も削除されなかった場合でも、 SQLCode プロパティには 0 が設定されます。少なくとも1 行が削除されたことを確認するには、トランザクションオブジェクトの SQLNRows プロパティをチェックしてください。

例例 1 次のステートメントは、デフォルトトランザクションオブジェクトで指定されたデータベースの Employee テーブルから、 Emp_numカラムの値が 100 より小さいデータ行を削除します。

DELETE FROM Employee WHERE Emp_num < 100 ;

例 2 以下のスクリプトは、トランザクションオブジェクト Emp_tranで指定されたデータベースの Employee テーブルから、 Emp_num カラムの値がシングルラインエディット sle_number に入力された値と等しいデータ行を削除します。

int Emp_numEmp_num = Integer(sle_number.Text)DELETE FROM Employee

WHERE Employee.Emp_num = :Emp_num ;

Integer 型の変数 Emp_num を WHERE 句で使用するときには、PowerBuilder 変数であることを示すために、変数名の先頭にコロンを付ける必要があります。


TableName 行を削除するテーブル名

Criteria 削除する行を指定する条件

TransactionObject 削除するテーブルが格納されているデータベースを指定したトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。

162 PowerBuilder

第 8 章 SQL 文

DELETE Where Current of Cursor機能カーソルが現在位置している行を削除します。

DELETE Where Current of Cursor 文のサポートすべての DBMS が DELETE Where Current of Cursor 文をサポートしているとは限りません。

構文 DELETE FROM TableName WHERE CURRENT OF CursorName;

解説カーソルが現在位置している行を削除します。カーソルを宣言したステートメントの中でトランザクションオブジェクトが指定されているため、 DELETE Where Current of Cursor 文で USING TransactionObject 句を用いることはできません。

エラー処理DELETE Where Current of Cursor 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例次のステートメントは、 Employee テーブルからカーソル Emp_cur が現在位置している行を削除します。

DELETE FROM Employee WHERE current of Emp_curs ;


TableName 行を削除するテーブル名

CursorName テーブルを指定するカーソル名


DISCONNECT

DISCONNECT機能指定されたトランザクションオブジェクトに対して COMMIT 文を実行

してから、データベースとの接続を解除します。

構文 DISCONNECT {USING TransactionObject};

解説エラー処理DISCONNECT 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例例 1 次のステートメントは、デフォルトトランザクションオブジェクトで指定されたデータベースとの接続を解除します。

DISCONNECT ;

例 2 次のステートメントは、トランザクションオブジェクトEmp_tran で指定されたデータベースとの接続を解除します。

DISCONNECT USING Emp_tran ;


TransactionObject 接続を解除し、かつ前回の COMMIT、 ROLLBACK、または CONNECT 以降の、データベースに対するあらゆる処理内容を確定したいトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。

164 PowerBuilder

第 8 章 SQL 文

EXECUTE機能 ProcedureName で指定されたあらかじめ宣言されているプロシージャ

を実行します。

構文 EXECUTE ProcedureName;

解説プロシージャを宣言したステートメントの中でトランザクションオブジェクトが指定されているため、EXECUTE 文で USING TransactionObject句を用いることはできません。

エラー処理EXECUTE 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例次のステートメントは、ストアドプロシージャ Emp_proc を実行します。

EXECUTE Emp_proc ;


ProcedureName 実行するプロシージャの DECLARE 文で割り当てられた名前。プロシージャはあらかじめ宣言されていなければなりません。 ProcedureName は、データベースに格納されているプロシージャ名と同一とは限りません。


FETCH

FETCH機能 Cursor または Procedure が現在位置している行の次の行をフェッチし

ます。

構文 FETCH Cursor | Procedure INTO HostVariableList;

解説カーソルまたはプロシージャを宣言したステートメントの中でトランザクションオブジェクトが指定されているため、 FETCH 文で USINGTransactionObject 句を用いることはできません。

使用している DBMS が標準の（デフォルトの） FETCH NEXT 文以外のFETCH 文書式をサポートしている場合には、 FETCH FIRST、 FETCHPRIOR、または FETCH LAST 文を使用できます。

エラー処理FETCH 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。 FETCH 文が正常に終了したかどうかは、SQLCode をテストして成否コードを調べれば確認できます。ただし、WHERE 句で指定した条件に合う行がなく、 1 行もフェッチされなかった場合でも、 SQLCode プロパティには 100 が設定されます。少なくとも 1 行がフェッチされたことを確認するには、トランザクションオブジェクトの SQLNRows プロパティをチェックしてください。

例例 1 以下のスクリプトは、カーソル Emp_cur の宣言で指定したSELECT 句で検索されたデータをフェッチし、その値を変数 Emp_numと Emp_name に代入します。

int Emp_numstring Emp_nameFETCH Emp_cur INTO :Emp_num, :Emp_name ;

例 2 以下のスクリプトは、カーソル Emp_cur からデータをフェッチし、そのデータを変数 Emp_num とシングルラインエディットsle_emp_name に保持します。次に、変数 Emp_num を Integer 型からString 型に変換して、その値をシングルラインエディット sle_emp_numに代入します。

int Emp_numstring Emp_nameFETCH Emp_cur INTO :emp_num, :emp_name ;sle_emp_num.Text = string(Emp_num)sle_emp_name.Text = Emp_name


Cursor or Procedure フェッチする行を指示するカーソル名またはプロシージャ名

HostVariableList 検索されたデータ値が保持される PowerScript 変数

166 PowerBuilder

第 8 章 SQL 文

INSERT機能 RestOfInsertStatement で指定されたテーブルに、 1 つまたは複数の新し

い行を挿入します。

構文 INSERT RestOfInsertStatement {USING TransactionObject} ;

解説エラー処理INSERT 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例例 1 以下のスクリプトは、デフォルトトランザクションオブジェクトで指定されている Employee テーブルに 1 行挿入し、 Emp_nbr カラムと Emp_name カラムに変数 EmpNbr と EmpName の値を代入します。

int EmpNbrstring EmpName...INSERT INTO Employee (employee.Emp_nbr,

employee.Emp_name)VALUES (:EmpNbr, :EmpName) ;

例 2 以下のスクリプトは、トランザクションオブジェクト Emp_tranの Employee テーブルに 1 行挿入します。挿入する行の Emp_nbr カラムと Emp_name カラムの値は、シングルラインエディット sle_number とsle_name に入力された値になります。

int EmpNbrstring EmpNameEmpNbr = Integer(sle_number.Text)EmpName = sle_name.TextINSERT INTO Employee (employee.Emp_nbr,

employee.Emp_name)VALUES (:EmpNbr, :EmpName) USING Emp_tran ;


RestOfInsertStatement INSERT 文の中身（INTO 句、カラムのリスト、値またはソースのリスト）

TransactionObject 目的のテーブルが格納されているデータベースを指定したトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。


OPEN Cursor

OPEN Cursor機能カーソルを宣言したときに指定された SELECT 文を実行して、カーソ

ルをオープンします。

構文 OPEN CursorName ;

解説カーソルを宣言したステートメントの中でトランザクションオブジェクトが指定されているため、 OPEN Cursor 文で USING TransactionObject句を用いることはできません。

エラー処理OPEN Cursor 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例次のステートメントは、カーソル Emp_cur を開きます。

OPEN Emp_curs ;


CursorName オープンするカーソル名

168 PowerBuilder

第 8 章 SQL 文

ROLLBACK機能指定されたデータベースにおける前回の COMMIT、 ROLLBACK、または

CONNECT 以降のすべてのデータベース処理を取り消します。

サーバコンポーネントにおける COMMIT と ROLLBACK の使用サーバコンポーネントの中に埋め込まれた COMMIT コマンドとROLLBACK コマンドは、UseContextObject の DBParm パラメータの設定によって、効果が異なる場合があります。

UseContextObject のパラメータについては、『データベースとの接続』マニュアルを参照してください。トランザクションサーバへのコンポーネントの配布については、『アプリケーションテクニック』マニュアルを参照してください。

構文 ROLLBACK {USING TransactionObject} ;

解説 ROLLBACK 文は、データベースとの接続は解除しませんが、オープンしているカーソルまたはプロシージャをすべてクローズします。

エラー処理ROLLBACK 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

例例 1 次のステートメントは、デフォルトトランザクションオブジェクトで指定されたデータベースにおけるすべての処理内容を取り消します。

ROLLBACK ;

例 2 次のステートメントは、トランザクションオブジェクトEmp_tran で指定されたデータベースにおけるすべての処理内容を取り消します。

ROLLBACK USING emp_tran ;


TransactionObject 前回の COMMIT、 ROLLBACK、または CONNECT以降の、データベースに対するあらゆる処理内容を取り消すトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。


SELECT

SELECT機能 RestOfSelectStatement で指定されたテーブルから 1 行検索します。

構文 SELECT RestOfSelectStatement {USING TransactionObject} ;

解説 SELECT 文が複数行を返した場合には、エラーになります。

エラー処理SELECT 文の実行後に SQLCode プロパティの値をテストして、成否を確認することをお勧めします。

INTO 句を使用した場合、 PowerBuilder では、カラムとテーブルの存在をチェックするだけで、取得したカラムのデータ型がホスト変数のデータ型と一致するかどうかについては検証しません。データ型の一致については、開発者のほうで確認してください。すべてのデータベースのデータ型が PowerBuilder のデータ型と同じであるとは限らないため、注意が必要です。

例以下のスクリプトは、Employee テーブルの Emp_nbr カラムの値が変数Emp_num と等しい行の Emp_LName と Emp_FName カラムのデータを検索し、そのデータをシングルラインエディット sle_LName とsle_FName に代入します。トランザクションオブジェクトにはEmp_tran が使用されています。

int Emp_numstring Emp_lname, Emp_fnameEmp_num = Integer(sle_Emp_Num.Text)

SELECT employee.Emp_LName, employee.Emp_FNameINTO :Emp_lname, :Emp_fnameFROM EmployeeWHERE Employee.Emp_nbr = :Emp_numUSING Emp_tran ;

IF Emp_tran.SQLCode = 100 THEN


RestOfSelectStatement SELECT 文の中身（カラムのリスト、 INTO 句、FROM 句、 WHERE 句、そのほかの句）

TransactionObject 検索するテーブルが格納されているデータベースを指定したトランザクションオブジェクト名。この句は、デフォルト（SQLCA）以外のトランザクションオブジェクトに対して必要となります。

170 PowerBuilder

第 8 章 SQL 文

MessageBox("従業員の照会 ", &"従業員が見つかりません ")

ELSEIF Emp_tran.SQLCode > 0 then

MessageBox("データベースエラー ", &Emp_tran.SQLErrText, Exclamation!)

END IFsle_Lname.text = Emp_lnamesle_Fname.text = Emp_fname


SELECTBLOB

SELECTBLOB機能 RestOfSelectStatement で指定されたテーブル中の 1 行から、 1 つの Blob

型カラムを 1 つ検索します。

構文 SELECTBLOB RestOfSelectStatement {USING TransactionObject} ;

解説 SELECTBLOB 文が複数行を返した場合には、エラーになります。

エラー処理SELECTBLOB 文の実行後に成否を確認することをお勧めします。また、トランザクションオブジェクトの SQLNRows プロパティをチェックして、行が更新されたかどうかを確認できます。 SQLCode プロパティまたは SQLDBCode プロパティでは、 SELECTBLOB 文の実行結果の成否はわかりません。

INTO 句内のホスト変数のリスト（ターゲットパラメータ）にインジケータ変数を挿入すれば、空の Blob （長さがゼロの Blob）および変換エラーを調べることができます。

データベース情報Sybase ASE および Microsoft SQL Server を使用している場合は、SELECTBLOB 関数を呼び出す前に、トランザクションオブジェクトのAutoCommit プロパティを TRUE に設定する必要があります。AutoCommit プロパティについては、『データベースとの接続』マニュアルを参照してください。

例以下のスクリプトは、Employee テーブルの Emp_num カラムの値が 100である行から Blob 型カラム Emp_pic を検索し、その値を Blob 型変数Emp_id_pic に代入します。次に、ピクチャ p_1 に Emp_id_pic のビットマップを設定します。トランザクションオブジェクトには Emp_tran が使用されています。


RestOfSelectStatement SELECT 文の中身（INTO 句、FROM 句、WHERE句）


172 PowerBuilder

第 8 章 SQL 文

Blob Emp_id_picSELECTBLOB Emp_pic

INTO :Emp_id_pic FROM EmployeeWHERE Employee.Emp_Num = 100USING Emp_tran ;

p_1.SetPicture(Emp_id_pic)

Blob 型変数 Emp_id_pic を SELECTBLOB 文の INTO 句で使用するときは、（PowerScript の）ホスト変数であることを示すために、変数名の先頭にコロンを付ける必要があります。


UPDATE

UPDATE機能 RestOfUpdateStatement で指定された行を更新します。

構文 UPDATE TableName RestOfUpdateStatement {USING TransactionObject} ;

解説エラー処理UPDATE 文の実行後に成否を確認することをお勧めします。 SQLCodeプロパティの値をテストできます。なお、 WHERE 句で指定した条件に合う行がなく、１行も更新されなかった場合、 SQLCode プロパティには 0 が設定されます。トランザクションオブジェクトの SQLNRows プロパティをチェックして、行が更新されたかどうかを確認できます。

例以下のスクリプトは、トランザクションオブジェクト Emp_tran で指定されたデータベース中の Employee テーブルにおいて、 Emp_num カラムの値がシングルラインエディット sle_Number に入力された値と等しい行を更新します。

int Emp_numEmp_num=Integer(sle_Number.Text )UPDATE Employee

SET emp_name = :sle_Name.TextWHERE Employee.emp_num = :Emp_num USING Emp_tran ;

IF Emptran.SQLNRows > 0 THENCOMMIT USING Emp_tran ;

END IF

Integer 型の変数 Emp_num およびシングルラインエディット sle_Nameを UPDATE 文で使用するときには、これらが（PowerScript の）ホスト変数であることを示すために、変数名の先頭にコロンを付ける必要があります。


TableName 行を更新するテーブル名

RestOfUpdateStatement UPDATE 文の中身（SET 句と WHERE 句）


174 PowerBuilder

第 8 章 SQL 文

UPDATEBLOB機能 TableName で指定された行の BlobColumn カラムを更新します。

構文 UPDATEBLOB TableName SET BlobColumn = BlobVariableRestOfUpdateStatement {USING TransactionObject} ;

解説エラー処理UPDATEBLOB 文の実行後に成否を確認することをお勧めします。また、トランザクションオブジェクトの SQLNRows プロパティをチェックして、行が更新されたかどうかを確認できます。 SQLCode プロパティまたは SQLDBCode プロパティでは、 SELECTBLOB 文の実行結果の成否はわかりません。

データベース情報Sybase ASE および Microsoft SQL Server を使用している場合は、UPDATEBLOB 関数を呼び出す前に、トランザクションオブジェクトのAutoCommit プロパティを True に設定する必要があります。AutoCommit プロパティについては、『データベースとの接続』マニュアルを参照してください。

例以下のスクリプトは、トランザクションオブジェクト Emp_tran で指定されたデータベース中の Employee テーブルにおいて、 Emp_num カラムの値が 100 の行の Blob 型カラム Emp_pic を更新します。

int fhblob Emp_id_picfh = FileOpen("c:¥emp_100.bmp", StreamMode!)IF fh <> -1 THEN

FileRead(fh, emp_id_pic)FileClose(fh)


TableName 更新するテーブル名

BlobColumn TableName の更新するカラム名。このカラムはBlob 型でなければなりません。

BlobVariable Blob 型の PowerScript 変数

RestOfUpdateStatement UPDATE 文の中身（WHERE 句）



UPDATEBLOB

UPDATEBLOB Employee SET emp_pic = :Emp_id_picWHERE Emp_num = 100USING Emp_tran ;

END IF

IF Emptran.SQLNRows > 0 THENCOMMIT USING Emp_tran ;

END IF

Blob 型の変数 Emp_id_pic を UPDATEBLOB 文で使用するときには、（PowerScript の）ホスト変数であることを示すために、コロンを付ける必要があります。

176 PowerBuilder

第 8 章 SQL 文

UPDATE Where Current of Cursor機能 SetStatement で指定された値を使用して、カーソルが現在位置している

行を更新します。

構文 UPDATE TableName SetStatement WHERE CURRENT OF CursorName ;

解説カーソルを宣言したステートメントの中でトランザクションオブジェクトが指定されているため、 UPDATE Where Current of Cursor 文でUSING TransactionObject 句を用いることはできません。

例以下のステートメントは、 Employee テーブルのカーソル Emp_curs が位置している行を更新します。

UPDATE EmployeeSET salary = 17800WHERE CURRENT of Emp_curs ;

動的 SQL の使い方概要通常、データベースアプリケーションは決められた処理を行うため、

スクリプトを記述してコンパイルする時点で、その処理を記述したSQL 文が完成しています。しかし、 PowerBuilder が記述したい埋め込み SQL 文（たとえば、データ定義言語）をサポートしていない場合、また、 SQL 文のパラメータや使用すべき書式がコンパイル時にはわからない場合は、アプリケーション実行時に SQL 文を作成する必要があります。これを動的 SQL といいます。動的 SQL 文で使用するパラメータは、プログラムが実行される状況に応じて変わる可能性があります。

Adaptive Server® Anywhere の使い方Adaptive Server Anywhere での動的 SQL の使い方については、 AdaptiveServer Anywhere の『 Programming Interfaces』マニュアルを参照してください。


TableName 行を更新するテーブル名

SetStatement SET ステートメントの後に、カンマで区切られたColumnName = value という形式のリストを続けたもの

CursorName テーブルを参照するカーソル名


動的 SQL の使い方

4 つの書式動的 SQL 文の 4 つの書式 PowerBuilder には、コンパイル時の状況に応じて、以下の 4 つの動的 SQL 書式が用意されています。

以下のものを用いて、コンパイル時の状況に応じた処理を行います。

• PowerBuilder の動的 SQL 文

• CLOSE 文、DECLARE 文、 FETCH 文、OPEN 文、および EXECUTE 文の動的 SQL バージョン

• PowerBuilder データ型の DynamicStagingArea および DynamicDescriptionArea の変数

前提条件例では、デフォルトトランザクションオブジェクト（SQLCA）に有効な値が割り当てられていること、CONNECT 文が正常に終了していることを前提としています。また、例ではエラーチェックを行っていませんが、通常は、各 SQL 文の後で SQLCode プロパティの値をチェックするべきです。

動的 SQL 文以下に、 PowerBuilder の動的 SQL 文を示します。

DESCRIBE DynamicStagingAreaINTO DynamicDescriptionArea ;

EXECUTE {IMMEDIATE} SQLStatement{USING TransactionObject} ;

EXECUTE DynamicStagingAreaUSING ParameterList ;

EXECUTE DYNAMIC Cursor | ProcedureUSING ParameterList ;

OPEN DYNAMIC Cursor | ProcedureUSING ParameterList ;

EXECUTE DYNAMIC Cursor | ProcedureUSING DESCRIPTOR DynamicDescriptionArea ;

書式書式を用いる状況

書式 1 入力パラメータを持たず、結果集合を返さないステートメント

書式 2 入力パラメータを持つ、結果集合を返さないステートメント

書式 3 コンパイル時に入力パラメータと結果集合カラムの内容が判明している、結果集合を返すステートメント

書式 4 コンパイル時に入力パラメータまたは結果集合カラム、あるいはその両方とも判明していない、結果集合を返すステートメント

178 PowerBuilder

第 8 章 SQL 文

OPEN DYNAMIC Cursor | ProcedureUSING DESCRIPTOR DynamicDescriptionArea ;

PREPARE DynamicStagingAreaFROM SQLStatement {USING TransactionObject} ;

2 つのデータ型 DynamicStagingArea DynamicStagingArea は PowerBuilder のデータ型です。 PowerBuilder はこのデータ型の変数を使用して、次に続く動的SQL 文で使用される情報を保持します。

DynamicStagingArea は、動的 SQL 文とトランザクションオブジェクト間の唯一の通信手段であり、 PowerBuilder が内部的に使用します。開発者は、DynamicStagingArea の保持する情報にはアクセスできません。

PowerBuilder は、SQLSA という DynamicStagingArea 型のグローバル変数を用意しているので、 DynamicStagingArea 型の変数が必要なときにこのデフォルト変数を使用することができます。

必要であれば、 DynamicStagingArea データ型の別のオブジェクト変数を宣言して作成できます。以下のステートメントは、動的 SQL 文で参照する変数を、事前に宣言し作成します。

DynamicStagingArea dsa_stage1dsa_stage1 = CREATE DynamicStagingArea

EXECUTE 文が終了した後は、 SQLSA を参照できません。

DynamicDescriptionArea DynamicDescriptionArea は PowerBuilder のデータ型です。 PowerBuilder は、このデータ型の変数を使用して、動的 SQL の書式 4 で用いられる入出力パラメータについての情報を保持します。

PowerBuilder は、 SQLDA という DynamicDescriptionArea 型のグローバル変数を用意しているので、DynamicDescriptionArea 型の変数が必要なときにこのデフォルト変数を使用することができます。

必要であれば、DynamicDescriptionArea データ型の別のオブジェクト変数を宣言して使用できます。以下のステートメントは、動的 SQL 文で参照する変数を、事前に宣言し作成します。

DynamicDescriptionArea dda_desc1dsa_desc1 = CREATE DynamicDescriptionArea

SQLDA については、 187 ページの「動的 SQL 書式 4」を参照してください。

動的 SQL を使用する前に

動的 SQL 文を使用するときには、以下のことが重要です。

• 書式 1 以外のすべての書式における DynamicStagingArea 型の変数の準備


動的 SQL の使い方

• 書式 4 における DynamicDescriptionArea 型の変数の記述

• 動的 SQL 文の実行順序

準備と記述 SQLSAS ステージングエリアは、 SQL 文の実行とトランザクションオブジェクト間の唯一の通信手段であるため、SQL 文を正しく記述しておかないとエラーが発生します。

SQLSA および SQLDA 以外にも、 DynamicStagingArea 型およびDynamicDescriptionArea 型の変数を宣言できます。しかし、別の変数を宣言する必要があるのは、スクリプトで複数の動的 PREPARE 文を同時に使用する場合だけです。

以下の動的カーソルは有効です。

DECLARE my_cursor DYNAMIC CURSOR FOR SQLSA ;PREPARE SQLSA FROM "SELECT emp_id FROM employee" ;OPEN DYNAMIC my_cursor ;

以下の動的カーソルは無効です。PREPARE 文が存在しないので実行エラーが発生します。

DECLARE my_cursor DYNAMIC CURSOR FOR SQLSA ;OPEN DYNAMIC my_cursor ;

動的 SQL 文の実行順序スクリプトにおいて動的 SQL 文を記述する場所はさほど重要ではありませんが、書式 2、 3、 4 では動的 SQL 文を実行する順序は非常に重要です。動的 SQL 文を実行する際には、以下の点に注意してください。

1 DECLARE 文と PREPARE 文は、ほかの動的 SQL 文の前に実行します。

2 書式 3、 4 では、 OPEN 文を FETCH 文の前に実行します。

3 CLOSE 文は最後に実行します。

PREPARE 文が複数ある場合には、実行順序によって SQLSA の内容が異なります。

以下のスクリプトは、正しい順序で記述されています。

DECLARE my_cursor DYNAMIC CURSOR FOR SQLSAstring sql1, sql2sql1 = "SELECT emp_id FROM department "&WHERE salary > 90000"sql2 = "SELECT emp_id FROM department "&WHERE salary > 20000"

IF deptId = 200 thenPREPARE SQLSA FROM :sql1 USING SQLCA ;

180 PowerBuilder

第 8 章 SQL 文

ELSEPREPARE SQLSA FROM :sql2 USING SQLCA ;

END IF

OPEN DYNAMIC my_cursor ; // my_cursor にマップされる// SELECT 文は条件によって// 異なります。


動的 SQL 書式 1

動的 SQL 書式 1機能入力パラメータを必要とせず、結果集合を返さない SQL 文を実行する

ときには、書式 1 を使用します。この書式では、あらゆる形式のデータ定義言語（DDL）を実行できます。

構文 EXECUTE IMMEDIATE SQLStatement {USING TransactionObject} ;

例以下のスクリプトは、 Employee テーブルを作成します。このステートメントは、文字列 Mysql に CREATE 文を保持しています。

Sybase ASE と Microsoft SQL Server をご使用の場合ASE または SQL Server データベースに接続している場合は、 CREATE文を実行する前に AUTOCOMMIT プロパティに TRUE を設定してください。

string MysqlMysql = "CREATE TABLE Employee "&

+"(emp_id integer not null,"&+"dept_id integer not null, "&+"emp_fname char(10) not null, "&+"emp_lname char(20) not null)"

EXECUTE IMMEDIATE :Mysql ;

以下のスクリプトは、トランザクションオブジェクト My_trans が存在し、データベースと正常に接続されていることを前提としています。

string MysqlMysql="INSERT INTO dept Values (1234, 'Purchasing')" EXECUTE IMMEDIATE :Mysql USING My_trans ;


SQLStatement 有効な SQL 文を示す文字列。この文字列は通常、文字列定数または先頭にコロンを付けたPowerBuilder の変数（たとえば :mysql）です。この文字列は 1 行に収める必要があり、式を用いることはできません。

TransactionObject （オプション）

データベースを指定するトランザクションオブジェクト名

182 PowerBuilder

第 8 章 SQL 文

動的 SQL 書式 2機能入力パラメータを必要とし、結果集合を返さない SQL 文を実行すると

きには、書式 2 を使用します。この書式では、あらゆる形式のデータ定義言語（DDL）を実行できます。

構文 PREPARE DynamicStagingArea FROM SQLStatement {USING TransactionObject} ;

EXECUTE DynamicStagingArea USING {ParameterList} ;

解説 NULL 値を指定するときには、 SetNull 関数を使用します。

例以下のスクリプトは、 SQLSA 上に入力パラメータを 1 つ持つ DELETE文を作成し、 PowerScript 変数 Emp_id_var の値を用いて実行します。

INT Emp_id_var = 56PREPARE SQLSA

FROM "DELETE FROM employee WHERE emp_id=?" ;EXECUTE SQLSA USING :Emp_id_var ;

以下のスクリプトは、 SQLSA 上に入力パラメータを 2 つ持つ INSERT文を作成し、 PowerScript 変数 Dept_id_var と Dept_name_var の値を用いて実行します。 Dept_name_var には NULL 値が設定されています。

INT Dept_id_var = 156String Dept_name_varSetNull(Dept_name_var)PREPARE SQLSA

FROM "INSERT INTO dept VALUES (?,?)" ;EXECUTE SQLSA USING :Dept_id_var,:Dept_name_var ;


DynamicStagingArea DynamicStagingArea 型の変数名（通常は、 SQLSA）

SQLSA 以外の DynamicStagingArea 変数が必要な場合は、 CREATE 文で変数を宣言し、インスタンス化してから使用してください。

SQLStatement 有効な SQL 文を示す文字列。この文字列は通常、文字列定数または先頭にコロンを付けた PowerBuilder の変数（たとえば :mysql）です。この文字列は 1 行に収める必要があり、式を用いることはできません。

SQL 文の各入力パラメータを疑問符（?）で代用する必要があります。各パラメータの値は記述した順序で代入されます。

TransactionObject（オプション）


ParameterList （オプション）

カンマで区切られた PowerScript 変数のリスト。各PowerScript 変数の先頭にはコロン（:）を付けます。


動的 SQL 書式 3

動的 SQL 書式 3機能入力パラメータと結果集合カラムの内容がコンパイル時に判明してい

る場合、結果集合を返す SQL 文を実行するときは、書式 3 を使用します。

構文 DECLARE Cursor | Procedure DYNAMIC CURSOR | PROCEDURE FOR DynamicStagingArea ;

PREPARE DynamicStagingArea FROM SQLStatement {USING TransactionObject} ;

OPEN DYNAMIC Cursor {USING ParameterList} ;

EXECUTE DYNAMIC Procedure{USING ParameterList} ;

FETCH Cursor | ProcedureINTO HostVariableList ;

CLOSE Cursor | Procedure ;

解説 NULL 値を指定するときには、 SetNull 関数を使用します。

DECLARE 文は非実行文です。また、グローバル変数として宣言することができます。


Cursor または Procedure 使用するカーソル名またはプロシージャ名

DynamicStagingArea DynamicStagingArea 型の変数名（通常は、SQLSA）


SQLStatement 有効な SQL SELECT 文を示す文字列。この文字列は通常、文字列定数または先頭にコロンを付けたPowerBuilder 変数（たとえば :mysql）です。この文字列は 1 行に収める必要があり、式を用いることはできません。 SQL 文の各入力パラメータを疑問符（?）で代用する必要があります。各パラメータの値は記述した順序で代入されます。



ParameterList （オプション）

カンマで区切られた PowerScript 変数のリスト。各PowerScript 変数の先頭にはコロン（:）を付けます。

HostVariableList 検索したデータ値を格納する PowerScript 変数のリスト

184 PowerBuilder

第 8 章 SQL 文


書式 3 で使用する FETCH 文と CLOSE 文は、標準の埋め込み SQL 文と同じです。

ローカル変数のスコープでカーソルまたはプロシージャを宣言するには、スクリプトビューでスクリプトを開き、ペインタバーの［SQL 貼付］を使用するか、［編集｜形式を指定して貼り付け］メニューを選択します。グローバル変数、インスタンス変数、または共有変数のスコープでカーソルまたはプロシージャを宣言するには、スクリプトビューの最初のドロップダウンリストから［Declare］を選択し、 2 つ目のドロップダウンリストから［Global Variables］、［Instance Variables］、または［Shared Variables］を選択します。


例例 1 以下のスクリプトは、カーソル my_cursor を SQLSA に関連付け、SQLSA 上に SELECT 文を作成し、カーソルをオープンして、現行の行の従業員番号を PowerScript 変数 Emp_id_var に返します。

integer Emp_id_varDECLARE my_cursor DYNAMIC CURSOR FOR SQLSA ;PREPARE SQLSA FROM "SELECT emp_id FROM employee" ;OPEN DYNAMIC my_cursor ;FETCH my_cursor INTO :Emp_id_var ;CLOSE my_cursor ;

静的な埋め込み SQL 文の場合と同じように、ループでカーソルを処理することができます。

例 2 以下のスクリプトは、カーソル my_cursor を SQLSA に関連付け、SQLSA 上に入力パラメータを 1 つ持つ SELECT 文を作成し、カーソルをオープンして、 SELECT 文のパラメータに変数 Emp_state_var の値を代入します。そのカーソル行の従業員番号を PowerBuilder 変数Emp_id_var に返します。

DECLARE my_cursor DYNAMIC CURSOR FOR SQLSA ;integer Emp_id_varstring Emp_state_var = "MA"string sqlstatement

sqlstatement = "SELECT emp_id FROM employee "&+"WHERE emp_state = ?"

PREPARE SQLSA FROM :sqlstatement ;


動的 SQL 書式 3

OPEN DYNAMIC my_cursor using :Emp_state_var ;FETCH my_cursor INTO :Emp_id_var ;CLOSE my_cursor ;

例 3 以下のスクリプトは前述の例と同じ処理を行いますが、ストアドプロシージャ Emp_select を用いています。

// emp_select の構文は以下のようになっています。// "SELECT emp_id// FROM employee WHERE emp_state=@stateparm"DECLARE my_proc DYNAMIC PROCEDURE FOR SQLSA ;integer Emp_id_varstring Emp_state_var

PREPARE SQLSA FROM "emp_select @stateparm=?" ;Emp_state_var = "MA"EXECUTE DYNAMIC my_proc USING :Emp_state_var ;FETCH my_proc INTO :Emp_id_var ;CLOSE my_proc ;

186 PowerBuilder

第 8 章 SQL 文

動的 SQL 書式 4機能入力パラメータの数または結果集合のカラム数、あるいは両方がコン

パイル時に判明していない場合、結果集合を返す SQL 文を実行するときは、書式 4 を使用します。

構文 DECLARE Cursor | Procedure DYNAMIC CURSOR | PROCEDURE FOR DynamicStagingArea ;

PREPARE DynamicStagingArea FROM SQLStatement{USING TransactionObject} ;

DESCRIBE DynamicStagingAreaINTO DynamicDescriptionArea ;

OPEN DYNAMIC Cursor | ProcedureUSING DESCRIPTOR DynamicDescriptionArea ;

EXECUTE DYNAMIC Cursor | ProcedureUSING DESCRIPTOR DynamicDescriptionArea ;

FETCH Cursor | Procedure USING DESCRIPTOR DynamicDescriptionArea ;

CLOSE Cursor | Procedure ;


Cursor または Procedure 使用するカーソル名またはプロシージャ名

DynamicStagingArea DynamicStagingArea 型の変数名（通常は、SQLSA）


SQLStatement 有効な SQL SELECT 文を示す文字列。この文字列は通常、文字列定数または先頭にコロンを付けた PowerBuilder の変数（たとえば :mysql）です。この文字列は 1 行に収める必要があり、式を用いることはできません。

SQL 文の各入力パラメータを疑問符（?）で代用する必要があります。各パラメータの値は記述した順序で代入されます。



DynamicDescriptionArea DynamicDescriptionArea 型の変数名（通常は、SQLDA）。

SQLDA 以外の DynamicDescriptionArea 変数が必要な場合は、 CREATE 文で変数を宣言し、インスタンス化してから使用してください。


動的 SQL 書式 4

解説 DECLARE 文は非実行文です。また、グローバル変数として宣言することができます。


ローカル変数のスコープでカーソルまたはプロシージャを宣言するには、スクリプトビューでスクリプトを開き、ペインタバーの［SQL 貼付］を使用するか、［編集｜形式を指定して貼り付け］メニューを選択します。グローバル変数、インスタンス変数、または共有変数のスコープでカーソルまたはプロシージャを宣言するには、スクリプトビューの最初のドロップダウンリストから［Declare］を選択し、 2 つ目のドロップダウンリストから［Global Variables］、［Instance Variables］、または［Shared Variables］を選択します。


プロパティ情報へのアクセス DynamicDescriptionArea 型の変数に SQL文が記述されると、その DynamicDescriptionArea 型の変数のプロパティを調べることによって、下表に示す情報を入手できます。

パラメータ値の設定とアクセス DynamicDescriptionArea 型の変数には、入力パラメータ値の配列と出力パラメータ値の配列を保持しています。入力パラメータの値は、 SetDynamicParm 関数を使用して配列に設定します。また、以下の関数を使用して、出力パラメータの値を配列から入手できます。

GetDynamicDate GetDynamicDateTime GetDynamicNumber GetDynamicString GetDynamicTime

情報プロパティ

入力パラメータの数 NumInputs

入力パラメータのデータ型を保持する配列

InParmType

出力パラメータの数 NumOutputs

出力パラメータのデータ型を保持する配列

OutParmType

188 PowerBuilder

第 8 章 SQL 文

これらの関数の詳細については、 611 ページの「 GetDynamicDate」、613 ページの「 GetDynamicDateTime」、 615 ページの

「 GetDynamicNumber」、 616 ページの「 GetDynamicString」、および 617 ページの「 GetDynamicTime」を参照してください。

パラメータのデータ型以下のカタログデータ型は、入力パラメータと出力パラメータのデータ型を示すのに用います。

TypeBoolean!TypeDate!TypeDateTime!TypeDecimal!TypeDouble!TypeInteger!TypeLong!TypeReal!TypeString!TypeTime!TypeUInt!TypeULong!TypeUnknown!

入力パラメータ PREPARE 文の各入力パラメータのデータ型と値は、開発者が設定できます。 DESCRIBE 文が実行されるときに PowerBuilderによって SQLDA の NumInputs プロパティに値が代入されます。この値を SetDynamicParm 関数で使用すれば、個々の入力パラメータのデータ型と値を設定できます。入力パラメータはオプションですが、使用する場合には、 OPEN 文または EXECUTE 文を実行する前に入力パラメータの値をすべて代入しておく必要があります。

出力パラメータ PREPARE 文の各出力パラメータのデータ型と値にアクセスできます。データベースが出力パラメータ記述子をサポートしている場合、 DESCRIBE 文が実行されるときに PowerBuilder によってSQLDA の NumOutputs プロパティの値が生成されます。データベースが出力パラメータ記述子をサポートしていない場合は、 FETCH 文が実行されるときに NumOutputs プロパティの値が生成されます。

NumOutputs プロパティの出力パラメータ数を関数で用いれば、OutParmType プロパティの保持する出力パラメータのデータ型配列から個々のパラメータのデータ型を入手できます。データ型を入手すれば、 FETCH 文の後で適切な関数を呼び出して出力値を検索できます。

例例 1 以下のスクリプトは、出力パラメータ記述子が 1 つしかなく、データ型が Integer であるものとして記述されています。また、CHOOSE CASE 文をループで処理するように拡張すると、出力パラメータ記述子とそのデータ型をいくつでもサポートできます。


動的 SQL 書式 4

string Stringvar, Sqlstatementinteger IntvarSqlstatement = "SELECT emp_id FROM employee"PREPARE SQLSA FROM :Sqlstatement ;DESCRIBE SQLSA INTO SQLDA ;DECLARE my_cursor DYNAMIC CURSOR FOR SQLSA ;OPEN DYNAMIC my_cursor USING DESCRIPTOR SQLDA ;FETCH my_cursor USING DESCRIPTOR SQLDA ;

// FETCH 文が正常終了した場合、出力記述子配列は、// 結果集合の最初の行から // 返された値を保持します。// SQLDA.NumOutputs プロパティは、出力記述子の数を// 保持します。// SQLDA.OutParmType 配列は、// NumOutput エントリを保持し、各エントリは// カタログデータ型 ParmType // （TypeInteger! または TypeString!）の値を保持します。CHOOSE CASE SQLDA.OutParmType[1]

CASE TypeString!Stringvar = GetDynamicString(SQLDA, 1)

CASE TypeInteger!Intvar = GetDynamicNumber(SQLDA, 1)

END CHOOSECLOSE my_cursor ;

例 2 以下のスクリプトは、 String 型の入力パラメータ記述子が 1 つあるものとして、入力パラメータに MA を設定します。

string SqlstatementSqlstatement = "SELECT emp_id FROM employee "&

+"WHERE emp_state = ?"PREPARE SQLSA FROM :Sqlstatement ;

DESCRIBE SQLSA INTO SQLDA ;

// DESCRIBE 文が正常終了した場合、// OPEN 文の実行前に入力記述子配列の入力記述子に// 値を代入しておく必要があります。

DECLARE my_cursor DYNAMIC CURSOR FOR SQLSA ;SetDynamicParm(SQLDA, 1, "MA")

OPEN DYNAMIC my_cursor USING DESCRIPTOR SQLDA ;

FETCH my_cursor USING DESCRIPTOR SQLDA ;

// FETCH 文が正常終了した場合、出力記述子配列は、

190 PowerBuilder

第 8 章 SQL 文

// 前述の例と同じように // 結果集合の最初の行から// 返される値を保持します。

CLOSE my_cursor ;


動的 SQL 書式 4

192 PowerBuilder

第 9 章 PowerScript のイベント

この章についてこの章では、イベントの種類について説明した後で、データウィンドウとデータストア以外の PowerBuilder のすべてのコントロールとオブジェクトに対するイベントとそのイベント ID、引数、戻り値について解説します。解説と例では、イベントスクリプトで一般的に行われる処理内容について説明します。

データウィンドウとデータストアのイベントについては、『データウィンドウリファレンス』マニュアルを参照してください。

内容イベントは、アルファベット順に解説されています。

イベントについてイベントにはいくつかの種類があります。

表 9-1: PowerBuilder のイベントの種類

イベント ID、引数、戻り値に関する以下の解説は、すべての種類のイベントに適用されます。

イベントの種類イベントを起動させるもの

イベント ID のあるシステムイベント

ユーザの操作、ほかのシステムメッセージ、スクリプトによる呼び出し

イベント ID のないシステムイベント

PowerBuilder メッセージ、スクリプトによる呼び出し

イベント ID のあるユーザ定義イベント

ユーザの操作、ほかのシステムメッセージ、スクリプトによる呼び出し

イベント ID のないユーザ定義イベント ID

スクリプトによる呼び出し


イベントについて

イベント ID イベント ID は、システムメッセージとイベントを対応付けするものです。ユーザ操作やシステムアクティビティによって起動されるイベントには、必ず、イベント ID があります。イベント ID を持つ一般的なイベントが、 PowerBuilder のオブジェクトに対して定義されています。この章で解説されているのは、この種のイベント ID を持つイベントです。また、ほかのシステムメッセージのために、イベント宣言用のダイアログボックスで表示されるイベント ID リストを使用して、独自のイベントを定義することもできます。

イベント ID のないイベントアプリケーションオブジェクトの Open イベントのように、システムイベントによっては、イベント ID がないものがあります。このようなシステムイベントは、システムアクティビティにではなく、 PowerBuilder のアクティビティに対応付けられています。これらのイベントは、 PowerBuilder によって適切なときに起動されます。

引数システムが起動するイベントシステムイベントは、引数をそれぞれ持っています。 PowerBuilder がシステムメッセージに応答してイベントを起動するときに、引数に値が提供されます。引数は、そのイベントのスクリプトで参照できます。

ユーザが起動するシステムイベントシステムイベントを別のイベントのスクリプトで起動する場合、必要な引数を指定しなければなりません。たとえば、次のステートメントによってウィンドウの Clicked イベントから DoubleClicked イベントを起動できます。この際、DoubleClickedイベントに対し引数 flags、 xpos、 ypos を渡します。

w_main.EVENT DoubleClicked(flags, xpos, ypos)

DoubleClicked はシステムイベントなので、引数の内容は固定です。つまり引数を独自に追加することはできません。

引数を指定しないイベントの呼び出し方法CALL 文を使用すれば、引数を指定しないでシステムイベントを起動することができます。しかし、 CALL 文は下位互換性の目的でのみ残されており、 127 ページの「 CALL」で説明している場合を除き、新しいアプリケーションでの使用は避けてください。

戻り値戻り値はどこに行くのかほとんどのイベントには戻り値があります。システムがイベントを起動する場合、システムに戻り値が返されます。

スクリプトがユーザ定義イベントやシステムイベントを起動する場合には、代入文によって戻り値を取得することができます。

li_rtn = w_main.EVENT process_info(mydata)

194 PowerBuilder

第 9 章 PowerScript のイベント

イベントをポストとして起動する場合、ポストしたスクリプトが実際に実行されるときには、呼び出し元のスクリプトはすでに終了しているため、戻り値は失われます。ポストされるイベントに対して代入文を挿入すると、コンパイルエラーとなります。

リターンコード戻り値のあるシステムイベントでは、デフォルトリターンコードとして 0 が返されます。この値は「特別なアクションをせずに処理を続行する」という意味です。イベントによっては、イベント後の処理を変更するためにリターンコードが追加されています。たとえば、リターンコードの値に応じて、エラーメッセージ表示を省略したり、行われた変更を取り消すことができます。

RETURN 文はイベントスクリプトに必ずしも記述しなくてもかまいませんが、通常は、RETURN 文を記述しておくことが推奨されます。戻り値のあるイベントに RETURN 文が記述されていない場合、イベントは0 を返します。

システムイベントによっては戻り値がないものがあります。これらのイベントに対して RETURN 文を記述すると、コンパイルエラーとなります。

先祖イベントスクリプトの戻り値

子孫オブジェクトのイベントでなんらかの処理を実行するとき、その処理が先祖イベントスクリプトが返す戻り値に依存することがあります。このような場合、 AncestorReturnValue というローカル変数を使うことができます。この変数は、自動的に宣言され、先祖イベントの値が代入されます。

AncestorReturnValue については、117 ページの「先祖オブジェクトの関数とイベントの呼び出し」を参照してください。

ユーザ定義イベントイベント ID のあるイベントシステムメッセージによって起動されるユーザ定義イベントを宣言する場合は、イベント ID のリストから適切なイベント ID を選択します。イベント宣言用のダイアログボックスに表示される pbm （PowerBuilder Message）コードは、システムメッセージに対応しています。

イベント ID に関連付けられている戻り値と引数は、イベント宣言の一部となります。これらはシステムメッセージに対応するものなので、修正することはできません。

システムメッセージが発生すると、 PowerBuilder は対応するイベントを起動し、イベントの引数に値を渡します。

イベント ID のないイベントシステムメッセージに対応付けられないユーザイベントを宣言するときは、イベント ID を選択しません。

この場合、独自の引数と戻り値のデータ型をイベント宣言用のダイアログボックスで指定することができます。


イベントについて

イベント ID を持たないイベントは、ユーザ操作やシステムアクティビティによっては起動されません。アプリケーションのスクリプトで起動しなければなりません。

詳細についてシステムイベントなど、イベントを起動する際の呼び出し構文の詳細については、 113 ページの「 PowerBuilder の関数とイベントの呼び出し構文」を参照してください。

ユーザ定義イベントの詳細については、『PowerBuilder ユーザーズガイド』マニュアルを参照してください。

196 PowerBuilder

第 9 章　PowerScript のイベント

Activate機能ウィンドウがアクティブになる直前に発生します。

イベント ID

引数なし

リターンコード Long 型。リターンコードの値とその意味は以下のとおりです（RETURN文によって指定します）。

0 処理を続行します。

解説 Activate イベントが発生すると、ウィンドウ上でタブ順序の最初のオブジェクトにフォーカスが移ります。ウィンドウに表示されているオブジェクトがない場合は、ウィンドウがフォーカスを得ます。

Activate イベントは新たに開かれたウィンドウに対しても発生します。これは、ウィンドウが開かれた後に、そのウィンドウがアクティブになるためです。

Activate イベントは、メニュー項目を使用可能にしたり使用不可にするのによく用いられます。

例例 1 次のコードは、ウィンドウの Activate イベントにおいて、m_frameの［ファイル］メニューの［シート］メニュー項目を使用不可にします。

m_frame.m_file.m_sheet.Enabled = FALSE

例 2 次のコードは、ウィンドウがアクティブになるときに、 w_sheetシートを上重ね表示で開きます。

w_sheet.ArrangeSheets(Layer!)

関連項目 CloseOpenShow

イベント ID オブジェクト

pbm_activate ウィンドウ


BeginDrag

BeginDragBeginDrag イベントは、オブジェクトによって引数の内容が異なります。

構文 1 リストビューコントロールに対して

機能ユーザがリストビューコントロール内でマウスの左ボタンを押して、ドラッグを開始するときに発生します。

イベント ID

引数



解説ユーザがマウスボタンを押してドラッグを開始すると、ドラッグの可能、不可能に関わらず、 BeginDrag イベントと BeginRightDrag イベントが発生します。ドラッグを可能にするには、次のようにします。

• DragAuto プロパティを TRUE に設定します。リストビューのDragAuto プロパティが TRUE の場合、ユーザがクリックすると自動的にドラッグモードになります。

• Drag 関数を呼び出します。 DragAuto プロパティが FALSE の場合は、BeginDrag イベントスクリプトで Drag 関数を呼び出し、ドラッグ操作を開始します。

リストビュー項目を別のコントロールにドラッグすると、ドラッグ関連の標準イベント（DragDrop、 DragEnter、 DragLeave、 DragWithin）が発生します。ほかのコントロールがリストビューの境界内にドラッグされると、同様なドラッグ関連のイベントが発生します。

オブジェクト構文

リストビューコントロール構文 1ツリービューコントロール構文 2


pbm_lvnbegindrag リストビュー

引数説明

index Integer 型。値によって渡されます（ドラッグされている ListViewItem のインデックス）。

198 PowerBuilder


例次の例はリストビュー項目をリストビューから別のリストビューに移動します。 Ilvi_dragged_object は ListViewItem 型のウィンドウインスタンス変数です。リストビュー項目をコピーする場合は、移動元のリストビューからリストビュー項目を削除するコードを省いてください。

次のコードは、移動元のリストビューの BeginDrag イベントのスクリプトです。

// ツリービューの DragAuto プロパティが FALSE の場合This.Drag(Begin!)

This.GetItem(This.SelectedIndex(), &ilvi_dragged_object)

// 移動でなくコピーの場合は、次の 2 行を省くことThis.DeleteItem(This.SelectedIndex())This.Arrange()

次のコードは、移動先のリストビューの DragDrop イベントのスクリプトです。

This.AddItem(ilvi_dragged_object)This.Arrange()

関連項目 BeginRightDragDragDropDragEnterDragLeaveDragWithin

構文 2 ツリービューコントロールに対して

機能ユーザがツリービューコントロールのラベル上でマウスの左ボタンを押して、ドラッグを開始するときに発生します。

イベント ID

引数


pbm_tvnbegindrag ツリービュー

引数説明

handle Long 型。値によって渡されます（ドラッグされている TreeViewItem のハンドル）。


BeginDrag




• DragAuto プロパティを TRUE に設定します。ツリービューのDragAuto プロパティが TRUE の場合、ユーザがクリックすると自動的にドラッグモードになります。

• Drag 関数を呼び出します。 DragAuto プロパティが FALSE の場合は、BeginDrag イベントスクリプトで Drag 関数を呼び出し、ドラッグ操作を開始します。

ユーザはハイライト表示されている項目をドラッグできません。

ツリービュー項目を別のコントロールにドラッグすると、ドラッグ関連の標準イベント（DragDrop、 DragEnter、 DragLeave、 DragWithin）が発生します。ほかのコントロールがツリービューの境界内にドラッグされると、同様なドラッグ関連のイベントが発生します。

例次の例はツリービュー項目をツリービューから別のツリービューに移動します。 Ilvi_dragged_object は ListViewItem 型のウィンドウインスタンス変数です。ツリービュー項目をコピーする場合は、移動元のツリービューからツリービュー項目を削除するコードを省いてください。

次のコードは、移動元のツリービューの BeginDrag イベントのスクリプトです。

long itemnum

// ツリービューの DragAuto プロパティが FALSE の場合This.Drag(Begin!)itemnum = 1This.GetItem(itemnum, itvi_dragged_object)

// 移動でなくコピーの場合は、次の 2 行を省くことThis.DeleteItem(itemnum)This.SetRedraw(TRUE)

次のコードは、移動先のツリービューの DragDrop イベントのスクリプトです。

This.InsertItemLast(0, ilvi_dragged_object)This.SetRedraw(TRUE)

200 PowerBuilder


移動元のツリービューから項目を直ちに削除する代わりに、 DragDropイベントでの項目の挿入を確認した後で削除しても構いません。

関連項目 BeginRightDragDragDropDragEnterDragLeaveDragWithin


BeginLabelEdit

BeginLabelEditBeginLabelEdit イベントは、オブジェクトによって引数の内容が異なります。


機能ユーザが項目を選択した後で、その項目のラベルをクリックするときに発生します。

イベント ID

引数


0 ラベルの編集を可能にします。1 ラベルの編集ができません。

解説ラベルの編集が可能なときは、ラベルの位置にボックスが現われ、ラベルテキストがハイライト表示されます。ユーザはこのテキストを変更することができます。

例次の例は、BeginLabelEdit イベントを使って、編集中のリストビュー項目名をシングルラインエディットに表示します。

ListViewItem lviThis.GetItem(index lvi)sle_info.text = "Editing " + string(lvi.label)

関連項目 EndLabelEdit




pbm_lvnbeginlabeledit リストビュー

引数説明

index Integer 型。値によって渡されます（選択されたListViewItem のインデックス）。

202 PowerBuilder



機能ユーザが項目を選択した後で、その項目のラベルをクリックするときに発生します。

イベント ID

引数


0 ラベルの編集を可能にします。1 ラベルの編集ができません。

解説ラベルの編集が可能なときは、ラベルの位置にボックスが現われ、ラベルテキストがハイライト表示されます。ユーザはこのテキストを変更することができます。

例次の例は、BeginLabelEdit イベントを使って、編集中のツリービュー項目名をシングルラインエディットに表示します。

TreeViewItem tviThis.GetItem(index, tvi)sle_info.text = "Editing " + string(tvi.label)

関連項目 EndLabelEdit


pbm_tvnbeginlabeledit ツリービュー

引数説明

handle Long 型。値によって渡されます（選択されたTreeViewItem のハンドル）。


BeginRightDrag

BeginRightDragBeginRightDrag イベントは、オブジェクトによって引数の内容が異なります。


機能ユーザがリストビューコントロール内でマウスの右ボタンを押して、ドラッグを開始するときに発生します。

イベント ID

引数





• Drag 関数を呼び出します。 DragAuto プロパティが FALSE の場合は、 BeginRightDrag イベントスクリプトで Drag 関数を呼び出し、ドラッグ操作を開始します。

リストビュー項目を別のコントロールにドラッグすると、ドラッグ関連の標準イベント（DragDrop、 DragEnter、 DragLeave、 DragWithin）が発生します。ほかのコントロールがリストビューの境界内にドラッグされると、同様なドラッグ関連のイベントが発生します。




pbm_lvnbeginrightdrag リストビュー

引数説明

index Integer 型。値によって渡されます（ドラッグされている ListViewItem のインデックス）。

204 PowerBuilder


例 BeginDrag イベントの例を参照してください。 BeginRightDrag イベントでも有効です。

関連項目 BeginDragDragDropDragEnterDragLeaveDragWithin


機能ユーザがツリービューコントロール内でマウスの右ボタンを押して、ドラッグを開始するときに発生します。

イベント ID

引数





• Drag 関数を呼び出します。 DragAuto プロパティが FALSE の場合は、 BeginRightDrag イベントスクリプトで Drag 関数を呼び出し、ドラッグ操作を開始します。

ユーザはハイライト表示されている項目をドラッグできません。ツリービュー項目を別のコントロールにドラッグすると、ドラッグ関連の標準イベント（DragDrop、 DragEnter、 DragLeave、 DragWithin）が発生します。ほかのコントロールがツリービューの境界内にドラッグされると、同様なドラッグ関連のイベントが発生します。


pbm_tvnbeginrightdrag ツリービュー

引数説明

handle Long 型。値によって渡されます（ドラッグされているTreeViewItem のハンドル）。


BeginRightDrag

例 BeginDrag イベントの例を参照してください。

関連項目 BeginDragDragDropDragEnterDragLeaveDragWithin

206 PowerBuilder


ClickedClicked イベントは、オブジェクトによって引数の内容が異なります。

データウィンドウコントロールの Clicked イベントについては、『データウィンドウリファレンス』マニュアルまたはオンラインヘルプを参照してください。

構文 1 メニューオブジェクトに対して

機能ユーザがメニューの項目を選択するときに発生します。

イベント ID

引数なし

リターンコードなし（RETURN 文を使用しないでください）

解説ユーザがメニュー項目を実行せずにハイライト表示にしただけの場合は、 Selected イベントが発生します。

ユーザが、カスケードメニューに関連付けられたメニュー項目を選択した場合は、Clicked イベントが発生し、カスケードメニューが表示されます。

例次のスクリプトは、フレームウィンドウの［新規作成］メニュー項目の Clicked イベントに対するものです。ここで、wf_newsheet 関数はウィンドウ関数です。また、 w_genapp_frame は、アプリケーションテンプレート（新規アプリケーションの作成時に生成できます）のコンポーネントです。

/* 新規シートの作成 */w_genapp_frame.wf_newsheet( )

関連項目 Selected


メニュー構文 1リストビューコントロール構文 2タブコントロール構文 3ツリービューコントロール構文 4ウィンドウ構文 5ほかのコントロール構文 6


なしメニュー


Clicked


機能ユーザがリストビューコントロール内の項目か項目以外のスペースをクリックするときに発生します。

イベント ID

引数



解説 Clicked イベントはマウスボタンが押されたときに発生します。Clickedイベントは、ダブルクリックされるときも、 DoubleClicked イベントに先立って発生します。

ユーザがまだフォーカスされていない項目をクリックすると、 Clickedイベントのほかに ItemChanging イベントと ItemChanged イベントが発生します。フォーカスされている項目のラベルをクリックすると、BeginLabelEdit イベントが発生します。

リストビューコントロールに対する ItemActivate イベントの使用リストビューコントロールには、 Clicked イベントの代わりにItemActivate イベントを使用できます（OneClickActivate プロパティをTRUE に設定）。

例次のコードは、ユーザがクリックした項目の英文ラベルを大文字に変更します。

IF index = -1 THEN RETURN 0

This.GetItem(index, llvi_current)llvi_current.Label = Upper(llvi_current.Label)This.SetItem(index, llvi_current)RETURN 0

関連項目 ColumnClickDoubleClicked


pbm_lvnclicked リストビュー

引数説明

index Integer 型。値によって渡されます（ユーザがクリックした ListViewItem のインデックス）。ユーザがListViewItem 以外のコントロール内部をクリックした場合、 index の値は -1 になります。

208 PowerBuilder


ItemActivateItemChangedItemChangingRightClickedRightDoubleClicked

構文 3 タブコントロールに対して

機能ユーザがタブコントロールのタブ部分をクリックするときに発生します。

イベント ID

引数



解説 Clicked イベントはマウスボタンが放されるときに発生します。

ユーザがタブコントロールの表示領域をクリックすると、タブコントロールではなく、タブページが Clicked イベントを得ます。

Clicked イベントは、ダブルクリックされるときも、DoubleClicked イベントに先立って発生します。

ユーザがタブページラベルをクリックすると、 Clicked イベントのほかに SelectionChanging イベントと SelectionChanged イベントが発生します。ユーザが矢印キーを押して別のタブページに移る場合は、Clickedイベントではなく、 SelectionChanging イベントと SelectionChanged イベントの前に Key イベントが発生します。

例次のコードは 4 番目のタブページがクリックされたときだけ、タブラベルを太字に変えます。

IF index = 4 THEN This.BoldSelectedText = TRUE

ELSEThis.BoldSelectedText = FALSE

END IF


pbm_tcnclicked タブ

引数説明

index Integer 型。値によって渡されます（ユーザがクリックしたタブページのインデックス）。


Clicked

関連項目 DoubleClickedRightClickedRightDoubleClickedSelectionChangedSelectionChanging


機能ユーザがツリービューコントロールの項目をクリックするときに発生します。

イベント ID

引数



解説 Clicked イベントはマウスボタンが押されたときに発生します。

Clicked イベントは、ダブルクリックされるときも、DoubleClicked イベントに先立って発生します。

フォーカスされていなかったコントロールがクリックされる場合は、Clicked イベントのほかに、 GetFocus イベントが発生します。

例次のコードは、ユーザがクリックした項目の英文ラベルを大文字に変更します。

TreeViewItem ltvi_current

This.GetItem(handle, ltvi_current)ltvi_current.Label = Upper(ltvi_current.Label)This.SetItem(handle, ltvi_current)

関連項目 DoubleClickedRightClickedRightDoubleClickedSelectionChangedSelectionChanging


pbm_tvnclicked ツリービュー

引数説明

handle Long 型。値によって渡されます（ユーザがクリックしたツリービュー項目のハンドル）。

210 PowerBuilder


構文 5 ウィンドウに対して

機能ユーザがウィンドウ上の未使用領域（表示可能で使用可能なオブジェクトが配置されていないエリア）をクリックするときに発生します。

イベント ID

引数




ユーザがコントロールやメニューをクリックすると、ウィンドウではなく、オブジェクトが Clicked イベントを得ます。なお、ウィンドウのタイトルバーをクリックしても Clicked イベントは発生しません。

ユーザがウィンドウをクリックすると、ウィンドウの MouseDown イベントと MouseUp イベントも発生します。

ユーザが、表示されているが使用不可のコントロールや、使用可能だが非表示のコントロールをクリックした場合は、ウィンドウが Clickedイベントを得ます。


pbm_lbuttonclk ウィンドウ

引数説明

flags UnsignedLong 型。値によって渡されます（押下されたマウスボタンと修飾キーの値の合計）。

値は以下のとおりです。

• 1 －左マウスボタン

• 2 －右マウスボタン

• 4 －〔Shift〕• 8 －〔Ctrl〕• 16 －中マウスボタン

Clicked イベントで左マウスボタンが押されない場合、 flags の値に 1 は加算されません。

flags の詳細については、284 ページの「MouseMove」イベントの構文 2 を参照してください。

xpos Integer 型。値によって渡されます（ウィンドウの左辺からポインタまでの距離で、ピクセル単位の値）。

ypos Integer 型。値によって渡されます（ウィンドウの上辺からポインタまでの距離で、ピクセル単位の値）。


Clicked

例次のコードは、ユーザがウィンドウの左上隅をクリックすると cb_clearボタンにフォーカスを移します。

IF (xpos <= 600 AND ypos <= 600) THENcb_clear.SetFocus( )

END IF

関連項目 DoubleClickedMouseDownMouseMoveMouseUpRButtonDown

構文 6 ほかのコントロールに対して

機能ユーザがコントロールをクリックしたときに発生します。

イベント ID

引数なし




フォーカスされていなかったコントロールがクリックされる場合は、Clicked イベントのほかに、 GetFocus イベントが発生します。

例次のコードは、 OLE コントロールの Clicked イベントのスクリプトです。OLE コントロール上のオブジェクトをインプレースで起動します。

integer li_successli_success = This.Activate(InPlace!)

関連項目 GetFocusRButtonDown


pbm_bnclicked チェックボックス、コマンドボタン、グラフ、 OLE、ピクチャ、ピクチャハイパーリンク、ピクチャボタン、ラジオボタン、スタティックテキスト、スタティックハイパーリンク

pbm_prnclicked 水平プログレスバー、垂直プログレスバー

212 PowerBuilder


CloseClose イベントは、オブジェクトによって引数の内容が異なります。

構文 1 アプリケーションオブジェクトに対して

機能ユーザがアプリケーションを閉じるときに発生します。

イベント ID

引数なし


解説 Close イベントは、すべてのウィンドウ（MDI アプリケーションの場合は MDI フレーム）が閉じるときに発生します。

関連項目 OpenSystemError

構文 2 OLE コントロールに対して

機能オフサイトで起動された OLE コントロールのオブジェクト（OLE サーバがサーバのウィンドウ上で表示しているオブジェクト）のサーバが閉じられるときに発生します。

イベント ID

引数なし

リターンコード Long 型のリターンコード。無視されます。

解説ユーザが OLE サーバを閉じると、ユーザの選択によってコントロール内の OLE オブジェクトが更新され、 Save イベントまたは DataChangeイベントが発生する場合があります。


アプリケーション構文 1OLE コントロール構文 2ウィンドウ構文 3


なしアプリケーション


pbm_omnclose OLE


Close

このイベントの処理中に、OLE コントロールの ObjectData Blob 値を取得したい場合は、このコントロールに対してユーザイベントをポストしないと、実行時エラーが発生します。

関連項目 DataChangeSave


機能ウィンドウが画面に表示されなくなる直前に発生します。

イベント ID

引数なし



解説ウィンドウに対して Close 関数を呼び出す場合、 Close イベントの前にCloseQuery イベントが発生します。CloseQuery イベントでは、Close イベントを発生させないでウィンドウを開いたままにするようにリターンコードを指定できます。

ウィンドウを閉じる場合は、 Close イベントを起動しないで、 Close 関数を呼び出してください（Close イベントを起動しても、そのイベントスクリプトが実行されるだけで、ウィンドウは閉じません）。

関連項目 CloseQueryOpen


pbm_close ウィンドウ

214 PowerBuilder


CloseQuery機能ウィンドウが閉じるときに、 Close イベントの前に発生します。

イベント ID

引数なし


0 ウィンドウを閉じます。1 ウィンドウを閉じません。

解説 CloseQuery イベントがリターンコードとして 1 を返す場合、ウィンドウのクローズ処理は中止され、 Close イベントは発生しません。

ユーザがウィンドウのクローズボックスを使ってウィンドウを閉じる場合も CloseQuery イベントが発生します。したがって、 CloseQuery イベントを用いれば、ウィンドウを閉じる前にユーザに変更内容を保存するかどうかを尋ねたり、正当なデータが入力されたかどうかを調べることができます。

関数仕様の変更Message オブジェクトの ReturnValue プロパティの値を設定する必要はなくなりました。代わりに、 RETURN 文を使用してください。

例次のスクリプトは、ウィンドウの CloseQuery イベントのものです。ユーザにウィンドウを本当に閉じるかどうかメッセージを発し、ユーザが「いいえ」と答えたらクローズ処理を中止します。

IF MessageBox("ウィンドウを閉じる ", &" ウィンドウを閉じてもよろしいですか ?", &Question!, YesNo!) = 2 THEN

RETURN 1ELSE

RETURN 0END IF

次のスクリプトは、 dw_1 データウィンドウに未保存のデータ変更があるかどうか調べます。変更がある場合、そのデータをデータベースに更新してからウィンドウを閉じるか、更新せずに閉じるか、また、更新しないでウィンドウを開いたままにするか、ユーザに問い合わせます。


pbm_closequery ウィンドウ


CloseQuery

integer li_rc

// データウィンドウに入力されたデータをすべて確定するdw_1.AcceptText()

// データが更新されたかどうかチェックするIF dw_1.DeletedCount()+dw_1.ModifiedCount() > 0 THEN

li_rc = MessageBox("閉じる ", &"変更内容を更新しますか ?", Question!, &YesNoCancel!, 3)

// データを更新してからウィンドウを閉じる処理IF li_rc = 1 THEN

Window lw_windowlw_window = w_genapp_frame.GetActiveSheet()lw_window.TriggerEvent("ue_update")RETURN 0

// データを更新しないでウィンドウを閉じる処理ELSEIF li_rc = 2 THEN

RETURN 0

// クローズ処理のキャンセルELSE

RETURN 1END IF

ELSE

// 変更されたデータがなかったので、ウィンドウを単に閉じるRETURN 0

END IF

関連項目 Close

216 PowerBuilder


ColumnClick機能ユーザがカラムヘッダをクリックするときに発生します。

イベント ID

引数



解説 ColumnClicked イベントは、リストビューのビューが詳細表示になっていて、ButtonHeader プロパティが TRUE に設定されているときしか、発生しません。

例次の例は、ColumnClicked イベントを使って、カラム引数のインスタンス変数を設定し、カラムの配置（位置揃え）情報を取得して表示します。

string ls_label, ls_aligninteger li_widthalignment la_align

ii_col = columnThis.GetColumn(column, ls_label, la_align, &

li_width)

CHOOSE CASE la_alignCASE Right!

rb_right.Checked = TRUEls_align = "Right!"

CASE Left!rb_left.Checked = TRUEls_align = "Left!"

CASE Center!rb_center.Checked = TRUEls_align = "Center!"

CASE Justify!rb_just.Checked = TRUE


pbm_lvncolumnclick リストビュー

引数説明

column クリックされたカラムのインデックス


ColumnClick

ls_align = "Justify!"END CHOOSE

sle_info.Text = String(column) &+ " " + ls_label &+ " " + ls_align &+ " " + String(li_width)

関連項目 Clicked

218 PowerBuilder


Constructor機能コントロールやオブジェクトが作成されるときに、そのコントロール

が配置されるウィンドウの Open イベントの前に発生します。

イベント ID

引数なし



解説ウィンドウが表示される前にコントロールのプロパティを設定したい場合は、コントロールの Constructor イベントにスクリプトを記述できます。

ウィンドウやユーザオブジェクトが開かれると、それらに配置されている各コントロールの Constructor イベントが発生します。ウィンドウの Control プロパティ（配列）内のコントロールの順序が Constructor イベントの発生順序を決定します。ウィンドウのコントロールにユーザオブジェクトがある場合、ユーザオブジェクト内のすべてのコントロールの Constructor イベントが発生した後で、ウィンドウ内の次のコントロールの Constructor イベントが発生します。

OpenUserObject 関数を呼び出して動的にユーザオブジェクトをウィンドウに追加する場合、そのユーザオブジェクトの Constructor イベントとそれを構成するすべてのコントロールの Constructor イベントが発生します。

CREATE 文を使用してクラス（非表示）ユーザオブジェクトのインスタンスを作成する場合、クラスユーザオブジェクトの Constructor イベントが発生します。

クラスユーザオブジェクト変数のインスタンスの自動生成（AutoInstantiate）が設定されている場合、変数がスコープ内に生成されるときにそのConstructor イベントが発生します。つまり、 Constructor イベントが発生するのは次の場合です。

• グローバル変数 : システムが開始するとき

• 共有変数 : 共有変数があるオブジェクトがロードされるとき

• インスタンス変数 : インスタンス変数があるオブジェクトが作成されるとき


pbm_constructor すべてのオブジェクト


Constructor

• ローカル変数 : ローカル変数を宣言した関数の実行が開始されるとき

例次の例は、データウィンドウ dw_1 のウィンドウが表示される前に、そのデータを検索します。

dw_1.SetTransObject(SQLCA)dw_1.Retrieve( )

関連項目 DestructorOpen

220 PowerBuilder


DataChange機能 OLE サーバアプリケーションが、OLE コントロールにデータが変更さ

れたことを通知するときに発生します。

イベント ID

引数なし


関連項目 PropertyRequestEditPropertyChangedRenameViewChange


pbm_omndatachange OLE


Deactivate

Deactivate機能ウィンドウがアクティブでなくなるときに発生します。

イベント ID

引数なし



解説ウィンドウが閉じられると、 Deactivate イベントが発生します。

関連項目 ActivateShow


pbm_deactivate ウィンドウ

222 PowerBuilder


DeleteAllItems機能リストビューの項目がすべて削除されるときに発生します。

イベント ID

引数なし



例次の例は、DeleteAllItems イベントで、リストビューコントロールにデフォルト項目を追加し、項目がすべてなくならないようにしています。

This.AddItem("Default item", 1)

関連項目 DeleteItemInsertItem


pbm_lvndeleteallitems リストビュー


DeleteItem

DeleteItemDeleteItem イベントは、オブジェクトによって引数の内容が異なります。


機能項目が削除されるときに発生します。

イベント ID

引数



例 DeleteItem イベントの次の例は、削除された項目の項目番号をメッセージに表示します。

MessageBox(" メッセージ ", "項目 " + String(index) &+ "は削除されました。 ")

関連項目 DeleteAllItemsInsertItem


機能項目が削除されるときに発生します。

イベント ID




pbm_lvndeleteitem リストビュー

引数説明

index Integer 型。値によって渡されます（削除されたListViewItem のインデックス）。


pbm_tvndeleteitem ツリービュー

224 PowerBuilder


引数



例次の例は、削除された項目の名前をメッセージ内に表示します。

TreeViewItem ll_tvi

This.GetItem(handle, ll_tvi)

MessageBox(" メッセージ ", String(ll_tvi.Label) &+ "は削除されました。 ")

引数説明

handle Long 型。値によって渡されます（削除されたTreeViewItem のハンドル）。


Destructor

Destructor機能ユーザオブジェクトやコントロールが破棄されるとき、ウィンドウの

Close イベントの直後に発生します。

イベント ID

引数なし



解説ウィンドウが閉じられると、各コントロールの Destructor イベントでコントロールが破棄され、メモリから除去されます。破棄されたコントロールは、ほかのスクリプトで参照できなくなります。参照しようとすると実行時エラーが発生します。

関連項目 ConstructorClose


pbm_destructor すべてのオブジェクト

226 PowerBuilder


DoubleClickedDoubleClicked イベントは、オブジェクトによって引数の内容が異なります。

データウィンドウコントロールの DoubleClicked イベントについては、『データウィンドウリファレンス』マニュアルまたはオンラインヘルプを参照してください。

構文 1 リストボックス、ピクチャリストボックス、リストビュー、タブコントロールに対して

機能ユーザがコントロールをダブルクリックするときに発生します。

イベント ID

引数




リストボックス、ピクチャリストボックス、リストボックス、タブコントロール

構文 1

ツリービューコントロール構文 2ウィンドウ構文 3ほかのコントロール構文 4


pbm_lbndblclk リストボックス、ピクチャリストボックス

pbm_lvndoubleclicked リストビュー

pbm_tcndoubleclicked タブ

引数説明

index Integer 型。値によって渡されます。ユーザがダブルクリックした ListViewItem のインデックス（タブコントロールの場合は、タブページのインデックス）。


DoubleClicked

解説リストビューコントロールをダブルクリックすると、DoubleClicked イベントの前と後に、Clicked イベントが 2 回発生します（マウスボタンが最初に放されるときに 1 回目の Clicked イベントが発生し、マウスボタンが押されて 2 回目のクリックが行われると DoubleClicked が発生し、マウスボタンが 2 回目に放されるときに再び Clicked イベントが発生します）。

リストビューコントロールに対する ItemActivate イベントの使用リストビューコントロールには、 DoubleClicked イベントの代わりにItemActivate イベントを使用できます（OneClickActivate プロパティをFALSE に設定）。

リストボックスとピクチャリストボックスでは、項目をダブルクリックすると、 SelectionChanged イベントも起動されます。

例次の例は、 DoubleClicked イベントを使用して、ダブルクリックされたリストビュー項目が編集できるようにします。

This.EditLabels = TRUE

関連項目 ClickedColumnClickItemActivateItemChangedItemChangingRightClickedRightDoubleClickedSelectionChangedSelectionChanging



イベント ID

引数


pbm_tvndoubleclicked ツリービュー

引数説明

handle Long 型。値によって渡されます（ユーザがダブルクリックした TreeViewItem のハンドル）。

228 PowerBuilder




例次の例は、ツリービュー項目をダブルクリックすると編集が開始できるようにします。

TreeViewItem ltvi_currentltvi_current = tv_1.FindItem(CurrentTreeItem!, 0)This.EditLabel(ltvi_current)

関連項目 ClickedRightClickedRightDoubleClickedSelectionChangedSelectionChanging


機能ユーザがウィンドウ上の未使用領域（表示可能で使用可能なコントロールの配置されていないエリア）をダブルクリックするときに発生します。

イベント ID

引数


pbm_lbuttondblclk ウィンドウ

引数説明






Clicked イベントで左マウスボタンが押されない場合、 flags の値に 1 は加算されません。



DoubleClicked



解説引数 xpos と ypos は、関数 PointerX と PointerY をウィンドウに対して呼び出したときに返す値と同一の値を提供します。

関連項目 ClickedMouseDownMouseMoveMouseUpRButtonDown

構文 4 ほかのコントロールに対して


イベント ID

引数なし



解説ドロップダウンリストボックスに対する DoubleClicked イベントは、［リストを表示］プロパティがオンになっているときのみアクティブになります。



引数説明


pbm_bndoubleclicked グラフ、OLE、ピクチャ、ピクチャハイパーリンク、スタティックテキスト、スタティックハイパーリンク

pbm_cbndblclk ドロップダウンリストボックス、ドロップダウンピクチャリストボックス

pbm_prndoubleclicked 水平プログレスバー、垂直プログレスバー

pbm_rendoubleclicked リッチテキストエディット

230 PowerBuilder

powerscript® リファレンス ボリューム 1 · powersoft portfolio ... replication server,...

Documents

powerscript® リファレンスボリューム 1 · powersoft portfolio ... replication server,...