Banned_names(3)                                                Banned_names(3)



NNAAMMEE
       Banned_names -

SSYYNNOOPPSSIISS
   PPuubblliicc MMeetthhooddss
       void ccrreeaattee ()
       string * qquueerryy__bbaannnneedd__nnaammeess ()
       void sseett__bbaannnneedd__nnaammeess (string *names)
       int qquueerryy__bbaannnneedd (string name)
       void aadddd__bbaannnneedd__nnaammee (string name)
       void aadddd__bbaannnneedd__eexxpprreessssiioonn (string name)

   PPuubblliicc AAttttrriibbuutteess
       string * bbaannnneedd__nnaammeess

DDEETTAAIILLEEDD DDEESSCCRRIIPPTTIIOONN
       This object is for holding information on banned names for characters
       -- swearwords, themed character names (etc),
       system names (root, flex, world), and anything else that you don't want
       to be allowed.

       The banned names are stored as a string of regular expressions. For
       swearwords and similar, you should call add_banned_expression, and it
       will generate a very general regular expression that will not only ban
       the swearword, but will also understand unusal casing, (sPaM),
       intermediate characters (s_p_a_m), and inserting it into the middle of
       words (_sp_am_me_is_ter). Otherwise call add_banned_name, which only
       bans the literal spelling which you give.

       There should be wizard commands which deal with this object.

       Definition at line 19 of file banned_names.c.

MMEEMMBBEERR FFUUNNCCTTIIOONN DDOOCCUUMMEENNTTAATTIIOONN
   vvooiidd aadddd__bbaannnneedd__eexxpprreessssiioonn ((ssttrriinngg nnaammee))
       This function converts a plain string into a regular expression
       disallowing very many permutations of it. for example, if 'spam' is
       considered a bad four-letter word, then this will also block 's_p_a_m',
       'sP.Ammeister' 'xyzspamxyz' and so forth. It won't block 'spaxm'.

       Definition at line 86 of file banned_names.c.

       References banned_names.

   vvooiidd aadddd__bbaannnneedd__nnaammee ((ssttrriinngg nnaammee))
       Adds a banned name literally. If you only care that a certain, exact
       string is banned (such as the root UID, 'root'), then you should call
       this function. If you are trying to ban swearwords, where even
       permutations of the word would be considered unacceptable, use
       add_banned_expression instead.

       If you wish, you may ban a regular expression with this function as
       well -- simply pass in the regular expression as the name.

       Definition at line 75 of file banned_names.c.

       References banned_names.

   vvooiidd ccrreeaattee (())
       Initializes this object. If a save-file exits (it must be
       /secure/banned_names), then it will load from it, otherwise it will
       reset the list to banning only a few important names that have system
       meaning.

       Definition at line 30 of file banned_names.c.

       References banned_names.

   iinntt qquueerryy__bbaannnneedd ((ssttrriinngg nnaammee))
       RReettuurrnnss::
           True if _n_a_m_e is banned, false if it is an allowed name.

       Definition at line 55 of file banned_names.c.

       References banned_names.

   ssttrriinngg** qquueerryy__bbaannnneedd__nnaammeess (())
       RReettuurrnnss::
           An array of all banned names. Each entry is a string containing a
           regular expression. For the format used, see the 'regexp' command.

       Definition at line 41 of file banned_names.c.

       References banned_names.

   vvooiidd sseett__bbaannnneedd__nnaammeess ((ssttrriinngg ** nnaammeess))
       Allows you to modify the banned names array directly. Be careful with
       this.

       Definition at line 48 of file banned_names.c.

       References banned_names.

MMEEMMBBEERR DDAATTAA DDOOCCUUMMEENNTTAATTIIOONN
   ssttrriinngg** bbaannnneedd__nnaammeess
       An array of regular expressions -- all the banned names.

       Definition at line 23 of file banned_names.c.

       Referenced by add_banned_expression(), add_banned_name(), create(),
       query_banned(), query_banned_names(), and set_banned_names().


AAUUTTHHOORR
       Generated automatically by Doxygen for Walraven from the source code.



Walraven                          8 Jan 2004                   Banned_names(3)
