diff --git a/language/predefined/generator/current.xml b/language/predefined/generator/current.xml new file mode 100644 index 00000000..5192e38c --- /dev/null +++ b/language/predefined/generator/current.xml @@ -0,0 +1,51 @@ + + + + + + Generator::current + Pobierz uzyskaną wartość + + + + &reftitle.description; + + public mixedGenerator::current + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca uzyskaną wartość. + + + + + + diff --git a/language/predefined/generator/getreturn.xml b/language/predefined/generator/getreturn.xml new file mode 100644 index 00000000..8b1a2eb7 --- /dev/null +++ b/language/predefined/generator/getreturn.xml @@ -0,0 +1,84 @@ + + + + + + Generator::getReturn + Pobiera wartość zwracaną generatora + + + + &reftitle.description; + + public mixedGenerator::getReturn + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca wartość zwrotną generatora po zakończeniu wykonywania. + + + + + &reftitle.examples; + + + Przykład <methodname>Generator::getReturn</methodname> + +getReturn(), PHP_EOL; +]]> + + &example.outputs; + + + + + + + + diff --git a/language/predefined/generator/key.xml b/language/predefined/generator/key.xml new file mode 100644 index 00000000..1eb53d1a --- /dev/null +++ b/language/predefined/generator/key.xml @@ -0,0 +1,81 @@ + + + + + + Generator::key + Pobiera uzyskany klucz + + + + &reftitle.description; + + public mixedGenerator::key + + + + Pobiera klucz uzyskanej wartości. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca uzyskany klucz. + + + + + &reftitle.examples; + + + Przykład <methodname>Generator::key</methodname> + + 'value'; +} + +$gen = Gen(); + +echo "{$gen->key()} => {$gen->current()}"; +]]> + + &example.outputs; + + value +]]> + + + + + + diff --git a/language/predefined/generator/next.xml b/language/predefined/generator/next.xml new file mode 100644 index 00000000..ac816b32 --- /dev/null +++ b/language/predefined/generator/next.xml @@ -0,0 +1,55 @@ + + + + + + Generator::next + Wznowienie działania generatora + + + + &reftitle.description; + + public voidGenerator::next + + + + Wywołanie metody Generator::next ma taki sam efekt jak wywołanie + Generator::send z &null; jako argument. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + + + diff --git a/language/predefined/generator/rewind.xml b/language/predefined/generator/rewind.xml new file mode 100644 index 00000000..6af44331 --- /dev/null +++ b/language/predefined/generator/rewind.xml @@ -0,0 +1,55 @@ + + + + + + Generator::rewind + Przewija iterator + + + + &reftitle.description; + + public voidGenerator::rewind + + + + Jeśli iteracja już się rozpoczęła, zostanie zgłoszony wyjątek. + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + + + diff --git a/language/predefined/generator/send.xml b/language/predefined/generator/send.xml new file mode 100644 index 00000000..3b4674ce --- /dev/null +++ b/language/predefined/generator/send.xml @@ -0,0 +1,103 @@ + + + + + + Generator::send + Wysyła wartość do generatora + + + + &reftitle.description; + + public mixedGenerator::send + mixedvalue + + + Wysyła podaną wartość do generatora jako wynik bieżącego wyrażenia &yield; + i wznawia wykonywanie generatora. + + + Jeśli generator nie znajduje się na wyrażeniu &yield;, gdy ta metoda jest wywoływana, + zostanie najpierw pozwolony na przejście do pierwszego wyrażenia &yield; przed wysłaniem + wartości. W związku z tym nie jest konieczne „ inicjowanie” generatorów PHP za pomocą + wywołania Generator::next (tak jak robi się to w Pythonie). + + + + + &reftitle.parameters; + + + value + + + Wartość do wysłania do generatora. Wartość ta będzie wartością zwracaną wyrażenia + &yield; na którym aktualnie znajduje się generator. + + + + + + + + &reftitle.returnvalues; + + Zwraca uzyskaną wartość. + + + + + &reftitle.examples; + + + Użycie <methodname>Generator::send</methodname> do wstrzykiwania wartości + +send('Hello world!'); +$printer->send('Bye world!'); +?> +]]> + + &example.outputs; + + + + + + + + diff --git a/language/predefined/generator/throw.xml b/language/predefined/generator/throw.xml new file mode 100644 index 00000000..4152a350 --- /dev/null +++ b/language/predefined/generator/throw.xml @@ -0,0 +1,103 @@ + + + + + + Generator::throw + Zgłasza wyjątek do generatora + + + + &reftitle.description; + + public mixedGenerator::throw + Throwableexception + + + Zgłasza wyjątek w generatorze i wznawia jego wykonywanie. + Zachowanie będzie takie samo, jak gdyby bieżące wyrażenie &yield; zostało zastąpione instrukcją + throw $exception. + + + Jeśli generator jest już zamknięty w momencie wywołania tej metody, wyjątek będzie + zgłaszany w kontekście wywołującego. + + + + + &reftitle.parameters; + + + exception + + + Wyjątek zgłaszany do generatora. + + + + + + + + &reftitle.returnvalues; + + Zwraca uzyskaną wartość. + + + + + &reftitle.examples; + + + Zgłaszanie wyjątku do generatora + +getMessage()}\n"; + } + echo "Bar\n"; +} + +$gen = gen(); +$gen->rewind(); +$gen->throw(new Exception('Test')); +?> +]]> + + &example.outputs; + + + + + + + + diff --git a/language/predefined/generator/valid.xml b/language/predefined/generator/valid.xml new file mode 100644 index 00000000..a26ed88f --- /dev/null +++ b/language/predefined/generator/valid.xml @@ -0,0 +1,51 @@ + + + + + + Generator::valid + Sprawdza, czy iterator został zamknięty + + + + &reftitle.description; + + public boolGenerator::valid + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca &false;, jeśli iterator został zamknięty. W przeciwnym razie zwraca &true;. + + + + + + diff --git a/language/predefined/generator/wakeup.xml b/language/predefined/generator/wakeup.xml new file mode 100644 index 00000000..f7b1fb3b --- /dev/null +++ b/language/predefined/generator/wakeup.xml @@ -0,0 +1,56 @@ + + + + + + + Generator::__wakeup + Serializuje callback + + + + &reftitle.description; + + public voidGenerator::__wakeup + + + + Zgłasza wyjątek, ponieważ generatory nie mogą być serializowane. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + + + + diff --git a/language/predefined/internaliterator/construct.xml b/language/predefined/internaliterator/construct.xml new file mode 100644 index 00000000..0022fed5 --- /dev/null +++ b/language/predefined/internaliterator/construct.xml @@ -0,0 +1,41 @@ + + + + + InternalIterator::__construct + Prywatny konstruktor uniemożliwiający bezpośrednie tworzenie instancji + + + + &reftitle.description; + + private InternalIterator::__construct + + + + + + &reftitle.parameters; + &no.function.parameters; + + + diff --git a/language/predefined/internaliterator/current.xml b/language/predefined/internaliterator/current.xml new file mode 100644 index 00000000..6454795f --- /dev/null +++ b/language/predefined/internaliterator/current.xml @@ -0,0 +1,51 @@ + + + + + InternalIterator::current + Zwraca bieżący element + + + + &reftitle.description; + + public mixedInternalIterator::current + + + + Zwraca bieżący element + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca bieżący element + + + + diff --git a/language/predefined/internaliterator/key.xml b/language/predefined/internaliterator/key.xml new file mode 100644 index 00000000..4d176be1 --- /dev/null +++ b/language/predefined/internaliterator/key.xml @@ -0,0 +1,51 @@ + + + + + InternalIterator::key + Zwraca klucz bieżącego elementu + + + + &reftitle.description; + + public mixedInternalIterator::key + + + + Zwraca klucz bieżącego elementu. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca klucz bieżącego elementu. + + + + diff --git a/language/predefined/internaliterator/next.xml b/language/predefined/internaliterator/next.xml new file mode 100644 index 00000000..c6c4991f --- /dev/null +++ b/language/predefined/internaliterator/next.xml @@ -0,0 +1,51 @@ + + + + + InternalIterator::next + Przechodzi do następnego elementu + + + + &reftitle.description; + + public voidInternalIterator::next + + + + Przenosi bieżącą pozycję na następny element. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + diff --git a/language/predefined/internaliterator/rewind.xml b/language/predefined/internaliterator/rewind.xml new file mode 100644 index 00000000..293621c1 --- /dev/null +++ b/language/predefined/internaliterator/rewind.xml @@ -0,0 +1,51 @@ + + + + + InternalIterator::rewind + Przewija Iterator do pierwszego elementu + + + + &reftitle.description; + + public voidInternalIterator::rewind + + + + Przewija z powrotem do pierwszego elementu Iteratora. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + diff --git a/language/predefined/internaliterator/valid.xml b/language/predefined/internaliterator/valid.xml new file mode 100644 index 00000000..a44b0594 --- /dev/null +++ b/language/predefined/internaliterator/valid.xml @@ -0,0 +1,51 @@ + + + + + InternalIterator::valid + Sprawdź, czy aktualna pozycja jest prawidłowa + + + + &reftitle.description; + + public boolInternalIterator::valid + + + + Sprawdź, czy aktualna pozycja jest prawidłowa. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca, czy bieżąca pozycja jest prawidłowa. + + + + diff --git a/language/predefined/iterator/current.xml b/language/predefined/iterator/current.xml new file mode 100644 index 00000000..9f9c0972 --- /dev/null +++ b/language/predefined/iterator/current.xml @@ -0,0 +1,53 @@ + + + + + + Iterator::current + Zwraca bieżący element + + + + &reftitle.description; + + public mixedIterator::current + + + + Zwraca bieżący element + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Może zwrócić dowolny typ. + + + + + diff --git a/language/predefined/iterator/key.xml b/language/predefined/iterator/key.xml new file mode 100644 index 00000000..e01df82d --- /dev/null +++ b/language/predefined/iterator/key.xml @@ -0,0 +1,60 @@ + + + + + + Iterator::key + Zwraca klucz bieżącego elementu + + + + &reftitle.description; + + public mixedIterator::key + + + + Zwraca klucz bieżącego elementu. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca scalar przy powodzeniu lub &null; przy niepowodzeniu. + + + + + &reftitle.errors; + + Zgłasza E_NOTICE przy niepowodzeniu. + + + + + diff --git a/language/predefined/iterator/next.xml b/language/predefined/iterator/next.xml new file mode 100644 index 00000000..3dc15ff5 --- /dev/null +++ b/language/predefined/iterator/next.xml @@ -0,0 +1,59 @@ + + + + + + Iterator::next + Przechodzi do następnego elementu + + + + &reftitle.description; + + public voidIterator::next + + + + Przenosi bieżącą pozycję do następnego elementu. + + + + Metoda ta jest wywoływana po każdej + pętli &foreach;. + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Każda zwrócona wartość jest ignorowana. + + + + + diff --git a/language/predefined/iterator/rewind.xml b/language/predefined/iterator/rewind.xml new file mode 100644 index 00000000..c1a5b880 --- /dev/null +++ b/language/predefined/iterator/rewind.xml @@ -0,0 +1,60 @@ + + + + + + Iterator::rewind + Przewija Iterator do pierwszego elementu + + + + &reftitle.description; + + public voidIterator::rewind + + + + Przewija z powrotem do pierwszego elementu Iteratora. + + + + Jest to pierwsza metoda wywoływana podczas uruchamiania + pętli &foreach;. Nie będzie ona wykonywana + po pętlach &foreach;. + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Każda zwrócona wartość jest ignorowana. + + + + + diff --git a/language/predefined/iterator/valid.xml b/language/predefined/iterator/valid.xml new file mode 100644 index 00000000..b4b5ca1e --- /dev/null +++ b/language/predefined/iterator/valid.xml @@ -0,0 +1,56 @@ + + + + + + Iterator::valid + Sprawdza, czy bieżąca pozycja jest prawidłowa + + + + &reftitle.description; + + public boolIterator::valid + + + + Ta metoda jest wywoływana po metodach Iterator::rewind i + Iterator::next w celu sprawdzenia, czy bieżąca pozycja jest + prawidłowa. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwracana wartość jest rzutowana na typ bool, a następnie oceniana. + &return.success; + + + + + diff --git a/language/predefined/iteratoraggregate/getiterator.xml b/language/predefined/iteratoraggregate/getiterator.xml new file mode 100644 index 00000000..b5ea6d2e --- /dev/null +++ b/language/predefined/iteratoraggregate/getiterator.xml @@ -0,0 +1,61 @@ + + + + + + IteratorAggregate::getIterator + Pobiera zewnętrzny iterator + + + + &reftitle.description; + + public TraversableIteratorAggregate::getIterator + + + + Zwraca zewnętrzny iterator. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Instancja obiektu implementującego Iterator lub + Traversable + + + + + &reftitle.errors; + + Zgłasza wyjątek Exception przy niepowodzeniu. + + + + + diff --git a/language/predefined/unitenum/cases.xml b/language/predefined/unitenum/cases.xml new file mode 100644 index 00000000..57674abc --- /dev/null +++ b/language/predefined/unitenum/cases.xml @@ -0,0 +1,93 @@ + + + + + UnitEnum::cases + Generuje listę przypadków dla enuma + + + + &reftitle.description; + + public static arrayUnitEnum::cases + + + + Ta metoda zwróci spakowaną tablicę wszystkich przypadków w wyliczeniu, w kolejności deklaracji. + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Tablica wszystkich zdefiniowanych przypadków tego wyliczenia, w kolejności deklaracji. + + + + + &reftitle.examples; + + Podstawowe użycie + + Poniższy przykład ilustruje sposób zwracania przypadków enuma. + + + +]]> + + &example.outputs; + + + enum(Suit::Hearts) + [1]=> + enum(Suit::Diamonds) + [2]=> + enum(Suit::Clubs) + [3]=> + enum(Suit::Spades) +} +]]> + + + + + + diff --git a/language/predefined/weakmap/count.xml b/language/predefined/weakmap/count.xml new file mode 100644 index 00000000..9cf28644 --- /dev/null +++ b/language/predefined/weakmap/count.xml @@ -0,0 +1,52 @@ + + + + + + WeakMap::count + Zlicza liczbę aktywnych wpisów w mapie + + + + &reftitle.description; + + public intWeakMap::count + + + + Zlicza liczbę aktywnych wpisów w mapie. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Zwraca liczbę aktywnych wpisów w mapie. + + + + diff --git a/language/predefined/weakmap/getiterator.xml b/language/predefined/weakmap/getiterator.xml new file mode 100644 index 00000000..77a5cac6 --- /dev/null +++ b/language/predefined/weakmap/getiterator.xml @@ -0,0 +1,61 @@ + + + + + + WeakMap::getIterator + Pobiera zewnętrzny iterator + + + + &reftitle.description; + + public IteratorWeakMap::getIterator + + + + Zwraca zewnętrzny iterator. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Instancja obiektu implementująca Iterator lub + Traversable + + + + + &reftitle.errors; + + Zgłasza wyjątek Exception przy niepowodzeniu. + + + + + diff --git a/language/predefined/weakmap/offsetexists.xml b/language/predefined/weakmap/offsetexists.xml new file mode 100644 index 00000000..2e523645 --- /dev/null +++ b/language/predefined/weakmap/offsetexists.xml @@ -0,0 +1,62 @@ + + + + + + WeakMap::offsetExists + Sprawdza, czy dany obiekt znajduje się w mapie + + + + &reftitle.description; + + public boolWeakMap::offsetExists + objectobject + + + Sprawdza, czy przekazany obiekt znajduje odniesienie w mapie. + + + + + + &reftitle.parameters; + + + object + + + Obiekt do sprawdzenia. + + + + + + + + &reftitle.returnvalues; + + Zwraca &true; jeśli obiekt jest zawarty w mapie, w przeciwnym razie &false;. + + + + diff --git a/language/predefined/weakmap/offsetget.xml b/language/predefined/weakmap/offsetget.xml new file mode 100644 index 00000000..78d630e4 --- /dev/null +++ b/language/predefined/weakmap/offsetget.xml @@ -0,0 +1,69 @@ + + + + + + WeakMap::offsetGet + Zwraca wartość wskazywaną przez określony obiekt + + + + &reftitle.description; + + public mixedWeakMap::offsetGet + objectobject + + + Zwraca wartość wskazywaną przez określony obiekt. + + + + + &reftitle.parameters; + + + object + + + Jakiś obiekt zawarty jako klucz w mapie. + + + + + + + + &reftitle.returnvalues; + + Zwraca wartość powiązaną z obiektem przekazanym jako argument. + + + + + &reftitle.errors; + + Zgłasza błąd Error przy niepowodzeniu. + + + + + diff --git a/language/predefined/weakmap/offsetset.xml b/language/predefined/weakmap/offsetset.xml new file mode 100644 index 00000000..d88937c8 --- /dev/null +++ b/language/predefined/weakmap/offsetset.xml @@ -0,0 +1,73 @@ + + + + + + WeakMap::offsetSet + Aktualizuje mapę o nową parę klucz-wartość + + + + &reftitle.description; + + public voidWeakMap::offsetSet + objectobject + mixedvalue + + + Aktualizuje mapę o nową parę klucz-wartość. Jeśli klucz już istniał w mapie, + stara wartość jest zastępowana nową. + + + + + &reftitle.parameters; + + + object + + + Obiekt służący jako klucz pary klucz-wartość. + + + + + value + + + Dowolne dane służące jako wartość pary klucz-wartość. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + + diff --git a/language/predefined/weakmap/offsetunset.xml b/language/predefined/weakmap/offsetunset.xml new file mode 100644 index 00000000..f46803fd --- /dev/null +++ b/language/predefined/weakmap/offsetunset.xml @@ -0,0 +1,63 @@ + + + + + + WeakMap::offsetUnset + Usuwa wpis z mapy + + + + &reftitle.description; + + public voidWeakMap::offsetUnset + objectobject + + + Usuwa wpis z mapy. + + + + + &reftitle.parameters; + + + object + + + Obiekt klucza do usunięcia z mapy. + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + +