Image

head

code

root

para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


React

=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

README

use v6.*;

module Scalar::Util:ver<0.0.10>:auth<zef:lizmat> {

    our sub blessed(\a) is export(:SUPPORTED) {
        use nqp;
        nqp::isconcrete(nqp::decont(a)) ?? a.^name !! Nil
    }
    our sub dualvar(\a,\b) is export(:SUPPORTED) {
        given a.Numeric {
            when Int     { IntStr.new($_, b)     }
            when Num     { NumStr.new($_, b)     }
            when Rat     { RatStr.new($_, b)     }
            when Complex { ComplexStr.new($_, b) }
            default { die "Numeric didn't die, yet not Int,Num,Rat or Complex" }
        }
    }
    our sub isdual(\a) is export(:SUPPORTED) {
        so a ~~ any(IntStr,NumStr,RatStr,ComplexStr)
    }
    our sub readonly(\a) is export(:SUPPORTED) {
        use nqp;
        nqp::not_i(nqp::iscont(a)).Bool
    }
    our sub refaddr(\a) is export(:SUPPORTED) {
        use nqp;
        nqp::where(a)
    }
    our sub reftype(\a) is export(:SUPPORTED) {
        a ~~ Positional
          ?? 'ARRAY'
          !! a ~~ Associative
            ?? 'HASH'
            !! Nil
    }
    our sub isvstring(\a) is export(:SUPPORTED) { a ~~ Version }
    our sub looks_like_number(\a) is export(:SUPPORTED) {
        try { a.Numeric } !=== Nil
    }

    our sub openhandle($handle) is export(:SUPPORTED) {
        $handle ~~ IO::Handle && $handle.opened  ?? $handle !! Nil
    }

    # the following functions are not functional on Raku
    my sub die-reference($what) is hidden-from-backtrace {
        die qq:to/TEXT/;
        '$what' is not supported on Raku, because Rakud does not
        do any refcounting or have the concept of a reference.
        TEXT
    }
    our sub weaken(|)   is export(:UNSUPPORTED) { die-reference('weaken')   }
    our sub isweak(|)   is export(:UNSUPPORTED) { die-reference('isweak')   }
    our sub unweaken(|) is export(:UNSUPPORTED) { die-reference('unweaken') }

    our sub set_prototype(|) is export(:UNSUPPORTED) {
        die qq:to/TEXT/;
        'set_prototype' is not supported on Raku, because Raku
        does not have the concept of prototypes.
        TEXT
    }
    our sub tainted(|) is export(:UNSUPPORTED) {
        die qq:to/TEXT/;
        'tainted' is not supported on Raku, because Raku
        does not have the concept of taint built in.
        TEXT
    }
}

sub EXPORT(*@args) {
    return Map.new unless @args;

    # check if we're trying to import stuff we don't support
    if EXPORT::UNSUPPORTED::{ @args.map: '&' ~ * }:v -> @absentees {
        my @messages;
        for @absentees {
            CATCH { when X::AdHoc { @messages.push(.message); .resume } }
            $_()
        }
        die @messages.join
    }

    my $imports := Map.new( |(EXPORT::SUPPORTED::{ @args.map: '&' ~ * }:p) );
    if $imports != @args {
        die "Scalar::Util doesn't know how to export: "
          ~ @args.grep( { !$imports{$_} } ).join(', ')
    }
    $imports
}



Raku port of Perl's Scalar::Util module 1.55


use Scalar::Util <blessed dualvar isdual readonly refaddr reftype
                  isvstring looks_like_number openhandle>


This module tries to mimic the behaviour of Perl's C<Scalar::Util>
module as closely as possible in the Raku Programming Language.


C<Scalar::Util> contains a selection of subroutines that people have expressed
would be nice to have in the perl core, but the usage would not really be high
enough to warrant the use of a keyword, and the size would be so small that 
being individual extensions would be wasteful.


By default C<Scalar::Util> does not export any subroutines.


Returns the name of the class of the object.


Returns the internal memory address of the object as a plain integer.  Please
note that Raku implementations do B<not> require the memory address of an
object to be constant: in fact, with C<MoarVM> as a back end, any longer
living object B<will> have its memory address changed over its lifetime.


For objects performing the C<Positional> role, C<ARRAY> will be returned.  For
objects performing the C<Associative> role, C<HASH> will be returned.  Otherwise
C<Nil> will be returned.


Returns a scalar that has the value C<$num> when used as a number and the value
C<$string> when used as a string.


$foo = dualvar 10, "Hello";
$num = $foo + 2;                    # 12
$str = $foo . " world";             # Hello world


If C<$var> is a scalar that has both numeric and string values, the result is
true.


$foo = dualvar 86, "Nix";
$dual = isdual($foo);               # True


Returns whether C<$var> is a C<Version> object.


$vs    = v49.46.48;
$isver = isvstring($vs);            # True


Returns true if C<$var> can be coerced to a number.


Returns true if C<$var> is readonly (aka does not have a container).


$readonly = foo($bar);              # False
$readonly = foo(0);                 # True


Returns $fh itself if $fh may be used as a filehandle and is open, or is
is a tied handle. Otherwise <Nil> is returned.


$fh = openhandle($*STDIN);
$fh = openhandle($notopen);         # Nil
$fh = openhandle("scalar");         # Nil


It did not make sense to port the following functions to Raku, as they pertain
to specific Pumpkin Perl internals.


weaken isweak unweaken set_prototype tainted


Attempting to import these functions will result in a compilation error with
hopefully targeted feedback.  Attempt to call these functions using the fully
qualified name (e.g. C<Scalar::Util::weaken($a)>) will result in a run time
error with the same feedback.


Source can be located at: https://github.com/lizmat/Scalar-Util . Comments and
Pull Requests are welcome.


Util

unit class SantaClaus::PSTable is export;

use Font::AFM;

constant \DEFAULT-FONT-SIZE = 12;
constant \DEFAULT-HDR-FONT = 'Times-Bold';
constant \DEFAULT-ROW-FONT = 'Times-Roman';

class Fnt {
    has Font::AFM $.font;
    has $.name;
    has $.size;
}



comment

=begin comment
my $font = "Times-Roman";
my $fontsize = 12;
my $afm = Font::AFM.new($font);
my $width = $afm.stringwidth($string, $fontsize);


The purpose of this class is to provide enough
information about its data to create a PostScript version.
Thus it must provide the following to the caller:

+ min width of each column for its content and font
+ min height of each row for its content and font

While each cell can have its own font, it is generally
better to have row 0 be the header and the other rows
contain the data.  The default is to use Times-Roman 
for the data and Times-Bold for the header row.

=end comment



class Cell {...}
class Row {...}

# the table should keep a rectangular shape by
# ensuring all rows have the same number of cells, whether empty or not
has $.ncols;
has $.nrows; 

has $.hfont-size = 12;
has $.rfont-size = 12;
has $.row-hpad;
has $.hdr-hpad;
has $.row-vpad;
has $.hdr-vpad;

has @.rows;

has Fnt $.hdr-font;
has Fnt $.row-font;

submethod TWEAK {
    # mainly set default fonts
    
}

method set-hdr-font(:$name, :$size = 12) {
    $!hdr-font = 
my $afm = Font::AFM.new($font);
}
method set-row-font(:$name, :$size = 12) {
}

method import-csv($fname) {

}

method xy-dimens(--> List) {
    # return the x and y dimensions of the table in PS points
 
}

method write-ps($fp, 
                :$xul, :$yul, # location to print the upper-left corner of the page, in PS points (72 per inch)
                :$debug) {
    $fp.say: qq:to/HERE/;
    gsave $xul $yul translate 0 0 moveto
    HERE
}

class Cell {
    has $.content; # a string or number
    has $.font;
}



PSTable

The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


README

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

SantaClaus::Utils v0.0.4

Authors

License

Dependencies

Test Dependencies

Provides

Documentation