NAME

UTF8BOM - handling Byte Order Mark for UTF-8 files

SYNOPSIS

    use UTF8BOM;

    UTF8BOM->insert_into_files(
        recursive => 1,
        dir       => '/path/to/dir',
    );

    # or on your shell
    utf8bom -insert -dir  /path/to/dir  -recursive
    utf8bom -strip  -file /path/to/file

    # display usage
    utf8bom -help

DESCRIPTION

This modules allows you to insert UTF8's BOM into strings and files, or remove it from them easily.

METHODS

check_bom

check whether passed string includes BOM or not, and return boolean.

    if( UTF8BOM->check_bom($str) ) {
        # $str includes BOM
    } else {
        # $str doesn't include BOM
    }

insert_into_str

insert BOM into passed string, and return it.

    $str = UTF8BOM->insert_into_str($str)

    # Now, $str includes BOM

insert_into_file

insert BOM into head of file.

    UTF8BOM->insert_into_file('/path/to/file');

    # Now, the file has BOM on it's head.

insert_into_files

insert BOM into head of files.

    UTF8BOM->insert_into_files(
        dir       => '/path/to/dir',
        recursive => 1,
    );

    # Now, all the in the directory has BOM on it's head.

remove_from_str

remove BOM from passed string, and return it.

    $str = UTF8DOM->remove_from_str($str);

remove_from_file

    UTF8BOM->remove_from_file('/path/to/file');

remove_from_files

    UTF8BOM->remove_from_files(
        dir       => '/path/to/dir',
        recursive => 1,
    );

SEE ALSO

utf8bom

AUTHOR

Lyo Kato <lyo.kato@gmail.com>

COPYRIGHT AND LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as perl itself.