The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

URI::ImpliedBase (3)
  • >> URI::ImpliedBase (3) ( Разные man: Библиотечные вызовы )
  •  

    NAME

    URI::ImpliedBase - magically force all URIs to be absolute
     
    

    SYNOPSIS

      use URI::ImpliedBase;
    
    

      # Set the base to search.cpan.org
      $u = URI::ImpliedBase->new("http://search.cpan.org");
    
    

      $v = URI::ImpliedBase->new('subdir')
      print $v->as_string;  # prints http://search.cpan.org/subdir
    
    

      # No default now
      URI::ImpliedBase->clear();
    
    

      # Force current working directory to be the URI
      $w = URI::ImpliedBase->new("../wsdl/test.wsdl");
      print $w->as_string;  # prints (e.g.) file:///Users/joe/wsdl/test.wsdl
    
    
     

    DESCRIPTION

    This module is a drop-in replacement for URI. It wraps the new() method with some extra code which automatically captures either the base of the supplied URI (if it is absolute), or supplies the current base to "URI-"new_abs()> (if it is relative). If the current base is unset when a relative URI is supplied, the current working directory is used to build a ``file:'' URI and this is saved as the current base.

    You can force a new base at any time by calling "URI::ImpliedBase-"clear()>.  

    USAGE

    See the section for typical usage.  

    BUGS

    Whether or not the current directory stuff works for a non-UNIX OS is currently unknown.

    The base is stored internally at the moment; this may be problematic for multi-threaded code.  

    SUPPORT

    Contact the author for support on an informal basis. No guarantee of response in a timely fashion.  

    AUTHOR

            Joe McMahon
            mcmahon@ibiblio.org
            http://ibiblio.org/mcmahon
    
    
     

    COPYRIGHT

    This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

    The full text of the license can be found in the LICENSE file included with this module.  

    SEE ALSO

    perl(1), "perldoc" URI.  

    CLASS METHODS

     

    new

    The new method uses "URI-"new()> to convert the incoming string into a URI object. It extracts the scheme and path if it can, and saves them as the new default base.

    If there is no scheme, but there is a path, and there's no existing default base,"URI::ImpliedBase" guesses that the path is a reference to the local filesystem relative to the current working directory. It saves the current working directory as the base and "file:" as the scheme, then uses these to build an absolute "file:" URI and returns it.

    If there's no scheme, and there is a path, and there is a default base, "URI::ImpliedBase" uses the default base to convert the path to an absolute URI.

    The base is stored in a package lexical, $current_base. This may be a problem for multithreaded code, or code under "mod_perl" or "mod_soap"; this code has not been tested in these environments.


     

    Index

    NAME
    SYNOPSIS
    DESCRIPTION
    USAGE
    BUGS
    SUPPORT
    AUTHOR
    COPYRIGHT
    SEE ALSO
    CLASS METHODS
    new


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру