## Tcl8.6.17/Tk8.6.17 Documentation > TDBC Package Commands, version 1.1.12 > tdbc_tokenize

### 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

tdbc::tokenize — TDBC SQL 語彙解析譜　　　TDBC SQL tokenizer

### SYNOPSIS

package require tdbc 1.0
tdbc::tokenize string

### 説明 DESCRIPTION

基礎データ駆動譜の便宜の為に Tcl Database Connectivity (TDBC)は束縛変数が容易に識別され置換される様に SQL 符号命令を解析的語彙に分離する命令を提供している｡　　　　　　 As a convenience to database drivers, Tcl Database Connectivity (TDBC) provides a command to break SQL code apart into tokens so that bound variables can readily be identified and substituted.

tdbc::tokenize 命令は､その媒介変数として一つ或はそれ以上の SQL 命令文を含んでいると予想される文字列を受入れる｡ それは仔文字列のリストを返す; それらの仔文字列を互いに鎖丈に接続すると､元の文字列が得られる｡ それぞれの仔文字列は次の内の一つである:　　　　　　　 The tdbc::tokenize command accepts as its parameter a string that is expected to contain one or more SQL statements. It returns a list of substrings; concatenating these substrings together will yield the original string. Each substring is one of the following:

1. 束縛変数､それは次の文字の内の一つで始まる ':' か '@' か '$' か｡ 文字列の残りは変数の名前であり､英数字文字と下線文字で構成される｡(先頭の文字は非数字｡)　　　　　　 A bound variable, which begins with one of the characters ':', '@', or '$'. The remainder of the string is the variable name and will consist of alphanumeric characters and underscores. (The leading character will be be non-numeric.)

2. セミコロンであって､それは二つの SQL 命令文を分離する｡　　　　　　 A semicolon that separates two SQL statements.

3. それ以外の SQL 命令文｡ 語彙解析機能は SQL を解析しようと試みない; それは単に束縛変数(引用や注釈の内部に現れる､似ている文字列から区別する)と､命令文の区切りと､認識する｡　　　　　　 Something else in a SQL statement. The tokenizer does not attempt to parse SQL; it merely identifies bound variables (distinguishing them from similar strings appearing inside quotes or comments) and statement delimiters.

### SEE ALSO

tdbc, tdbc::connection, tdbc::statement, tdbc::resultset

### KEYWORDS

TDBC, SQL, database, tokenize

### COPYRIGHT

Copyright (c) 2008 by Kevin B. Kenny.
Copyright © 2008 by Kevin B. Kenny.