Editing Module:Buffer/doc (section)

=====Buffer-nil object=====
{{luaself|\-nil()}}<br />
{{luaself|\-nil:anyName|args=():_B( var )}}

The Buffer-nil object is unique. Calling this as a function returns nothing (in contrast, calling an empty Buffer object returns an empty string). This does however have the Module:Buffer __concat metamethod, which treats this the same way as any [[#invalid|invalid]] object (i.e. ignores it).

Appending this via {{luaref|mw.html:node}} or {{luaself|:_}} has the same effect as appending nil. Passing this to {{luaref|tostring||y}} returns nil instead of the string 'nil'.

The only real Buffer method in its meta __index is {{luaself|:_B}}, however, any non-numerical key string retrieves a function that only returns the Buffer nil object for call chaining. In a sense, you can think of {{code|lang=lua|Buffer:_B(var):...}} as an {{code|lang=lua|1=if var~=nil then var:...}} block around the following chain that ends in the next :_B().

If {{luaref|mw.clone|cloned|y}}, the clone will be a normal Buffer object.

{{anchor|_G object}}<!--anchor below excludes the _ -->