#20930 [Csd->Opn]: [DE] Description of string functions

ID: 20930 User updated by: rc at opelgt dot org Reported By: rc at opelgt dot org -Status: Closed +Status: Open Bug Type: Translation problem Operating System: * PHP Version: Irrelevant Assigned To: wiesemann New Comment: I am not asking for all options. I am asking for a consistent short description text that is no longer than the text now but more precise. Maybe you are not familiar with german. These functions are used often. So it would be nice when the short text gives the return value of the function. Let me explain it: strstr — Find first occurrence of a string First occurrence means the position. But in fact it delivers the part of the string haystack from the occurrence up to the end. Previous Comments: ------------------------------------------------------------------------ [2009-04-23 20:14:36] sammywg@php.net The German translation is only a translation, not a new written manual version. So yes, some function's return is simple to explain but also there are lots of functions with more complicated return values. We try to keep the manual as consistently as possible. Because of that all functions have the standard result type in its signature on the head of their pages and also they have a documentation section with explained return types. So the question why not to write the complete result options in the function summary is easily answered: It is not possible to do that in all cases but in most cases the return value is implicitely described in the short description. (e.g. strpos - Find position of first occurrence of a string, that means an integer value of the first occurrence of the search string is returned by default.) ------------------------------------------------------------------------ [2009-04-23 19:49:31] rc at opelgt dot org You are right: when the english descriptions would be changed it would be better. I think its good, when the description tells what the function returns. Then its not necessary to click one page deeper to the long description. Warum auf eine gute kurze Beschreibung verzichten? ;-) Rüdiger ------------------------------------------------------------------------ [2009-04-23 19:25:22] wiesemann@php.net All German descriptions were already in sync with the English descriptions. IMHO adding additional descriptions make only sense if also the English descriptions would be changed. I've reworded the description of stristr() with a more common term. ------------------------------------------------------------------------ [2007-02-04 10:55:27] rc at opelgt dot org The german descriptions of this similar functions again could be more precise. Here is my suggestion: strchr - alias von strstr stripos - Sucht erstes Vorkommen eines Strings, liefert Position, unabhängig von Groß- und Kleinschreibung stristr - wie strstr, aber unabhängig von Groß- und Kleinschreibung strpbrk - Sucht erstes Vorkommen eines Zeichens von mehreren, liefert Reststring strpos - Sucht erstes Vorkommen eines Strings, liefert Position strrchr - Sucht letztes Vorkommen eines Zeichens, liefert Reststring strripos - Sucht letztes Vorkommen eines Strings, liefert Position, unabhängig von Groß- und Kleinschreibung strrpos - Sucht letztes Vorkommen eines Strings, liefert Position strstr - Sucht erstes Vorkommen eines Strings, liefert Reststring With kind regards, Rüdiger ------------------------------------------------------------------------ [2003-01-04 07:33:03] wiesemann@php.net This bug has been fixed in CVS. In case this was a PHP problem, snapshots of the sources are packaged every three hours; this change will be in the next snapshot. You can grab the snapshot at http://snaps.php.net/. In case this was a documentation problem, the fix will show up soon at http://www.php.net/manual/. In case this was a PHP.net website problem, the change will show up on the PHP.net site and on the mirror sites in short time. Thank you for the report, and for helping us make PHP better. ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/20930 -- Edit this bug report at http://bugs.php.net/?id=20930&edit=1