| 1 | package ExtUtils::Constant::Utils;
|
|---|
| 2 |
|
|---|
| 3 | use strict;
|
|---|
| 4 | use vars qw($VERSION @EXPORT_OK @ISA $is_perl56);
|
|---|
| 5 | use Carp;
|
|---|
| 6 |
|
|---|
| 7 | @ISA = 'Exporter';
|
|---|
| 8 | @EXPORT_OK = qw(C_stringify perl_stringify);
|
|---|
| 9 | $VERSION = '0.01';
|
|---|
| 10 |
|
|---|
| 11 | $is_perl56 = ($] < 5.007 && $] > 5.005_50);
|
|---|
| 12 |
|
|---|
| 13 | =head1 NAME
|
|---|
| 14 |
|
|---|
| 15 | ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
|
|---|
| 16 |
|
|---|
| 17 | =head1 SYNOPSIS
|
|---|
| 18 |
|
|---|
| 19 | use ExtUtils::Constant::Utils qw (C_stringify);
|
|---|
| 20 | $C_code = C_stringify $stuff;
|
|---|
| 21 |
|
|---|
| 22 | =head1 DESCRIPTION
|
|---|
| 23 |
|
|---|
| 24 | ExtUtils::Constant::Utils packages up utility subroutines used by
|
|---|
| 25 | ExtUtils::Constant, ExtUtils::Constant::Base and derived classes. All its
|
|---|
| 26 | functions are explicitly exportable.
|
|---|
| 27 |
|
|---|
| 28 | =head1 USAGE
|
|---|
| 29 |
|
|---|
| 30 | =over 4
|
|---|
| 31 |
|
|---|
| 32 | =item C_stringify NAME
|
|---|
| 33 |
|
|---|
| 34 | A function which returns a 7 bit ASCII correctly \ escaped version of the
|
|---|
| 35 | string passed suitable for C's "" or ''. It will die if passed Unicode
|
|---|
| 36 | characters.
|
|---|
| 37 |
|
|---|
| 38 | =cut
|
|---|
| 39 |
|
|---|
| 40 | # Hopefully make a happy C identifier.
|
|---|
| 41 | sub C_stringify {
|
|---|
| 42 | local $_ = shift;
|
|---|
| 43 | return unless defined $_;
|
|---|
| 44 | # grr 5.6.1
|
|---|
| 45 | confess "Wide character in '$_' intended as a C identifier"
|
|---|
| 46 | if tr/\0-\377// != length;
|
|---|
| 47 | # grr 5.6.1 moreso because its regexps will break on data that happens to
|
|---|
| 48 | # be utf8, which includes my 8 bit test cases.
|
|---|
| 49 | $_ = pack 'C*', unpack 'U*', $_ . pack 'U*' if $is_perl56;
|
|---|
| 50 | s/\\/\\\\/g;
|
|---|
| 51 | s/([\"\'])/\\$1/g; # Grr. fix perl mode.
|
|---|
| 52 | s/\n/\\n/g; # Ensure newlines don't end up in octal
|
|---|
| 53 | s/\r/\\r/g;
|
|---|
| 54 | s/\t/\\t/g;
|
|---|
|
|---|
