On Sat, 2012-03-24 at 11:57 +0100, François Gannaz wrote:
> > No, it's currently not meant for public use - it's an internal
> function
> > that is not available to outside modules (thus declared 'static').
> > It may make sense to refactor this code and make it more accessible
> to
> > functions that want to parse individual parameter, but currently it
> is
> > not suited for that.
>
> Thanks. As I'm new to php-src, it takes some time to understand this
> kind of (undocumented?) conventions. I know it's a tedious task, but
> I'd really enjoy a few comments for the Zend API functions.
Well, in this case the convention is quite simple:
* If it's static (like the mentioned case) you can't use it in
from a different file (or rather: compile unit) ... that's in
the C standard (-> internal linking)
* If it is ZEND_API/PHPAPI/... it can be used everywhere (while
TSRM should not use anything external, zend should use nothing
besides TSRM, for inter-extension dependencies one should be
careful)
* No-modifier-stuff can be used in the same library (same
extension), depending on compiler flags, compiler version, ...
this might (not) be enforced (by default we enforce it on
Windows and with "modern" gcc (4.1, I think), while you probably
won't see an effect with large static builds, which produce a
single, big, php binary only)
johannes
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
