svn: /phpdoc/ja/trunk/reference/strings/functions/ str-ends-with.xml str-starts-with.xml

[email protected] (Yoshinari Takaoka)
Newsgroups php.doc.ja
Message-ID <[email protected]>
mumumu                                   Tue, 24 Nov 2020 02:23:01 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=351560

Log:
Added documentation for the str_starts_with and str_ends_with functions based on https://php.watch/versions/8.0/str_starts_with-str_ends_with

Patch contributed by Emmanuel Okeke <[email protected]>.

Changed paths:
    A   phpdoc/ja/trunk/reference/strings/functions/str-ends-with.xml
    A   phpdoc/ja/trunk/reference/strings/functions/str-starts-with.xml
svn-diffs-351560.txt (text/x-diff, 9.1 KB)
Added: phpdoc/ja/trunk/reference/strings/functions/str-ends-with.xml
===================================================================
--- phpdoc/ja/trunk/reference/strings/functions/str-ends-with.xml	                        (rev 0)
+++ phpdoc/ja/trunk/reference/strings/functions/str-ends-with.xml	2020-11-24 02:23:01 UTC (rev 351560)
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 351549 Maintainer: mumumu Status: ready -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-ends-with">
+ <refnamediv>
+  <refname>str_ends_with</refname>
+  <refpurpose>文字列が、指定された文字列で終わるかを調べる。</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>str_ends_with</methodname>
+   <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
+   <methodparam><type>string</type><parameter>needle</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <parameter>haystack</parameter> が
+   <parameter>needle</parameter> で終わるかを調べます。
+   大文字小文字は区別されます。
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>haystack</parameter></term>
+     <listitem>
+      <para>
+       検索対象の文字列。
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>needle</parameter></term>
+     <listitem>
+      <para>
+       <parameter>haystack</parameter> で調べる部分文字列
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <parameter>haystack</parameter> が
+   <parameter>needle</parameter> で終わる場合、&true; を返します。
+   そうでない場合、&false; を返します。
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>空文字列 <literal>''</literal> を使う場合</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+if (str_ends_with('abc', '')) {
+    echo "All strings end with the empty string";
+}
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+All strings end with the empty string
+]]>
+    </screen>
+   </example>
+
+   <example>
+    <title>大文字小文字の区別</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$string = 'The lazy fox jumped over the fence';
+
+if (str_ends_with($string, 'fence')) {
+    echo "The string ends with 'fence'\n";
+}
+
+if (str_ends_with($string, 'Fence')) {
+    echo 'The string ends with "fence"';
+} else {
+    echo '"fence" was not found because the case does not match';
+}
+
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+The string ends with 'fence'
+"fence" was not found because the case does not match
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &note.bin-safe;
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>str_contains</function></member>
+    <member><function>str_starts_with</function></member>
+    <member><function>stripos</function></member>
+    <member><function>strrpos</function></member>
+    <member><function>strripos</function></member>
+    <member><function>strstr</function></member>
+    <member><function>strpbrk</function></member>
+    <member><function>substr</function></member>
+    <member><function>preg_match</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ja/trunk/reference/strings/functions/str-ends-with.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ja/trunk/reference/strings/functions/str-starts-with.xml
===================================================================
--- phpdoc/ja/trunk/reference/strings/functions/str-starts-with.xml	                        (rev 0)
+++ phpdoc/ja/trunk/reference/strings/functions/str-starts-with.xml	2020-11-24 02:23:01 UTC (rev 351560)
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 351549 Maintainer: mumumu Status: ready -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.str-starts-with">
+ <refnamediv>
+  <refname>str_starts_with</refname>
+  <refpurpose>文字列が指定された部分文字列で始まるかを調べる</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>str_starts_with</methodname>
+   <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
+   <methodparam><type>string</type><parameter>needle</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <parameter>haystack</parameter>
+   が <parameter>needle</parameter> で始まるかを調べます。
+   大文字小文字は区別されます。
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>haystack</parameter></term>
+     <listitem>
+      <para>
+       検索対象の文字列
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>needle</parameter></term>
+     <listitem>
+      <para>
+       <parameter>haystack</parameter> で調べる部分文字列
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <parameter>haystack</parameter> が
+   <parameter>needle</parameter> で始まる場合、
+   &true; を返します。そうでない場合、&false; を返します。
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>空文字列 <literal>''</literal> を使う場合</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+if (str_starts_with('abc', '')) {
+    echo "All strings start with the empty string";
+}
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+All strings start with the empty string
+]]>
+    </screen>
+   </example>
+
+   <example>
+    <title>大文字小文字の区別</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$string = 'The lazy fox jumped over the fence';
+
+if (str_starts_with($string, 'The')) {
+    echo "The string starts with 'The'\n";
+}
+
+if (str_starts_with($string, 'the')) {
+    echo 'The string starts with "the"';
+} else {
+    echo '"the" was not found because the case does not match';
+}
+
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen role="php">
+<![CDATA[
+The string starts with 'The'
+"the" was not found because the case does not match
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  &note.bin-safe;
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>str_contains</function></member>
+    <member><function>str_ends_with</function></member>
+    <member><function>stripos</function></member>
+    <member><function>strrpos</function></member>
+    <member><function>strripos</function></member>
+    <member><function>strstr</function></member>
+    <member><function>strpbrk</function></member>
+    <member><function>substr</function></member>
+    <member><function>preg_match</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ja/trunk/reference/strings/functions/str-starts-with.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.