David Landgren > String-FixedLen-0.02 > String::FixedLen

Download:
String-FixedLen-0.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   Source  

NAME ^

String::FixedLen - Create strings that will never exceed a specific length

VERSION ^

This document describes version 0.02 of String::FixedLen, released 2007-08-03.

SYNOPSIS ^

  use String::FixedLen;

  tie my $str, 'String::FixedLen', 4;

  $str = 'a';
  $str .= 'cheater;        # "ache"
  $str = "hello, world\n"; # "hell"
  $str = 9999 + 12;        # "1001"

  # and so on

DESCRIPTION ^

String::FixedLen is used to create strings that can never exceed a fixed length. Whenever an assignment would cause the string to exceed the limit, it is clamped to the maximum length and the remaining characters are discarded.

DIAGNOSTICS ^

None.

NOTES ^

The source scalar that is being assigned to a String::FixedLen scalar may be huge:

   my $big = 'b' x 1_000_000;
   $fixed = $big;

but at no point will the FixedLen string ever exceed its upper limit.

BUGS ^

Please report all bugs at http://rt.cpan.org/NoAuth/Bugs.html?Dist=String-FixedLen|rt.cpan.org

Make sure you include the output from the following two commands:

  perl -MString::FixedLen -le 'print $String::FixedLen::VERSION'
  perl -V

ACKNOWLEDGEMENTS ^

The idea for this module came up during a discussion on the French perl mailing list (perl@mongueurs.net).

AUTHOR ^

David Landgren, copyright (C) 2007. All rights reserved.

http://www.landgren.net/perl/

If you (find a) use this module, I'd love to hear about it. If you want to be informed of updates, send me a note. You know my first name, you know my domain. Can you guess my e-mail address?

LICENSE ^

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

syntax highlighting: