## Tcl8.6.17/Tk8.6.17 Documentation > Tcl C API > FindExec

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    Tcl_FindExecutable, Tcl_GetNameOfExecutable — 応用譜を含む二進化ファイルの名前を識別して返す　 identify or return the name of the binary file containing the application
  SYNOPSIS
    #include <tcl.h>
    void
    Tcl_FindExecutable(argv0)
    const char *
    Tcl_GetNameOfExecutable()
  引数 ARGUMENTS
    char *argv0 (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tcl_FindExecutable, Tcl_GetNameOfExecutable — 応用譜を含む二進化ファイルの名前を識別して返す　 identify or return the name of the binary file containing the application

### SYNOPSIS

#include <tcl.h>
void
Tcl_FindExecutable(argv0)
const char *
Tcl_GetNameOfExecutable()

### 引数 ARGUMENTS

char *argv0 (入力in)
  算譜への最初の命令行引数､これは応用譜の名前を与える｡　 The first command-line argument to the program, which gives the application's name.

### 説明 DESCRIPTION

Tcl_FindExecutable 手続函数は Tcl の内部の使用の為に､そこから応用譜が起動され保存される実行可能ファイルの完全経路名を算出する｡実行可能経路名は Tcl.内の幾つかの目的に必要とされる｡譬えば､あるOS上では load 命令の実装に必要である｡それは info nameofexecutable 命令でも同じように返される｡ 　　　 The Tcl_FindExecutable procedure computes the full path name of the executable file from which the application was invoked and saves it for Tcl's internal use. The executable's path name is needed for several purposes in Tcl. For example, it is needed on some platforms in the implementation of the load command. It is also returned by the info nameofexecutable command.

UNIX 上では､この手続函数は典型的には応用譜の主算譜内の非常に初めのこととして起動される; それはその引数として argv[0] が渡される筈である｡重要なことは起動の前に活動ディレクトリーを変更しないことである｡ Tcl_FindExecutable は可能であれば､ argv0 を PATH 環境変数に沿って応用譜の実行可能ファイルを見付ける為に使う｡２進列の発見に失敗すると､以降の info nameofexecutable は空文字列を返すようになる｡ On UNIX platforms this procedure is typically invoked as the very first thing in the application's main program; it must be passed argv[0] as its argument. It is important not to change the working directory before the invocation. Tcl_FindExecutable uses argv0 along with the PATH environment variable to find the application's executable, if possible. If it fails to find the binary, then future calls to info nameofexecutable will return an empty string.

Windows 上では､この手続は典型的には応用譜の主算譜内のできる限り初めに起動される; その argv[0] 引数は単に実行譜は標準不都合通信路を有しているか(非零値)､有さない(零値)かを指し示す為だけに使用される｡もし Tcl_SetPanicProc が呼ばれず､且つ不具合修正譜が実行されていない場合､混乱伝言文が標準不都合通信路か標準系日誌に送られるかを定める｡ 　　　 On Windows platforms this procedure is typically invoked as the very first thing in the application's main program as well; Its argv[0] argument is only used to indicate whether the executable has a stderr channel (any non-null value) or not (the value null). If Tcl_SetPanicProc is never called and no debugger is running, this determines whether the panic message is sent to stderr or to a standard system dialog.

Tcl_GetNameOfExecutable は単に Tcl_FindExecutable によって算出されたとして実行可能ファイルの内部完全経路名へのポインターを返す｡この手続函数呼出しは info nameofexecutable 命令への C API と等価である｡内部完全経路名が算出されたことがないか未知の場合 NULL が返される｡ Tcl_GetNameOfExecutable simply returns a pointer to the internal full path name of the executable file as computed by Tcl_FindExecutable. This procedure call is the C API equivalent to the info nameofexecutable command. NULL is returned if the internal full path name has not been computed or unknown.

### KEYWORDS

binary, executable file
Copyright © 1995-1996 Sun Microsystems, Inc.