Noid 0.424

Noid is a Perl module that contains routines to mint and manage nice opaque identifiers. SYNOPSIS use Noid; # import routines into a Perl script $dbreport = Noid::dbcreate( # create minter database & printable $dbdir, $contact, # report on its properties; $contact $template, $term, # is string identifying the operator $naan, $naa, # (authentication information); the $subnaa ); # report is printable $noid = Noid::dbopen( $dbname, $flags ); # open a minter, optionally $flags = 0 | DB_RDONLY; # in read only mode Noid::mint( $noid, $contact, $pepper ); # generate an identifier Noid::dbclose( $noid ); # close minter when done Noid::checkchar( $id ); # if id ends in +, replace with new check # char and return full id, else return id # if current check char valid, else return # undef Noid::validate( $noid, # check that ids conform to template ("-" $template, # means use minters template); returns @ids ); # array of corresponding strings, errors # beginning with "iderr:" $n = Noid::bind( $noid, $contact, # bind data to identifier; set $validate, $how, # $validate to 0 if id. doesnt $id, $elem, $value ); # need to conform to a template Noid::note( $noid, $contact, $key, $value ); # add an internal note Noid::fetch( $noid, $verbose, # fetch bound data; set $verbose $id, @elems ); # to 1 to return labels print Noid::dbinfo( $noid, # get minter information; level $level ); # brief (default), full, or dump Noid::getnoid( $noid, $varname ); # get arbitrary named internal # variable Noid::hold( $noid, $contact, # place or release hold; return $on_off, @ids ); # 1 on success, 0 on error Noid::hold_set( $noid, $id ); Noid::hold_release( $noid, $id ); Noid::parse_template( $template, # read template for errors, returning $prefix, $mask, # namespace size (NOLIMIT=unbounded) $gen_type, # or 0 on error; $message, $gen_type, $message ); # $prefix, & $mask are output params Noid::queue( $noid, $contact, # return strings for queue attempts $when, @ids ); # (failures start "error:") Noid::n2xdig( $num, $mask ); # show identifier matching ord. $num Noid::sample( $noid, $num ); # show random ident. less than $num Noid::scope( $noid ); # show range of ids inside the minter print Noid::errmsg( $noid, $reset ); # print message from failed call $reset = undef | 1; # use 1 to clear error message buffer Noid::addmsg( $noid, $message ); # add message to error message buffer Noid::logmsg( $noid, $message ); # write message to minter log.

Requirements:	No special requirements
Platforms:	Linux
Keyword:	Contact,  Id,  Libraries,  Message,  Minter,  Noid,  Perl Module,  Programming,  Template
Users rating:	0/10