TclAPI
- A
- ascii
- B
- base64_decode
- base64_decodeex
- base64_encode
- base64_encodeex
- C
- char
- chmod
- close
- copyfile
- D
- date
- daylength
- decodebase64
- decr
- E
- encodebase64
- eof
- errorstring
- exec
- exitthread
- F
- fetch
- filedelete
- filemtime
- freespace
- G
- getapppath
- getcomputername
- getcurrentpath
- getdrivetype
- getenv
- gethostname
- getipaddress
- getlasterror
- getlongpath
- gets
- getsystemdirectory
- getvar
- getviewer
- getvolumelabel
- getwindowsdirectory
- H
- http.get
- I
- inport
- J
- japanese
- jis2sjis
- K
- kill
- killtimer
- L
- M
- mkdir
- mkfile
- myhostname
- myipaddress
- N
- O
- open
- outport
- P
- Q
- R
- read
- reg
- rgb
- S
- scanfile
- seek
- shortcut
- sjis
- sjis2hex
- sjis2jis
- sjisucshex
- splitutfhex
- T
- U
- V
- W
- wait
- wininet api
- X
- Y
- Z
base64_encodeex
api base64_encodeEx $text $text_len $out_varname
return length
文字数$text_lenの文字列$textをBASE64ｴﾝｺｰﾄﾞして変数out_varnameに格納します
ｴﾝｺｰﾄﾞ後の文字数を返します
base64_encode
api base64_encode $text $text_len out_varname
return length
文字数$text_lenの文字列$textをBASE64ｴﾝｺｰﾄﾞして変数out_varnameに格納します
ｴﾝｺｰﾄﾞ後の文字数を返します
base64_decodeex
api base64_decodeEx $base64 out_varname
return length
文字数$base64をBASE64ﾃﾞｺｰﾄﾞして変数out_varnameに格納します
ﾃﾞｺｰﾄﾞ後の文字数を返します
base64_decode
api base64_decode $base64_text out_varname
return length
BASE64ｺｰﾄﾞの文字列$base64_textをﾃﾞｺｰﾄﾞして変数out_varnameに格納します
ﾃﾞｺｰﾄﾞ後の文字数を返します
失敗するとout_varnameには空文字が格納され0が返ります
copyfile
api copyFile $fileA $fileB $noexists
return success
ﾌｧｲﾙをｺﾋﾟｰします($fileA --> $fileB)
$noexistsが1の場合、fileBが存在すれば失敗します
$noexistsが0の場合、fileBが存在していても上書きされます
成功すれば1が返ります
chmod
api chmod $mode $filename
return success
api chmod $filename
return hexval
ﾌｧｲﾙ属性の書込み禁止/許可を設定します
$mode
-w : 書き込み禁止
+w : 書き込み許可
+x[0-9]+ : 後続のHEX値をセット
-x[0-9]+ : 後続のHEX値をリセット
$modeを省略すると現在のファイル属性が16進数で返ります
0xffffffffが返ればファイルが無いことを意味します
date
api date
return date_text
現在の日付と時間を返します
ﾌｫｰﾏｯﾄ : "YYYY/MM/DD hh/mm/ss"
daylength
api daylength $from_date $to_date
return days
指定した日付間の期間を日数で返します(閏年等も考慮します)
set days [api daylength 1998/12/01 2008/01/15]
decodebase64
api decodeBase64 $cmpressed_data
return uncompressed_data
api encodeBase64で書き出されたﾌｧｲﾙの全ﾃﾞｰﾀを受け取り、ﾃﾞｺｰﾄﾞﾃﾞｰﾀを返す
gui decodeBase64 と同じ機能です。
decr
api decr $tcl_object_handle
return 0
Tclｵﾌﾞｼﾞｪｸﾄの参照ｶｳﾝﾀを減じます
encodebase64
api encodeBase64 $infile $outfile $before $after
return err
api encodeBase64 $text
return base64
infileﾌｧｲﾙを読みoutfileにBase64ｴﾝｺｰﾄﾞしたﾃﾞｰﾀを書き出す
ｴﾝｺｰﾄﾞﾃﾞｰﾀに付け加えるﾍｯﾀﾞとﾌｯﾀﾞﾃﾞｰﾀをbeforeとafterに指定する
成功したら0を返す
gui encodeBase64 と同じ機能です
eof
api eof $fp
return {1|0}
exec
api exec $cmd [$arg1 ...]
return pid
ｱｰｷﾞｭﾒﾝﾄで与えられたOSへのｺﾏﾝﾄﾞﾗｲﾝを実行しﾌﾟﾛｾｽidを返します
ﾌﾟﾛｾｽidはｳｲﾝﾄﾞｳをもつﾌﾟﾛｾｽの場合に有効です
このﾌﾟﾛｾｽidをapi waitに渡して終了を待つことができます
exitthread
api exitThread
return 1
ｽﾚｯﾄﾞｽｸﾘﾌﾟﾄまたはｽﾚｯﾄﾞﾌﾟﾛｼｰｼﾞｬを終了します
ｽﾚｯﾄﾞｽｸﾘﾌﾟﾄまたはｽﾚｯﾄﾞﾌﾟﾛｼｰｼﾞｬの中で実行します
ｽﾚｯﾄﾞﾌﾟﾛｼｰｼﾞｬはapi threadで起動できます
ｽﾚｯﾄﾞｽｸﾘﾌﾟﾄはapi threadEvalで起動できます
fetch
api fetch $fp $adr *data
return next_adr
filedelete
api filedelete $file
return handle
プロセス終了後にファイルを削除します
-1が返されたら失敗です
filemtime
api filemtime $filename $time
ﾌｧｲﾙの更新日付を修正します
$timeは"YYYY/MM/DD HH:MM:SS"で与えます
freespace
api freeSpace $drive [$use]
return size
ﾃﾞｨｽｸの空き容量をﾊﾞｲﾄｻｲｽﾞで返します
$useに1をｾｯﾄして与えると使用容量を返します
set size [api freeSpae D:]
getdrivetype
api getdrivetype $drive
return type
ドライブのタイプを返します
typeは下記のいずれかです
unknown
noroot
removable
fixed
remote
cdrom
ramdisk
getvolumelabel
api getvolumelabel $drive [name]
return "VolumeNameBuffer:VolumeSerialNumber"
getlongpath
api getlongpath $path
return longpath
gets
api gets $path varname
return size
api openで開かれたﾌｧｲﾙから１行を変数varnameに読み込みます
LFｺｰﾄﾞを行末と見なし
読み込んだｻｲｽﾞを返します。EOFに到達した場合は-1を返します。
getapppath
api getAppPath $exefilename
return path
実行ﾌｧｲﾙ名をﾌﾙﾊﾟｽで返します
api exec [api getAppPath exel.exe]
下記ﾚｼﾞｽﾄﾘにｾｯﾄされている値を返します
HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion/App Paths/$exefilename
getsystemdirectory
api getSystemDirectory
return path
Windowsのｼｽﾃﾑﾃﾞｨﾚｸﾄﾘｨを返します
例："C:\WINDOWS\System32"
ｼｽﾃﾑﾄﾞﾗｲﾌﾞ名を得る時に有効です
getwindowsdirectory
api getWindowsDirectory
return path
WindowsのWINDOWSﾃﾞｨﾚｸﾄﾘｨを返します
例："C:\WINDOWS\System32"
ｼｽﾃﾑﾄﾞﾗｲﾌﾞ名を得る時に有効です
getcurrentpath
api getCurrentPath
return path
現在の作業ﾌｫﾙﾀﾞ名を返します
tclｺﾏﾝﾄﾞ"pwd"と同等です
getipaddress
api getIPaddress $hostname
return ipaddress
ﾎｽﾄ名からIPｱﾄﾞﾚｽを得て返します
api getHostnameと逆の機能です
使用例：
api myHostName
→yoshida3
api getIPaddress yoshida3
→192.168.100.16
api getIPaddress localhost
→127.0.0.1
gethostname
api getHostName $ipaddress
return hostname
IPｱﾄﾞﾚｽからﾎｽﾄ名を得て返します
api getIPadddressと逆の機能です
getenv
api getEnv $varname
return val
Windows環境変数の値を返します
set temppath [api getEnv TEMP]
getvar
api getVar $varname
return val
ｽﾚｯﾄﾞを起動したﾒｲﾝ側のTclｸﾞﾛｰﾊﾞﾙ変数の値を取得します
ｽﾚｯﾄﾞﾌﾟﾛｼｰｼﾞｬ,ｽｸﾘﾌﾟﾄの中でのみ有効です
互換性維持のために残存しています。このｺﾏﾝﾄﾞを使わなくてもｸﾞﾛｰﾊﾞﾙ変数にｱｸｾｽできます。
getviewer
api getViewer $filename
return path
指定したﾌｧｲﾙを表示するﾌﾟﾛｸﾞﾗﾑ名をﾌﾙﾊﾟｽで返します
ﾌﾟﾛｸﾞﾗﾑ名が不明の場合やﾌｧｲﾙが見つからなかった場合は空文字が返ります
$filenameには絶対ﾊﾟｽでﾌｧｲﾙ名を与えます
そのﾌｧｲﾙは現存している必要があります
参照： api shellopen
http.get
api http.get $url [$username [password]]
return text
wininet api
winInet API
コマンドシーケンス
HTTP GET
api inet.open
api inet.connect
api inet.httpRequest
api inet.read
api inet.close
HTTP POST (Normal size)
api inet.open
api inet.connect
api inet.httpRequest
api inet.read
api inet.close
HTTP POST (Large size)
api inet.open
api inet.connect
api inet.httpRequest
api inet.write
api inet.read
api inet.close
FTP get
api inet.open
api inet.connect
api inet.ftpOpenFile
api inet.read
api inet.close
FTP put
api inet.open
api inet.connect
api inet.ftpOpenFile
api inet.write
api inet.close
=====================================================
api inet.open
return session
wininetインスタンスを作成してセッションハンドルを返します
http/ftp共通コマンドです
api inet.close $session [$connect]
wininetのハンドルを削除します
http/ftp共通コマンドです
$session : api inet.openで返されたハンドル
$connect : api inet.connectで返されたハンドル
api inet.connect $session [$server [$service [$port [$username [$password]]]]]
return connect
サーバーに接続してコネクションハンドルを返します
http/ftp共通コマンドです
$session : api inet.openで返されたハンドル
$server : サーバー名 例："freesoftnet.co.jp"
$service : サービス名 {http | ftp}
$port : TCPポート番号(16進数)
$username: ユーザー名(ftp)
$password: パスワード(ftp)
api inet.httpRequest $connect $url [$method [$post_len [$postdata]]]
return request
サーバーに送信するHTTPリクエストを作成して送信し、そのリクエストハンドルを返します
http専用コマンドです
$connect : api inet.connectで返されたセッションハンドル
$url : ファイルパス 例："http://https:reesoftnet.co.jp/index.htm"
$method : {GET | POST | HEAD} 省略時："GET"
$post_len: POSTデータのバイトサイズ
$postdata: POSTするデータ 巨大サイズの場合は省略する($post_lenだけ)
その代わりapi inet.writeで送信する
api inet.httpOpenFile $session $url
return request
サーバーにファイルをGETするHTTPリクエストを送信しそのリクエストハンドルを返します
http専用コマンドです
$session : api inet.openで返されたハンドル
$url : ファイルパス 例："http://https:reesoftnet.co.jp/index.htm"
api inet.ftpOpenFile $connect $filename [$rw [$binary]]
return request
サーバーのファイルをオープンしリクエストハンドルを返します
ftp専用コマンドです
$connect : api inet.connectで返されたコネクションハンドル
$filename: ファイル名 例："userlist.dat"
$rw : アクセスモード 'r' か 'w' 省略時：r
/ $binary : バイナリモードなら1を与えます 省略時：1
api inet.read $request
return data
サーバーのファイルを読み込みます
http/ftp共通コマンドです
$request : 下記コマンドで返されたハンドル
api inet.httpRequest
api inet.httpOpenFile
api inet.ftpOpenFile
api inet.write $request $data $length [post]
return wrotesize
サーバーのファイルに書き込みます
書き込んだデータのバイトサイズを返します
-1が返ったらエラーです
巨大サイズのPOSTデータはこのコマンドで送信します
その場合はアーギュメント末尾に"post"を加えて下さい
http/ftp共通コマンドです
$request : 下記コマンドで返されたハンドル
api inet.ftpOpenFile
api inet.httpRequest
$data : 書き込むデータ
$length : $dataのバイトサイズ
japanese
api japanese
return true
OSが日本語OSなら1を返します
myhostname
api myHostName
return hostname
ｺﾝﾋﾟｭｰﾀのDOMAIN名を返します
使用例：
api myHostName
→yoshida3
api getIPaddress yoshida3
→192.168.100.16
api getHostName 192.168.100.16
→yoshida3.local
api getComputerName
→YOSHIDA3
api getIPaddress YOSHIDA3
→192.168.100.16
myipaddress
api myIPaddress
return ipaddress
ｺﾝﾋﾟｭｰﾀのIPｱﾄﾞﾚｽを返します
使用例：
api myIPadddress
→192.168.100.16
api myHostName
→yoshida3
api getIPaddress yoshida3
→192.168.100.16
api getIPaddress localhost
→127.0.0.1
mkdir
api mkDIR $newdirname
return success
新しいﾌｫﾙﾀﾞを作成します
mkfile
api mkFILE $filename
return success
新しい空ﾌｧｲﾙを作成します
作成するだけです。同期処理などに活用します。
open
api open $filename [$mode]
return $path
ﾌｧｲﾙをﾌｧｲﾙﾊﾝﾄﾞﾙを返します
modeを省略するとrbで開きます
mode: c関数 fopen()のmode です。ただしtは不可です。
read
api read $fp $size
return data
reg
api reg set $hkey $key [$varname] $val
api reg get $hkey $key [$varname]
return val
api reg setはレジストリに値をセットします
api reg getはレジストリから値を読み込みます
値のセットではキーの作成もできます
$varnameは省略可能な変数名です
rgb
api rgb $red $green $blue
return COLORREF
COLORREF値を返します
seek
api seek $path $address [$origin]
return newadr
ﾌｧｲﾙﾎﾟｲﾝﾀを移動します
移動後の位置が返ります(ﾌｧｲﾙ先頭からの位置)
$path : api openで返されたﾌｧｲﾙﾊﾝﾄﾞﾙ
$adddress : 移動ﾊﾞｲﾄ数
$origin : 移動原点
"set" : 先頭から
"current" : 現在位置から
"end" : 末尾から
scanfile
api scanFile [$posix] [dir]
return filelist
$posixの条件でﾌｧｲﾙをｽｷｬﾝしてﾌｧｲﾙ名ﾘｽﾄを返します
$posixを省略すると"*.*"指定と見なされます
"dir"を与えるとﾌｫﾙﾀﾞﾘｽﾄを返します
使用例：
foreach file [api scanFile *.exe] {
.....
}
sjisucshex
api SjisUcsHex $sjis
return ucshex
Shift-JIS漢字列をUCSHEXｺｰﾄﾞに変換します
UCSHEXｺｰﾄﾞはShift-JIS漢字コードをユニコードに変換し、
それらを16進数表記することでASCII文字列化したコードです
漢字コードを表す16進数部は
sjis
api sjis $char
return true
$charがShift_JISの先頭ﾊﾞｲﾄか否かを返します
splitutfhex
api SplitUtfHex $utf
return ucshex_list