Skip to content

Commit 2db999a

Browse files
[PHP8.4] DOMXPath::quote()の翻訳 (#192)
* DOMXPath::quote()の翻訳 * 改行とインデントを原文と揃える * 表現の調整 --------- Co-authored-by: 武田 憲太郎 <[email protected]>
1 parent 2e698ff commit 2db999a

File tree

1 file changed

+128
-0
lines changed

1 file changed

+128
-0
lines changed

reference/dom/domxpath/quote.xml

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: bac9d6a54fae363b3cc337bda924a76ff47e8851 Maintainer: Ippey Status: ready -->
4+
<refentry xml:id="domxpath.quote" xmlns="http://docbook.org/ns/docbook">
5+
<refnamediv>
6+
<refname>DOMXPath::quote</refname>
7+
<refpurpose>
8+
XPath 式で使用できるよう、文字列のまわりに引用符を付けます
9+
</refpurpose>
10+
</refnamediv>
11+
12+
<refsect1 role="description">
13+
&reftitle.description;
14+
<methodsynopsis role="DOMXPath">
15+
<modifier>public</modifier> <modifier>static</modifier> <type>string</type><methodname>DOMXPath::quote</methodname>
16+
<methodparam><type>string</type><parameter>str</parameter></methodparam>
17+
</methodsynopsis>
18+
<simpara>
19+
XPath 式で使用できるよう、 <parameter>str</parameter> のまわりに引用符を付けます。
20+
</simpara>
21+
</refsect1>
22+
23+
<refsect1 role="parameters">
24+
&reftitle.parameters;
25+
<para>
26+
<variablelist>
27+
<varlistentry>
28+
<term><parameter>str</parameter></term>
29+
<listitem>
30+
<simpara>
31+
引用符をつける文字列
32+
</simpara>
33+
</listitem>
34+
</varlistentry>
35+
</variablelist>
36+
</para>
37+
</refsect1>
38+
39+
<refsect1 role="returnvalues">
40+
&reftitle.returnvalues;
41+
<simpara>
42+
XPath 式に使うことのできる引用符付きの文字列を返します。
43+
</simpara>
44+
</refsect1>
45+
46+
<refsect1 role="examples">
47+
&reftitle.examples;
48+
<example>
49+
<title>引用符を含む属性値の変換</title>
50+
<programlisting role="php">
51+
<![CDATA[
52+
<?php
53+
$doc = new DOMDocument;
54+
$doc->loadXML(<<<XML
55+
<books>
56+
<book name="'quoted' name">Book title</book>
57+
</books>
58+
XML);
59+
60+
$xpath = new DOMXPath($doc);
61+
62+
$query = "//book[@name=" . DOMXPath::quote("'quoted' name") . "]";
63+
echo $query, "\n";
64+
65+
$entries = $xpath->query($query);
66+
67+
foreach ($entries as $entry) {
68+
echo "Found ", $entry->textContent, "\n";
69+
}
70+
?>
71+
]]>
72+
</programlisting>
73+
&example.outputs;
74+
<screen>
75+
<![CDATA[
76+
//book[@name="'quoted' name"]
77+
Found Book title
78+
]]>
79+
</screen>
80+
<simpara>
81+
引用符が混在している文字列もサポートします:
82+
</simpara>
83+
<programlisting role="php">
84+
<![CDATA[
85+
<?php
86+
echo DOMXPath::quote("'different' \"quote\" styles");
87+
?>
88+
]]>
89+
</programlisting>
90+
&example.outputs;
91+
<screen>
92+
<![CDATA[
93+
concat("'different' ",'"quote" styles')
94+
]]>
95+
</screen>
96+
</example>
97+
</refsect1>
98+
99+
<refsect1 role="seealso">
100+
&reftitle.seealso;
101+
<para>
102+
<simplelist>
103+
<member><methodname>DOMXPath::evaluate</methodname></member>
104+
<member><methodname>DOMXPath::query</methodname></member>
105+
</simplelist>
106+
</para>
107+
</refsect1>
108+
</refentry>
109+
<!-- Keep this comment at the end of the file
110+
Local variables:
111+
mode: sgml
112+
sgml-omittag:t
113+
sgml-shorttag:t
114+
sgml-minimize-attributes:nil
115+
sgml-always-quote-attributes:t
116+
sgml-indent-step:1
117+
sgml-indent-data:t
118+
indent-tabs-mode:nil
119+
sgml-parent-document:nil
120+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
121+
sgml-exposed-tags:nil
122+
sgml-local-catalogs:nil
123+
sgml-local-ecat-files:nil
124+
End:
125+
vim600: syn=xml fen fdm=syntax fdl=2 si
126+
vim: et tw=78 syn=sgml
127+
vi: ts=1 sw=1
128+
-->

0 commit comments

Comments
 (0)