メインコンテンツまでスキップ
バージョン: 次へ

Command name

Command name ( command {; info {; theme}} ) : Text

引数型説明
コマンドInteger→コマンド番号
infoInteger←Command property to evaluate
themeText←Language theme of command
戻り値Text←Localized command name
履歴
リリース内容
20 R9Support of deprecated property

説明​

The Command name command returns the name as well as (optionally) the properties of the command whose command number you pass in command.The number of each command is indicated in the Explorer as well as in the Properties area of this documentation.

Compatibility note: A command name may vary from one 4D version to the next (commands renamed), this command was used in previous versions to designate a command directly by means of its number, especially in non-tokenized portions of code. This need has diminished over time as 4D continues to evolve because, for non-tokenized statements (formulas), 4D now provides a token syntax. This syntax allows you to avoid potential problems due to variations in command names as well as other elements such as tables, while still being able to type these names in a legible manner (for more information, refer to the Using tokens in formulas section). Note also that the *Use regional system settings* option of the Preferences allows you to continue using the French language in a French version of 4D.

Two optional parameters are available:

  • info: properties of the command. The returned value is a bit field, where the following bits are meaningful:
  • First bit (bit 0): set to 1 if the command is thread-safe (i.e., compatible with execution in a preemptive process) and 0 if it is thread-unsafe. Only thread-safe commands can be used in preemptive processes.
  • Second bit (bit 1): set to 1 if the command is deprecated, and 0 if it is not. A deprecated command will continue to work normally as long as it is supported, but should be replaced whenever possible and must no longer be used in new code. Deprecated commands in your code generate warnings in the live checker and the compiler.

theme: name of the 4D language theme for the command.

The Command name command sets the OK variable to 1 if command corresponds to an existing command number, and to 0 otherwise. Note, however, that some existing commands have been disabled, in which case Command name returns an empty string (see last example).

例題 1​

The following code allows you to load all valid 4D commands in an array:

 var $Lon_id : Integer
 var $Txt_command : Text
 ARRAY LONGINT($tLon_Command_IDs;0)
 ARRAY TEXT($tTxt_commands;0)
 
 Repeat
    $Lon_id:=$Lon_id+1
    $Txt_command:=Command name($Lon_id)
    If(OK=1) //command number exists
       If(Length($Txt_command)>0) //command is not disabled
          APPEND TO ARRAY($tTxt_commands;$Txt_command)
          APPEND TO ARRAY($tLon_Command_IDs;$Lon_id)
       End if
    End if
 Until(OK=0) //end of existing commands

例題 2​

In a form, you want a drop-down list populated with the basic summary report commands. In the object method for that drop-down list, you write:

 Case of
    :(Form event code=On Before)
       ARRAY TEXT(asCommand;4)
       asCommand{1}:=Command name(1)
       asCommand{2}:=Command name(2)
       asCommand{3}:=Command name(4)
       asCommand{4}:=Command name(3)
  // ...
 End case

In the English version of 4D, the drop-down list will read: Sum, Average, Min, and Max. In the French version*, the drop-down list will read: Somme, Moyenne, Min, and Max.

*with a 4D application configured to use the French programming language (see compatibility note)

例題 3​

You want to create a method that returns True if the command, whose number is passed as parameter, is thread-safe, and False otherwise.

  //Is_Thread_Safe project method
 #declare($command : Integer) : Boolean
 var $threadsafe : Integer
 var $name; $theme : Text
 $name:=Command name($command;$threadsafe;$theme)
 If($threadsafe ?? 0) //if the first bit is set to 1
    return True
 Else
    return False
 End if

Then, for the "SAVE RECORD" command (53) for example, you can write:

 $isSafe:=Is_Thread_Safe(53)
  // returns True

例題 4​

You want to return a collection of all deprecated commands in your version of 4D.

var $info; $Lon_id : Integer
var $Txt_command : Text
var $deprecated : Collection

Repeat
    $Lon_id:=$Lon_id+1
    $Txt_command:=Command name($Lon_id;$info)
    If($info ?? 1) //the second bit is set to 1
            //then the command is deprecated
        $deprecated.push($Txt_command)
    End if
Until(OK=0) //end of existing commands

参照​

EXECUTE FORMULA
Preemptive Processes

プロパティ​

コマンド番号538
スレッドセーフ✓
更新するシステム変数OK