python-docs-ja/library/ast.po at 2.7 · python/python-docs-ja

History

448 lines (400 loc) · 22.2 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

447

448

# SOME DESCRIPTIVE TITLE.

# This file is distributed under the same license as the Python package.

# Translators:

# 秘湯 <xwhhsprings@gmail.com>, 2016

msgid ""

msgstr ""

"Project-Id-Version: Python 2.7\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2021-01-01 01:01+0900\n"

"PO-Revision-Date: 2019-10-18 09:03+0000\n"

"Last-Translator: tomo\n"

"Language-Team: Japanese (http://www.transifex.com/python-doc/python-27/"

"language/ja/)\n"

"Language: ja\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/ast.rst:2

msgid ":mod:`ast` --- Abstract Syntax Trees"

msgstr ":mod:`ast` --- 抽象構文木"

#: ../../library/ast.rst:10

msgid "The low-level ``_ast`` module containing only the node classes."

msgstr "低級モジュール ``_ast`` はノードクラスだけを含みます。"

#: ../../library/ast.rst:13

msgid "The high-level ``ast`` module containing all helpers."

msgstr "高級モジュール ``ast`` は全てのヘルパーを含みます。"

#: ../../library/ast.rst:16

msgid "**Source code:** :source:`Lib/ast.py`"

msgstr "**ソースコード:** :source:`Lib/ast.py`"

#: ../../library/ast.rst:20

msgid ""

"The :mod:`ast` module helps Python applications to process trees of the "

"Python abstract syntax grammar. The abstract syntax itself might change "

"with each Python release; this module helps to find out programmatically "

"what the current grammar looks like."

msgstr ""

":mod:`ast` モジュールは、Python アプリケーションで Python の抽象構文木を処理"

"しやすくするものです。抽象構文そのものは、Python のリリースごとに変化する可能"

"性があります。このモジュールを使用すると、現在の文法をプログラム上で知る助け"

"になるでしょう。"

#: ../../library/ast.rst:25

msgid ""

"An abstract syntax tree can be generated by passing :data:`ast."

"PyCF_ONLY_AST` as a flag to the :func:`compile` built-in function, or using "

"the :func:`parse` helper provided in this module. The result will be a tree "

"of objects whose classes all inherit from :class:`ast.AST`. An abstract "

"syntax tree can be compiled into a Python code object using the built-in :"

"func:`compile` function."

msgstr ""

"抽象構文木を作成するには、 :data:`ast.PyCF_ONLY_AST` を組み込み関数 :func:"

"`compile` のフラグとして渡すか、あるいはこのモジュールで提供されているヘル"

"パー関数 :func:`parse` を使います。その結果は、 :class:`ast.AST` を継承したク"

"ラスのオブジェクトのツリーとなります。抽象構文木は組み込み関数 :func:"

"`compile` を使って Python コード・オブジェクトにコンパイルすることができま"

"す。"

#: ../../library/ast.rst:33

msgid "Node classes"

msgstr "Node クラス"

#: ../../library/ast.rst:37

msgid ""

"This is the base of all AST node classes. The actual node classes are "

"derived from the :file:`Parser/Python.asdl` file, which is reproduced :ref:"

"`below <abstract-grammar>`. They are defined in the :mod:`_ast` C module "

"and re-exported in :mod:`ast`."

msgstr ""

"このクラスは全ての AST ノード・クラスの基底です。実際のノード・クラスは :ref:"

"`後ほど <abstract-grammar>` 示す :file:`Parser/Python.asdl` ファイルから派生"

"したものです。これらのクラスは :mod:`_ast` C モジュールで定義され、 :mod:"

"`ast` にもエクスポートし直されています。"

#: ../../library/ast.rst:42

msgid ""

"There is one class defined for each left-hand side symbol in the abstract "

"grammar (for example, :class:`ast.stmt` or :class:`ast.expr`). In addition, "

"there is one class defined for each constructor on the right-hand side; "

"these classes inherit from the classes for the left-hand side trees. For "

"example, :class:`ast.BinOp` inherits from :class:`ast.expr`. For production "

"rules with alternatives (aka \"sums\"), the left-hand side class is "

"abstract: only instances of specific constructor nodes are ever created."

msgstr ""

"抽象文法の左辺のシンボル一つずつにそれぞれ一つのクラスがあります (たとえば :"

"class:`ast.stmt` や :class:`ast.expr`)。それに加えて、右辺のコンストラクタ一"

"つずつにそれぞれ一つのクラスがあり、これらのクラスは左辺のツリーのクラスを継"

"承しています。たとえば、 :class:`ast.BinOp` は :class:`ast.expr` から継承して"

"います。代替を伴った生成規則 (production rules with alternatives) (別名 "

"\"sums\") の場合、左辺は抽象クラスとなり、特定のコンストラクタ・ノードのイン"

"スタンスのみが作成されます。"

#: ../../library/ast.rst:52

msgid ""

"Each concrete class has an attribute :attr:`_fields` which gives the names "

"of all child nodes."

msgstr ""

"各具象クラスは属性 :attr:`_fields` を持っており、すべての子ノードの名前をそこ"

"に保持しています。"

#: ../../library/ast.rst:55

msgid ""

"Each instance of a concrete class has one attribute for each child node, of "

"the type as defined in the grammar. For example, :class:`ast.BinOp` "

"instances have an attribute :attr:`left` of type :class:`ast.expr`."

msgstr ""

"具象クラスのインスタンスは、各子ノードに対してそれぞれひとつの属性を持ってい"

"ます。この属性は、文法で定義された型となります。たとえば :class:`ast.BinOp` "

"のインスタンスは :attr:`left` という属性を持っており、その型は :class:`ast."

"expr` です。"

#: ../../library/ast.rst:59

msgid ""

"If these attributes are marked as optional in the grammar (using a question "

"mark), the value might be ``None``. If the attributes can have zero-or-more "

"values (marked with an asterisk), the values are represented as Python "

"lists. All possible attributes must be present and have valid values when "

"compiling an AST with :func:`compile`."

msgstr ""

"これらの属性が、文法上 (クエスチョンマークを用いて) オプションであるとマーク"

"されている場合は、その値が ``None`` となることもあります。属性が0個以上の複数"

"の値をとりうる場合 (アスタリスクでマークされている場合) は、値は Python のリ"

"ストで表されます。全ての属性は AST を :func:`compile` でコンパイルする際には"

"存在しなければならず、そして妥当な値でなければなりません。"

#: ../../library/ast.rst:68

msgid ""

"Instances of :class:`ast.expr` and :class:`ast.stmt` subclasses have :attr:"

"`lineno` and :attr:`col_offset` attributes. The :attr:`lineno` is the line "

"number of source text (1-indexed so the first line is line 1) and the :attr:"

"`col_offset` is the UTF-8 byte offset of the first token that generated the "

"node. The UTF-8 offset is recorded because the parser uses UTF-8 internally."

msgstr ""

":class:`ast.expr` や :class:`ast.stmt` のサブクラスのインスタンスにはさらに :"

"attr:`lineno` や :attr:`col_offset` といった属性があります。 :attr:`lineno` "

"はソーステキスト上の行番号 (1 から数え始めるので、最初の行の行番号は 1 となり"

"ます)、そして :attr:`col_offset` はノードが生成した最初のトークンの UTF-8 バ"

"イトオフセットとなります。 UTF-8 オフセットが記録される理由は、パーサが内部"

"で UTF-8 を使用するからです。"

#: ../../library/ast.rst:75

msgid ""

"The constructor of a class :class:`ast.T` parses its arguments as follows:"

msgstr "クラス :class:`ast.T` のコンストラクタは引数を次のように解析します:"

#: ../../library/ast.rst:77

msgid ""

"If there are positional arguments, there must be as many as there are items "

"in :attr:`T._fields`; they will be assigned as attributes of these names."

msgstr ""

"位置による引数があるとすれば、 :attr:`T._fields` にあるのと同じだけの個数が無"

"ければなりません。これらの引数はそこにある名前を持った属性として割り当てられ"

"ます。"

#: ../../library/ast.rst:79

msgid ""

"If there are keyword arguments, they will set the attributes of the same "

"names to the given values."

msgstr ""

"キーワード引数があるとすれば、それらはその名前の属性にその値を割り当てられま"

"す。"

#: ../../library/ast.rst:82

msgid ""

"For example, to create and populate an :class:`ast.UnaryOp` node, you could "

"use ::"

msgstr ""

"たとえば、 :class:`ast.UnaryOp` ノードを生成して属性を埋めるには、次のように"

"することができます ::"

#: ../../library/ast.rst:94

msgid "or the more compact ::"

msgstr "もしくはよりコンパクトにも書けます ::"

#: ../../library/ast.rst:99

msgid ""

"The constructor as explained above was added. In Python 2.5 nodes had to be "

"created by calling the class constructor without arguments and setting the "

"attributes afterwards."

msgstr ""

"上で説明したコンストラクタが付け加えられました。Python 2.5 においてはノードは"

"引数なしのコンストラクタを呼び出して生成した後、全ての属性をセットしていかな"

"ければなりませんでした。"

#: ../../library/ast.rst:108

msgid "Abstract Grammar"

msgstr "抽象文法 (Abstract Grammar)"

#: ../../library/ast.rst:110

msgid ""

"The module defines a string constant ``__version__`` which is the decimal "

"Subversion revision number of the file shown below."

msgstr ""

"このモジュールでは文字列定数 ``__version__`` を定義しています。これは、以下に"

"示すファイルの 10 進の Subversion リビジョン番号です。"

#: ../../library/ast.rst:113

msgid "The abstract grammar is currently defined as follows:"

msgstr "抽象文法は、現在次のように定義されています:"

#: ../../library/ast.rst:120

msgid ":mod:`ast` Helpers"

msgstr ":mod:`ast` ヘルパー"

#: ../../library/ast.rst:124

msgid ""

"Apart from the node classes, :mod:`ast` module defines these utility "

"functions and classes for traversing abstract syntax trees:"

msgstr ""

"ノード・クラスの他に、 :mod:`ast` モジュールは以下のような抽象構文木をトラ"

"バースするためのユーティリティ関数やクラスも定義しています:"

#: ../../library/ast.rst:129

msgid ""

"Parse the source into an AST node. Equivalent to ``compile(source, "

"filename, mode, ast.PyCF_ONLY_AST)``."

msgstr ""

"*source* を解析して AST ノードにします。``compile(source, filename, mode, "

"ast.PyCF_ONLY_AST)`` と等価です。"

#: ../../library/ast.rst:133 ../../library/ast.rst:151

msgid ""

"It is possible to crash the Python interpreter with a sufficiently large/"

"complex string due to stack depth limitations in Python's AST compiler."

msgstr ""

"十分に大きい文字列や複雑な文字列によって Python の抽象構文木コンパイラのス"

"タックの深さの限界を越えることで、 Python インタプリタをクラッシュさせること"

"ができます。"

#: ../../library/ast.rst:140

msgid ""

"Safely evaluate an expression node or a Unicode or *Latin-1* encoded string "

"containing a Python literal or container display. The string or node "

"provided may only consist of the following Python literal structures: "

"strings, numbers, tuples, lists, dicts, booleans, and ``None``."

msgstr ""

"式ノード、または Python の式を表す Unicode または *Latin-1* エンコード文字"

"列、コンテナのディスプレイ表現を表す文字列、を安全に評価します。与えられる文"

"字列またはノードは次のリテラルのみからなるものに限られます: 文字列, 数, タプ"

"ル, リスト, 辞書, ブール値, ``None`` 。"

#: ../../library/ast.rst:145

msgid ""

"This can be used for safely evaluating strings containing Python values from "

"untrusted sources without the need to parse the values oneself. It is not "

"capable of evaluating arbitrarily complex expressions, for example involving "

"operators or indexing."

msgstr ""

"この関数は Python の式を含んだ信頼出来ない出どころからの文字列を、値自身を解"

"析することなしに安全に評価するのに使えます。この関数は、例えば演算や添え字を"

"含んだ任意の複雑な表現を評価するのには使えません。"

#: ../../library/ast.rst:158

msgid ""

"Return the docstring of the given *node* (which must be a :class:"

"`FunctionDef`, :class:`ClassDef` or :class:`Module` node), or ``None`` if it "

"has no docstring. If *clean* is true, clean up the docstring's indentation "

"with :func:`inspect.cleandoc`."

msgstr ""

"与えられた *node* (これは :class:`FunctionDef`, :class:`ClassDef`, :class:"

"`Module` のいずれかのノードでなければなりません) のドキュメント文字列を返しま"

"す。もしドキュメント文字列が無ければ ``None`` を返します。 *clean* が真なら"

"ば、ドキュメント文字列のインデントを :func:`inspect.cleandoc` を用いて一掃し"

"ます。"

#: ../../library/ast.rst:166

msgid ""

"When you compile a node tree with :func:`compile`, the compiler expects :"

"attr:`lineno` and :attr:`col_offset` attributes for every node that supports "

"them. This is rather tedious to fill in for generated nodes, so this helper "

"adds these attributes recursively where not already set, by setting them to "

"the values of the parent node. It works recursively starting at *node*."

msgstr ""

":func:`compile` はノード・ツリーをコンパイルする際、 :attr:`lineno` と :attr:"

"`col_offset` 両属性をサポートする全てのノードに対しそれが存在するものと想定し"

"ます。生成されたノードに対しこれらを埋めて回るのはどちらかというと退屈な作業"

"なので、このヘルパーが再帰的に二つの属性がセットされていないものに親ノードと"

"同じ値をセットしていきます。再帰の出発点が *node* です。"

#: ../../library/ast.rst:175

msgid ""

"Increment the line number of each node in the tree starting at *node* by "

"*n*. This is useful to \"move code\" to a different location in a file."

msgstr ""

"*node* から始まるツリーの全てのノードの行番号を *n* ずつ増やします。これは"

"ファイルの中で別の場所に「コードを動かす」ときに便利です。"

#: ../../library/ast.rst:181

msgid ""

"Copy source location (:attr:`lineno` and :attr:`col_offset`) from *old_node* "

"to *new_node* if possible, and return *new_node*."

msgstr ""

"ソースの場所 (:attr:`lineno` と :attr:`col_offset`) を *old_node* から "

"*new_node* に可能ならばコピーし、 *new_node* を返します。"

#: ../../library/ast.rst:187

msgid ""

"Yield a tuple of ``(fieldname, value)`` for each field in ``node._fields`` "

"that is present on *node*."

msgstr ""

"*node* にある ``node._fields`` のそれぞれのフィールドを ``(フィールド名, "

"値)`` のタプルとして yield します。"

#: ../../library/ast.rst:193

msgid ""

"Yield all direct child nodes of *node*, that is, all fields that are nodes "

"and all items of fields that are lists of nodes."

msgstr ""

"*node* の直接の子ノード全てを yield します。すなわち、yield されるのは、ノー"

"ドであるような全てのフィールドおよびノードのリストであるようなフィールドの全"

"てのアイテムです。"

#: ../../library/ast.rst:199

msgid ""

"Recursively yield all descendant nodes in the tree starting at *node* "

"(including *node* itself), in no specified order. This is useful if you "

"only want to modify nodes in place and don't care about the context."

msgstr ""

"*node* の全ての子孫ノード(*node* 自体を含む)を再帰的に yield します。順番は決"

"められていません。この関数はノードをその場で変更するだけで文脈を気にしないよ"

"うな場合に便利です。"

#: ../../library/ast.rst:206

msgid ""

"A node visitor base class that walks the abstract syntax tree and calls a "

"visitor function for every node found. This function may return a value "

"which is forwarded by the :meth:`visit` method."

msgstr ""

"抽象構文木を渡り歩いてビジター関数を見つけたノードごとに呼び出すノード・ビジ"

"ターの基底クラスです。この関数は :meth:`visit` メソッドに送られる値を返しても"

"かまいません。"

#: ../../library/ast.rst:210

msgid ""

"This class is meant to be subclassed, with the subclass adding visitor "

"methods."

msgstr ""

"このクラスはビジター・メソッドを付け加えたサブクラスを派生させることを意図し"

"ています。"

#: ../../library/ast.rst:215

msgid ""

"Visit a node. The default implementation calls the method called :samp:"

"`self.visit_{classname}` where *classname* is the name of the node class, "

"or :meth:`generic_visit` if that method doesn't exist."

msgstr ""

"ノードを訪れます。デフォルトの実装では :samp:`self.visit_{classname}` という"

"メソッド (ここで *classname* はノードのクラス名です) を呼び出すか、そのメソッ"

"ドがなければ :meth:`generic_visit` を呼び出します。"

#: ../../library/ast.rst:221

msgid "This visitor calls :meth:`visit` on all children of the node."

msgstr "このビジターはノードの全ての子について :meth:`visit` を呼び出します。"

#: ../../library/ast.rst:223

msgid ""

"Note that child nodes of nodes that have a custom visitor method won't be "

"visited unless the visitor calls :meth:`generic_visit` or visits them itself."

msgstr ""

"注意して欲しいのは、専用のビジター・メソッドを具えたノードの子ノードは、この"

"ビジターが :meth:`generic_visit` を呼び出すかそれ自身で子ノードを訪れない限り"

"訪れられないということです。"

#: ../../library/ast.rst:227

msgid ""

"Don't use the :class:`NodeVisitor` if you want to apply changes to nodes "

"during traversal. For this a special visitor exists (:class:"

"`NodeTransformer`) that allows modifications."

msgstr ""

"トラバースの途中でノードを変化させたいならば :class:`NodeVisitor` を使っては"

"いけません。そうした目的のために変更を許す特別なビジター (:class:"

"`NodeTransformer`) があります。"

#: ../../library/ast.rst:234

msgid ""

"A :class:`NodeVisitor` subclass that walks the abstract syntax tree and "

"allows modification of nodes."

msgstr ""

":class:`NodeVisitor` のサブクラスで抽象構文木を渡り歩きながらノードを変更する"

"ことを許すものです。"

#: ../../library/ast.rst:237

msgid ""

"The :class:`NodeTransformer` will walk the AST and use the return value of "

"the visitor methods to replace or remove the old node. If the return value "

"of the visitor method is ``None``, the node will be removed from its "

"location, otherwise it is replaced with the return value. The return value "

"may be the original node in which case no replacement takes place."

msgstr ""

":class:`NodeTransformer` は抽象構文木(AST)を渡り歩き、ビジター・メソッドの戻"

"り値を使って古いノードを置き換えたり削除したりします。ビジター・メソッドの戻"

"り値が ``None`` ならば、ノードはその場から取り去られ、そうでなければ戻り値で"

"置き換えられます。置き換えない場合は戻り値が元のノードそのものであってもかま"

"いません。"

#: ../../library/ast.rst:243

msgid ""

"Here is an example transformer that rewrites all occurrences of name lookups "

"(``foo``) to ``data['foo']``::"

msgstr ""

"それでは例を示しましょう。Name (たとえば ``foo``) を見つけるたび全て "

"``data['foo']`` に書き換える変換器 (transformer) です::"

#: ../../library/ast.rst:255

msgid ""

"Keep in mind that if the node you're operating on has child nodes you must "

"either transform the child nodes yourself or call the :meth:`generic_visit` "

"method for the node first."

msgstr ""

"操作しようとしているノードが子ノードを持つならば、その子ノードの変形も自分で"

"行うか、またはそのノードに対し最初に :meth:`generic_visit` メソッドを呼び出す"

"か、それを行うのはあなたの責任だということを肝に銘じましょう。"

#: ../../library/ast.rst:259

msgid ""

"For nodes that were part of a collection of statements (that applies to all "

"statement nodes), the visitor may also return a list of nodes rather than "

"just a single node."

msgstr ""

"文のコレクションであるようなノード (全ての文のノードが当てはまります) に対し"

"て、このビジターは単独のノードではなくノードのリストを返すかもしれません。"

#: ../../library/ast.rst:263

msgid "Usually you use the transformer like this::"

msgstr "たいてい、変換器の使い方は次のようになります::"

#: ../../library/ast.rst:270

msgid ""

"Return a formatted dump of the tree in *node*. This is mainly useful for "

"debugging purposes. The returned string will show the names and the values "

"for fields. This makes the code impossible to evaluate, so if evaluation is "

"wanted *annotate_fields* must be set to ``False``. Attributes such as line "

"numbers and column offsets are not dumped by default. If this is wanted, "

"*include_attributes* can be set to ``True``."

msgstr ""

"*node* 中のツリーのフォーマットされたダンプを返します。主な使い道はデバッグで"

"す。返される文字列は名前とフィールドの値を表示します。これを使うとコードは評"

"価できなくなりますので、評価が必要ならば *annotate_fields* に ``False`` を"

"セットしなければなりません。行番号や列オフセットのような属性はデフォルトでは"

"ダンプされません。これが欲しければ、*include_attributes* を ``True`` にセット"

"することができます。"

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

ast.po

Latest commit

History

ast.po

File metadata and controls