diff --git a/language/predefined/backedenum/from.xml b/language/predefined/backedenum/from.xml new file mode 100644 index 00000000..a5dccc72 --- /dev/null +++ b/language/predefined/backedenum/from.xml @@ -0,0 +1,112 @@ + + + + + + BackedEnum::from + Mapuje skalar na instancję enum + + + + &reftitle.description; + + public static staticBackedEnum::from + intstringvalue + + + Metoda from tłumaczy ciąg znaków string lub liczbę całkowitą int + na odpowiedni przypadek Enuma, jeśli taki istnieje. Jeśli nie zdefiniowano pasującego przypadku, + zostanie zgłoszony błądValueError. + + + + + + &reftitle.parameters; + + + value + + + Wartość skalarna do mapowania na przypadek enuma. + + + + + + + + &reftitle.returnvalues; + + Instancja przypadku tego wyliczenia. + + + + + &reftitle.examples; + + Podstawowe użycie + + Poniższy przykład ilustruje sposób zwracania przypadków enum. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + + UnitEnum::cases + BackedEnum::tryFrom + + + + + + diff --git a/language/predefined/backedenum/tryfrom.xml b/language/predefined/backedenum/tryfrom.xml new file mode 100644 index 00000000..dc0b95e8 --- /dev/null +++ b/language/predefined/backedenum/tryfrom.xml @@ -0,0 +1,113 @@ + + + + + + BackedEnum::tryFrom + Mapuje skalar na instancję enum lub null + + + + &reftitle.description; + + public static staticnullBackedEnum::tryFrom + intstringvalue + + + Metoda tryFrom tłumaczy ciąg znaków string lub liczbę całkowitą int + na odpowiedni przypadek Enum, jeśli taki istnieje. Jeśli nie ma zdefiniowanego pasującego przypadku, + zwróci wartość null. + + + + + + &reftitle.parameters; + + + value + + + Wartość skalarna do mapowania na przypadek enum. + + + + + + + + &reftitle.returnvalues; + + Instancja przypadku tego wyliczenia lub null, jeśli nie został znaleziony. + + + + + &reftitle.examples; + + Podstawowe użycie + + Poniższy przykład ilustruje sposób zwracania przypadków enum. + + + +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + + UnitEnum::cases + BackedEnum::from + + + + + + diff --git a/language/predefined/closure/bind.xml b/language/predefined/closure/bind.xml new file mode 100644 index 00000000..16de2a30 --- /dev/null +++ b/language/predefined/closure/bind.xml @@ -0,0 +1,133 @@ + + + + + + Closure::bind + + Duplikuje domknięcie z określonym powiązanym obiektem i zakresem klasy + + + + + &reftitle.description; + + public static ClosurenullClosure::bind + Closureclosure + objectnullnewThis + objectstringnullnewScope"static" + + + Ta metoda jest statyczną wersją metody Closure::bindTo. + Więcej informacji można znaleźć w dokumentacji tej metody. + + + + + + &reftitle.parameters; + + + closure + + + Funkcje anonimowe do powiązania. + + + + + newThis + + + Obiekt, z którym dana funkcja anonimowa powinna być powiązana lub + &null;, aby domknięcie nie było powiązane. + + + + + newScope + + + Zakres klasy, z którą ma być powiązane domknięcie lub + 'static', aby zachować bieżący. Jeśli podano obiekt, + zamiast tego zostanie użyty typ obiektu. Określa to widoczność chronionych + i prywatnych metod powiązanego obiektu. + Niedozwolone jest przekazywanie (obiektu) klasy wewnętrznej jako tego parametru. + + + + + + + + &reftitle.returnvalues; + + Zwraca nowy obiekt Closure object lub &null; przy niepowodzeniu. + + + + + &reftitle.examples; + + Przykład <function>Closure::bind</function> + +ifoo; +}; + +$bcl1 = Closure::bind($cl1, null, 'A'); +$bcl2 = Closure::bind($cl2, new A(), 'A'); +echo $bcl1(), "\n"; +echo $bcl2(), "\n"; +?> +]]> + + &example.outputs.similar; + + + + + + + + + &reftitle.seealso; + + Funkcje anonimowe + Closure::bindTo + + + + + diff --git a/language/predefined/closure/bindto.xml b/language/predefined/closure/bindto.xml new file mode 100644 index 00000000..7d024ce6 --- /dev/null +++ b/language/predefined/closure/bindto.xml @@ -0,0 +1,169 @@ + + + + + + Closure::bindTo + + Duplikuje domknięcie z nowym powiązanym obiektem i zakresem klasy + + + + + &reftitle.description; + + public ClosurenullClosure::bindTo + objectnullnewThis + objectstringnullnewScope"static" + + + Tworzy i zwraca nową funkcję + anonimową z tym samym ciałem i powiązanymi zmiennymi co ta, + ale prawdopodobnie z innym powiązanym obiektem i nowym zakresem klasy. + + + + “Powiązany obiekt” określa wartość $this jaką + będzie miało ciało funkcji, a “zakres klasy” reprezentuje klasę, + która określa, do których prywatnych i chronionych członków anonimowa + funkcja będzie miała dostęp. Mianowicie, członkowie, którzy będą + widoczni, są tacy sami, jak gdyby anonimowa funkcja była metodą + klasy podanej jako wartość parametru newScope. + + + + Statyczne domknięcia nie mogą mieć żadnego powiązanego obiektu (wartość parametru + newThis powinna mieć wartość &null;), ale mimo to metoda + ta może być użyta do zmiany zakresu ich klasy. + + + + Ta metoda zapewni, że dla niestatycznego domknięcia, posiadanie powiązanej + instancji będzie oznaczać zakresu i odwrotnie. W tym celu + niestatyczne domknięcia, które mają zakres, ale instancję &null; są + statyczne, a niestatyczne domknięcia bez zakresu, które mają instancję inną niż null + są przypisywane do nieokreślonej klasy. + + + + + Jeśli chcesz zduplikować tylko anonimowe funkcje, możesz zamiast tego użyć + klonowania. + + + + + + + &reftitle.parameters; + + + newThis + + + Obiekt, z którym dana funkcja anonimowa powinna być powiązana lub + &null; dla domknięcia, które ma być niepowiązane. + + + + + newScope + + + Zakres klasy, do której ma być przypisane domknięcie lub + 'static', aby zachować bieżący. eśli podano obiekt, zamiast tego zostanie + użyty typ obiektu. Określa on widoczność chronionych + i prywatnych metod powiązanego obiektu. + Niedozwolone jest przekazywanie (obiektu) klasy wewnętrznej jako tego parametru. + + + + + + + + &reftitle.returnvalues; + + Zwraca nowo utworzony obiekt Closure + lub &null; przy niepowodzeniu. + + + + + &reftitle.examples; + + Przyład <function>Closure::bindTo</function> + +val = $val; + } + + public function getClosure() + { + // Zwraca domknięcie powiązane z tym obiektem i zakresem + return function() { + return $this->val; + }; + } +} + +$ob1 = new A(1); +$ob2 = new A(2); + +$cl = $ob1->getClosure(); +echo $cl(), "\n"; + +$cl = $cl->bindTo($ob2); +echo $cl(), "\n"; + +?> +]]> + + &example.outputs.similar; + + + + + + + + + &reftitle.seealso; + + Funkcje anonimowe + Closure::bind + + + + + diff --git a/language/predefined/closure/call.xml b/language/predefined/closure/call.xml new file mode 100644 index 00000000..f763e409 --- /dev/null +++ b/language/predefined/closure/call.xml @@ -0,0 +1,107 @@ + + + + + + Closure::call + Wiąże i wywołuje domknięcie + + + &reftitle.description; + + public mixedClosure::call + objectnewThis + mixedargs + + + Tymczasowo wiąże domknięcie z newThis, i wywołuje + je z podanymi parametrami. + + + + &reftitle.parameters; + + + newThis + + + Obiekt do powiązania domknięcia na czas trwania + wywołania. + + + + + args + + + Zero lub więcej parametrów, które zostaną przekazane jako parametry do + domknięcia. + + + + + + + &reftitle.returnvalues; + + Zwraca wartość zwracaną domknięcia. + + + + &reftitle.examples; + + Przykład <function>Closure::call</function> + +value = $value; + } + + public function getValue() { + return $this->value; + } +} + +$three = new Value(3); +$four = new Value(4); + +$closure = function ($delta) { var_dump($this->getValue() + $delta); }; +$closure->call($three, 4); +$closure->call($four, 4); +?> +]]> + + &example.outputs; + + + + + + + diff --git a/language/predefined/closure/construct.xml b/language/predefined/closure/construct.xml new file mode 100644 index 00000000..65d3576c --- /dev/null +++ b/language/predefined/closure/construct.xml @@ -0,0 +1,59 @@ + + + + + + Closure::__construct + Konstruktor, który nie pozwala na tworzenie instancji + + + + &reftitle.description; + + private Closure::__construct + + + + Ta metoda istnieje tylko po to, aby uniemożliwić tworzenie instancji klasy + Closure. Obiekty tej klasy są tworzone + w sposób opisany na stronie + funkcje anonimowe. + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.seealso; + + + Funkcje anonimowe + + + + + + diff --git a/language/predefined/closure/fromcallable.xml b/language/predefined/closure/fromcallable.xml new file mode 100644 index 00000000..28a45df5 --- /dev/null +++ b/language/predefined/closure/fromcallable.xml @@ -0,0 +1,81 @@ + + + + + + Closure::fromCallable + Przekształca callable w domknięcie + + + + &reftitle.description; + + public static ClosureClosure::fromCallable + callablecallback + + + Tworzy i zwraca nową funkcję + anonimową z podanego parametru callback przy + użyciu bieżącego zakresu. Ta metoda sprawdza, czy callback jest + callable w bieżącym zakresie i zgłasza błąd TypeError, + jeśli tak nie jest. + + + + Od PHP 8.1.0, składnia callable pierwszej klasy ma taką samą semantykę jak ta metoda. + + + + + + &reftitle.parameters; + + + callback + + + Callable do przekształcenia. + + + + + + + + &reftitle.returnvalues; + + Zwraca nowo utworzone Domknięcie lub zgłasza błąd + TypeError, jeśli parametr callback nie + jest callable w bieżącym zakresie. + + + + + &reftitle.seealso; + + Funkcje anonimowe + Składnia callable pierwszej klasy + + + + + diff --git a/language/predefined/countable.xml b/language/predefined/countable.xml new file mode 100644 index 00000000..44179cc2 --- /dev/null +++ b/language/predefined/countable.xml @@ -0,0 +1,63 @@ + + + + + + Interfejs Countable + Countable + + + + +
+ &reftitle.intro; + + Klasy implementujące Countable mogą być używane z + funkcją count. + +
+ + +
+ &reftitle.interfacesynopsis; + + + + + Countable + + + &Methods; + + + + + + +
+ + + + &language.predefined.countable.count; + + + diff --git a/language/predefined/countable/count.xml b/language/predefined/countable/count.xml new file mode 100644 index 00000000..d7270ca8 --- /dev/null +++ b/language/predefined/countable/count.xml @@ -0,0 +1,100 @@ + + + + + + Countable::count + Liczy elementy obiektu + + + + &reftitle.description; + + public intCountable::count + + + + Metoda ta jest wykonywana, gdy parametr value dla + count obiektem implementującym + Countable. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Niestandardowe obliczenie jako liczba całkowita int. + + + + + &reftitle.examples; + + <function>Countable::count</function> example + +count; + } +} + +$counter = new Counter; + +for ($i = 0; $i < 10; ++$i) { + echo "I have been count()ed " . count($counter) . " times\n"; +} + +?> +]]> + + &example.outputs.similar; + + + + + + + + diff --git a/language/predefined/fiber/construct.xml b/language/predefined/fiber/construct.xml new file mode 100644 index 00000000..00fc5903 --- /dev/null +++ b/language/predefined/fiber/construct.xml @@ -0,0 +1,54 @@ + + + + + + Fiber::__construct + Tworzy nową instancję Fiber + + + + &reftitle.description; + + public Fiber::__construct + callablecallback + + + + + &reftitle.parameters; + + + callback + + + Callable do wywołania podczas uruchamiania fibera. + Argumenty podane do Fiber::start zostaną + dostarczone jako argumenty do podanego callable. + + + + + + + + diff --git a/language/predefined/fiber/getcurrent.xml b/language/predefined/fiber/getcurrent.xml new file mode 100644 index 00000000..634afee4 --- /dev/null +++ b/language/predefined/fiber/getcurrent.xml @@ -0,0 +1,53 @@ + + + + + + Fiber::getCurrent + Pobiera aktualnie wykonywaną instancję Fiber + + + + &reftitle.description; + + public static FibernullFiber::getCurrent + + + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca aktualnie wykonywaną instancję Fiber lub &null;, jeśli ta metoda jest + wywoływana spoza fibera. + + + + + diff --git a/language/predefined/fiber/getreturn.xml b/language/predefined/fiber/getreturn.xml new file mode 100644 index 00000000..0dbb3cd1 --- /dev/null +++ b/language/predefined/fiber/getreturn.xml @@ -0,0 +1,54 @@ + + + + + + Fiber::getReturn + Pobiera wartość zwracaną przez Fiber + + + + &reftitle.description; + + public mixedFiber::getReturn + + + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca wartość zwróconą przez callable dostarczoną do Fiber::__construct. + Jeśli fiber nie zwrócił wartości, ponieważ nie został uruchomiony, nie zakończył działania lub zgłosił wyjątek + zostanie zgłoszony błąd FiberError. + + + + + diff --git a/language/predefined/fiber/isrunning.xml b/language/predefined/fiber/isrunning.xml new file mode 100644 index 00000000..32990272 --- /dev/null +++ b/language/predefined/fiber/isrunning.xml @@ -0,0 +1,55 @@ + + + + + + Fiber::isRunning + Określa, czy fiber jest uruchomiony + + + + &reftitle.description; + + public boolFiber::isRunning + + + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca &true; tylko wtedy, gdy fiber jest uruchomiony. Fiber jest uważany za działający po wywołaniu + Fiber::start, Fiber::resume, lub + Fiber::throw, które jeszcze niczego nie zwróciło. + Zwraca &false;, jeśli fiber nie jest uruchomiony. + + + + + diff --git a/language/predefined/fiber/isstarted.xml b/language/predefined/fiber/isstarted.xml new file mode 100644 index 00000000..a082279a --- /dev/null +++ b/language/predefined/fiber/isstarted.xml @@ -0,0 +1,52 @@ + + + + + + Fiber::isStarted + Określa, czy fiber został uruchomiony + + + + &reftitle.description; + + public boolFiber::isStarted + + + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca &true; tylko po uruchomieniu fibera; w przeciwnym razie zwracana jest wartość &false;. + + + + + diff --git a/language/predefined/fiber/issuspended.xml b/language/predefined/fiber/issuspended.xml new file mode 100644 index 00000000..fbd79c50 --- /dev/null +++ b/language/predefined/fiber/issuspended.xml @@ -0,0 +1,52 @@ + + + + + + Fiber::isSuspended + Określa, czy fiber jest zawieszony + + + + &reftitle.description; + + public boolFiber::isSuspended + + + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca &true;, jeśli fiber jest aktualnie zawieszony; w przeciwnym razie zwracana jest wartość &false;. + + + + + diff --git a/language/predefined/fiber/isterminated.xml b/language/predefined/fiber/isterminated.xml new file mode 100644 index 00000000..aa849342 --- /dev/null +++ b/language/predefined/fiber/isterminated.xml @@ -0,0 +1,53 @@ + + + + + + Fiber::isTerminated + Określa, czy fiber został zakończony + + + + &reftitle.description; + + public boolFiber::isTerminated + + + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca &true; tylko po zakończeniu działania fibera, poprzez wywołanie return lub zgłoszenie wyjątku; + w przeciwnym razie zwracana jest wartość &false;. + + + + + diff --git a/language/predefined/fiber/resume.xml b/language/predefined/fiber/resume.xml new file mode 100644 index 00000000..cb5fa6a7 --- /dev/null +++ b/language/predefined/fiber/resume.xml @@ -0,0 +1,67 @@ + + + + + + Fiber::resume + Wznawia wykonywanie fiber z wartością + + + + &reftitle.description; + + public mixedFiber::resume + mixedvalue&null; + + + Wznawia działanie fibera używając podanej wartości jako wyniku bieżącego wywołania Fiber::suspend. + + + Jeśli fiber nie jest zawieszony w momencie wywołania tej metody, zostanie wyrzucony błąd FiberError. + + + + + &reftitle.parameters; + + + value + + + Wartość do wznowienia działania fibera. Wartość ta będzie wartością zwracaną bieżącego wywołania + Fiber::suspend. + + + + + + + + &reftitle.returnvalues; + + Wartość przekazywana do następnego wywołania metody Fiber::suspend lub &null; jeśli fiber powróci. + Jeśli fiber zgłosi wyjątek przed zawieszeniem, zostanie on zgłoszony z wywołania do tej metody. + + + + + diff --git a/language/predefined/fiber/start.xml b/language/predefined/fiber/start.xml new file mode 100644 index 00000000..cd01a99a --- /dev/null +++ b/language/predefined/fiber/start.xml @@ -0,0 +1,66 @@ + + + + + + Fiber::start + Rozpoczyna wykonywanie fibera + + + + &reftitle.description; + + public mixedFiber::start + mixedargs + + + Zmienna lista argumentów do przekazania do callable używanego podczas konstruowania fibera. + + + Jeśli fiber został już uruchomiony w momencie wywołania tej metody, zostanie zgłoszony błąd FiberError. + + + + + &reftitle.parameters; + + + args + + + Argumenty do użycia podczas wywoływania callable przekazanego do konstruktora fiber. + + + + + + + + &reftitle.returnvalues; + + Wartość przekazana pierwszemu wywołaniu metody Fiber::suspend lub &null;, jeśli fiber powróci. + Jeśli fiber zgłosi wyjątek przed zawieszeniem, zostanie on wyrzucony z wywołania do tej metody. + + + + + diff --git a/language/predefined/fiber/suspend.xml b/language/predefined/fiber/suspend.xml new file mode 100644 index 00000000..09f14c9d --- /dev/null +++ b/language/predefined/fiber/suspend.xml @@ -0,0 +1,75 @@ + + + + + + Fiber::suspend + Zawiesza wykonywanie bieżącego fibera + + + + &reftitle.description; + + public static mixedFiber::suspend + mixedvalue&null; + + + Zawiesza wykonywanie bieżącego fiber. Wartość przekazana tej metodzie zostanie zwrócona z wywołania do + Fiber::start, Fiber::resume, lub + Fiber::throw, które przełączyło wykonywanie na bieżący fiber. + + + Gdy fiber zostanie wznowiony, ta metoda zwraca wartość przekazaną do metody Fiber::resume. + Jeśli fiber zostanie wznowiony przy użyciu Fiber::throw, wyjątek przekazany tej metodzie + zostanie zgłoszony z wywołania tej metody. + + + Jeśli metoda ta zostanie wywołana spoza fiber, zostanie zgłoszony błąd FiberError. + + + + + &reftitle.parameters; + + + value + + + Wartość zwracana z wywołania metody Fiber::start, + Fiber::resume, lub Fiber::throw, + które przełączyło wykonanie na bieżący fiber. + + + + + + + + &reftitle.returnvalues; + + Wartość przekazana do metody Fiber::resume. + + + + + + diff --git a/language/predefined/fiber/throw.xml b/language/predefined/fiber/throw.xml new file mode 100644 index 00000000..d66de938 --- /dev/null +++ b/language/predefined/fiber/throw.xml @@ -0,0 +1,66 @@ + + + + + + Fiber::throw + Wznawia wykonywanie fiber z wyjątkiem + + + + &reftitle.description; + + public mixedFiber::throw + Throwableexception + + + Wznawia działanie fibera rzucając podany wyjątek z bieżącego wywołania metody Fiber::suspend. + + + Jeśli fiber nie jest zawieszony w momencie wywołania tej metody, zostanie rzucony błąd FiberError. + + + + + &reftitle.parameters; + + + exception + + + Wyjątek do zgłoszenia do fiber z bieżącego wywołania metody Fiber::suspend. + + + + + + + + &reftitle.returnvalues; + + Wartość przekazywana do następnego wywołania metody Fiber::suspend lub &null;, jeśli fiber powróci. + Jeśli fiber zgłosi wyjątek przed zawieszeniem, zostanie on zgłoszony z wywołania do tej metody. + + + + +