Re: Will the real Internals module please stand up?

Replies are listed 'Best First'.

Re^2: Will the real Internals module please stand up?
by ikegami (Patriarch) on Mar 01, 2009 at 20:30 UTC

Some are documented

UNIVERSAL::isa	implied
UNIVERSAL::can	implied
UNIVERSAL::DOES	implied
UNIVERSAL::VERSION	implied

version::new	undocumented availability
version::qv	undocumented availability
version::boolean	completely undocumented
version::vcmp	completely undocumented
version::noop	completely undocumented
version's UNIVERSAL::VERSION override	undocumented availability

utf8::is_utf8	documented
utf8::valid	documented
utf8::encode	documented
utf8::decode	documented
utf8::upgrade	documented
utf8::downgrade	documented
utf8::native_to_unicode	completely undocumented
utf8::unicode_to_native	completely undocumented

Internals::SvREADONLY	completely undocumented
Internals::SvREFCNT	completely undocumented
Internals::hv_clear_placeholders	completely undocumented
Internals::hash_seed	completely undocumented
Internals::rehash_seed	completely undocumented
Internals::HvREHASH	completely undocumented

PerlIO::get_layers	undocumented availability

re::is_regexp	undocumented availability
re::regname	undocumented availability
re::regnames	undocumented availability
re::regnames_count	undocumented availability

Tie::Hash::NamedCapture::	undocumented availability

The table applies to 5.10.0. I omitted methods except those in UNIVERSAL (since those have a global effect).

Legend:

documented	These functions are documented as always available.
implied	The documentation for these functions implies they are always available.
undocumented availability	These functions are documented, but their availability isn't.
completely undocumented	The documentation of the modules for these functions don't mention them.

Interestingly, version claims to override UNIVERSAL::VERSION, but there is only one function. The "override" is always in effect.

Interestingly, the following bindings are absent:

re::regmust
re::regexp_pattern

[reply]
[d/l]
[select]

Re^3: Will the real Internals module please stand up?

by demerphq (Chancellor) on Nov 16, 2012 at 11:10 UTC

What do you mean about "bindings are absent"?

Most of this stuff, in particular availability, is not documented directly for a reason. So for instance Tie::Hash::NamedCapture is used to implement named captures. It is loaded automagically by the internals when you do a $+{foo} style lookup. It uses a bunch of the re:: functions, which are exposed via universal because they are then compiled into the core executable and thus do not require an additional library to be loaded. Now I could have implemented the entire thing without using any perl level modules or exposing any subs, but that would have limited the options available to the programmer which I felt was not the Perl way.

---
$world=~s/war/peace/g

[reply]

Re^4: Will the real Internals module please stand up?

by ikegami (Patriarch) on Mar 02, 2013 at 22:31 UTC

I just saw this now for the first time.

What do you mean about "bindings are absent"?

Don't know.

re::regexp_pattern is defined in 5.10.0's universal.c and it's bound to the Perl namespace.

re::regmust isn't defined in 5.10.0's universal.c, so why was it mentioned?

Maybe I was looking at the wrong file version?

[reply]
[d/l]
[select]


"be consistent"
	PerlMonks