From fa797568c185d3ae60ee77523a6b493d9b1ea1e4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=AD=94=E7=8E=8B=E5=8D=B7=E5=AD=90?= Date: Mon, 31 Jul 2023 09:09:11 +0800 Subject: [PATCH] Update language --- language/generators.xml | 4 +- language/oop5.xml | 3 +- language/oop5/visibility.xml | 15 ++++--- language/predefined/arrayaccess.xml | 14 ++----- language/predefined/backedenum.xml | 21 ++++------ language/predefined/iterator.xml | 23 +++++------ language/predefined/iteratoraggregate.xml | 23 +++++------ language/predefined/serializable.xml | 14 ++----- language/predefined/throwable.xml | 21 ++++------ language/predefined/traversable.xml | 14 ++----- language/predefined/unitenum.xml | 14 ++----- language/types.xml | 48 +++++++---------------- language/types/boolean.xml | 2 +- language/types/integer.xml | 6 +-- language/types/null.xml | 4 +- language/types/string.xml | 4 +- 16 files changed, 82 insertions(+), 148 deletions(-) diff --git a/language/generators.xml b/language/generators.xml index 52d33e6f2..8906dc84c 100644 --- a/language/generators.xml +++ b/language/generators.xml @@ -119,7 +119,7 @@ Single digit odd numbers from xrange(): 1 3 5 7 9 - <command>yield</command>关键字 + <command>yield</command> 关键字 生成器函数的核心是yield关键字。它最简单的调用形式看起来像一个return申明，不同之处在于普通return会返回值并终止函数的执行，而yield会返回一个值给循环调用此生成器的代码并且只是暂停执行生成器函数。 @@ -524,7 +524,7 @@ class LineIterator implements Iterator { 不过，这也付出了灵活性的代价： 生成器是一个只能向前的迭代器，一旦开始遍历就无法后退。 - 意思也就是说，同样的生成器无法遍历多遍：要么再次调用生成器函数，重新生成后再遍历。 + 意思也就是说，同样的生成器无法遍历多次：要么再次调用生成器函数，重新生成后再遍历。 diff --git a/language/oop5.xml b/language/oop5.xml index 42c57b8db..bed440507 100644 --- a/language/oop5.xml +++ b/language/oop5.xml @@ -2,7 +2,6 @@ - 类与对象 @@ -19,7 +18,7 @@ linkend="language.oop5.cloning">对象复制。 - PHP 对待对象的方式与引用和句柄相同，即每个变量都持有对象的引用，而不是整个对象的拷贝。参见 + PHP 对待对象的方式等同于引用或句柄，即每个变量都持有对象的引用，而不是整个对象的复制。参见 对象和引用。 &tip.userlandnaming; diff --git a/language/oop5/visibility.xml b/language/oop5/visibility.xml index ffd493610..00809415c 100644 --- a/language/oop5/visibility.xml +++ b/language/oop5/visibility.xml @@ -1,8 +1,7 @@ - - + 访问控制（可见性） @@ -80,7 +79,7 @@ $obj2->printHello(); // 输出 Public2、Protected2 和 Undefined 方法的访问控制 - 类中的方法可以被定义为公有，私有或受保护。如果没有设置这些关键字，则该方法默认为公有。 + 类中的方法可以被定义为 public、private 或 protected。如果没有设置这些关键字，则该方法默认为 public。 @@ -179,7 +178,7 @@ $myFoo->test(); // Bar::testPrivate 常量的控制访问 - PHP 7.1.0 开始，类的常量可以定义为公有、私有或受保护。如果没有设置这些关键字，则该常量默认为公有。 + PHP 7.1.0 开始，类的常量可以定义为 public、private 或 protected。如果没有设置这些关键字，则该常量默认为 public。 @@ -243,11 +242,11 @@ $myclass2->foo2(); // 将会输出：Public Protected，MY_PRIVATE 是私有常 其它对象的访问控制 - 同一个类的对象即使不是同一个实例也可以互相访问对方的私有与受保护成员。 + 同一个类的对象即使不是同一个实例也可以互相访问对方的 private 与 protected 成员。 这是由于在这些对象的内部具体实现的细节都是已知的。 - 访问同一个对象类型的私有成员 + 访问同一个对象类型的 private 成员 foo = 'hello'; var_dump($other->foo); - // 我们也可以调用私有方法： + // 我们也可以调用 private 方法： $other->bar(); } } diff --git a/language/predefined/arrayaccess.xml b/language/predefined/arrayaccess.xml index fb49dfa88..e4ab28d61 100644 --- a/language/predefined/arrayaccess.xml +++ b/language/predefined/arrayaccess.xml @@ -1,6 +1,6 @@ - + ArrayAccess（数组式访问）接口 @@ -22,15 +22,9 @@ - - ArrayAccess - - - - - ArrayAccess - - + + ArrayAccess + &Methods; diff --git a/language/predefined/backedenum.xml b/language/predefined/backedenum.xml index 8728bf0db..8cd28d4cf 100644 --- a/language/predefined/backedenum.xml +++ b/language/predefined/backedenum.xml @@ -1,5 +1,5 @@ - + BackedEnum 接口 @@ -24,19 +24,14 @@ - - BackedEnum - + + BackedEnum + - - - BackedEnum - - - - UnitEnum - - + + extends + UnitEnum + &Methods; diff --git a/language/predefined/iterator.xml b/language/predefined/iterator.xml index 3088cd9b4..2bac17fa8 100644 --- a/language/predefined/iterator.xml +++ b/language/predefined/iterator.xml @@ -1,6 +1,6 @@ - + @@ -23,19 +23,14 @@ - - Iterator - - - - - Iterator - - - - Traversable - - + + Iterator + + + + extends + Traversable + &Methods; diff --git a/language/predefined/iteratoraggregate.xml b/language/predefined/iteratoraggregate.xml index 5db9e7a2f..cbbde68e5 100644 --- a/language/predefined/iteratoraggregate.xml +++ b/language/predefined/iteratoraggregate.xml @@ -1,6 +1,6 @@ - + @@ -23,19 +23,14 @@ - - IteratorAggregate - - - - - IteratorAggregate - - - - Traversable - - + + IteratorAggregate + + + + extends + Traversable + &Methods; diff --git a/language/predefined/serializable.xml b/language/predefined/serializable.xml index 7c8d693c9..7021fde47 100644 --- a/language/predefined/serializable.xml +++ b/language/predefined/serializable.xml @@ -1,6 +1,6 @@ - + Serializable 接口 @@ -39,15 +39,9 @@ - - Serializable - - - - - Serializable - - + + Serializable + &Methods; diff --git a/language/predefined/throwable.xml b/language/predefined/throwable.xml index 6c101f03e..03b6954d1 100644 --- a/language/predefined/throwable.xml +++ b/language/predefined/throwable.xml @@ -1,6 +1,6 @@ - + @@ -30,19 +30,14 @@ - - Throwable - + + Throwable + - - - Throwable - - - - Stringable - - + + extends + Stringable + &Methods; diff --git a/language/predefined/traversable.xml b/language/predefined/traversable.xml index a283eacbc..fd5283dcc 100644 --- a/language/predefined/traversable.xml +++ b/language/predefined/traversable.xml @@ -1,6 +1,6 @@ - + <interfacename>Traversable</interfacename> （遍历）接口 @@ -42,15 +42,9 @@ - - Traversable - - - - - Traversable - - + + Traversable + diff --git a/language/predefined/unitenum.xml b/language/predefined/unitenum.xml index f36a36f36..1871414fe 100644 --- a/language/predefined/unitenum.xml +++ b/language/predefined/unitenum.xml @@ -1,5 +1,5 @@ - + UnitEnum 接口 @@ -24,15 +24,9 @@ - - UnitEnum - - - - - UnitEnum - - + + UnitEnum + &Methods; diff --git a/language/types.xml b/language/types.xml index e6b38098c..889be37b9 100755 --- a/language/types.xml +++ b/language/types.xml @@ -9,8 +9,7 @@ 简介 - Every single expression in PHP has one of the following - built-in types depending on its value: + PHP 中的每个表达式都属于以下某个内置类型，具体取决于值： null bool @@ -25,51 +24,33 @@ - PHP is a dynamically typed language, which means that by default there is - no need to specify the type of a variable, as this will be determined at - runtime. However, it is possible to statically type some aspect of the - language via the use of - type declarations. + PHP 是动态类型语言，这意味着默认不需要指定变量的类型，因为会在运行时确定。然而，可以通过使用类型声明对语言的一些方面进行类型静态化。 - Types restrict the kind of operations that can be performed on them. - However, if an expression/variable is used in an operation which - its type does not support, PHP will attempt to - type juggle - the value into a type that supports the operation. - This process depends on the context in which the value is used. - For more information, see the section on - Type Juggling. + 类型限制了可以对其执行的操作。然而，如果使用的表达式/变量不支持该操作，PHP 将尝试将该值类型转换为操作支持的类型。此过程取决于使用该值的上下文。更多信息参阅类型转换。 - The type comparison tables - may also be useful, as various examples of comparison between values of - different types are present. + 类型比较表也很有用，因为存在不同类型之间的值的各种比较示例。 - It is possible to force an expression to be evaluated to a certain type by - using a type cast. - A variable can also be type cast in-place by using the - settype function on it. + 使用类型转换，强制将表达式的值转换为某种类型。还可以使用 + settype 函数就地对变量进行类型转换。 - To check the value and type of an - expression, - use the var_dump function. - To retrieve the type of an - expression, - use the get_debug_type function. - However, to check if an expression is of a certain type use the - - is_type functions instead. + 使用 var_dump 函数检查表达式的值和类型。使用 + get_debug_type 检索表达式的值和类型。使用 + is_type 检查表达式是否属于某种类型。 @@ -106,9 +87,8 @@ int(16) - Prior to PHP 8.0.0, where the get_debug_type is not - available, the gettype function can be used instead. - However, it doesn't use the canonical type names. + PHP 8.0.0 之前，get_debug_type 无效，可以使用 gettype + 函数代替。但是没有使用规范的类型名称。 diff --git a/language/types/boolean.xml b/language/types/boolean.xml index c4e6c0fbc..9fc76708b 100644 --- a/language/types/boolean.xml +++ b/language/types/boolean.xml @@ -100,7 +100,7 @@ if ($show_separators) { - 单位类型 NULL（包括尚未赋值的变量） + 原子类型 NULL（包括尚未赋值的变量） diff --git a/language/types/integer.xml b/language/types/integer.xml index 80f6ff458..23331c16e 100644 --- a/language/types/integer.xml +++ b/language/types/integer.xml @@ -24,9 +24,9 @@ 语法 - 整型值 Int 可以使用十进制，十六进制，八进制或二进制表示，前面可以加上可选的符号（- 或者 +）。 - 可以用 负运算符 - 来表示一个负的int。 + Int 可以使用十进制，十六进制，八进制或二进制表示，前面可以加上可选的符号（- 或者 +）。 + 可以用负运算符 + 来表示一个负的 int。 diff --git a/language/types/null.xml b/language/types/null.xml index 280050d7e..5e963bb3a 100644 --- a/language/types/null.xml +++ b/language/types/null.xml @@ -6,7 +6,7 @@ NULL - null 类型是 PHP 的单元类型，比如，它仅有一个值 &null;。 + null 类型是 PHP 的原子类型（unit type），也就是说，它仅有一个值 &null;。 @@ -32,7 +32,7 @@ $var = NULL; - 转换到 <literal>NULL</literal> + 转换到 &null; &warn.deprecated.feature-7-2-0.removed-8-0-0; diff --git a/language/types/string.xml b/language/types/string.xml index 03edfa399..e294a8def 100644 --- a/language/types/string.xml +++ b/language/types/string.xml @@ -1090,8 +1090,8 @@ bool(false) 一个值可以通过在其前面加上 (string) 或用 strval 函数来转变成字符串。在一个需要字符串的表达式中，会自动转换为 - string。比如在使用函数 echo 或 print - 时，或在一个变量和一个 string 进行比较时，就会发生这种转换。string。这发生在当使用 echo 或 print + 函数，或当变量与 string 进行比较的时候。类型和类型转换可以更好的解释下面的事情，也可参考函数 settype。