Ahmed Amin Elsheshtawy احمد امين الششتاوى > Religion-Islam-Quran-2.01 > Religion::Islam::Quran

Download:
mewsoft/Religion-Islam-Quran-2.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 2.01   Source  

NAME ^

Religion::Islam::Quran - Holy Quran book searchable database multi-lingual in utf-8 unicode format

SYNOPSIS ^

        #---------------------------------------------------------------
        use Religion::Islam::Quran;
        #---------------------------------------------------------------
        #create new object with default options, Arabic language
        my $quran = Religion::Islam::Quran->new();

        # or select the English Language:
        my $quran = Religion::Islam::Quran->new(Language=>'English');
        
        # you can also specifiy your own database files path:
        my $quran = Religion::Islam::Quran->new(DatabasePath => './Quran/mydatabase');
        #---------------------------------------------------------------
        #Returns the available Quran databases
        @Languages = $quran->GetLanguages();
        #---------------------------------------------------------------
        # returns all the quran surahs count.
        $surahs = $quran->SurahCount; # returns 114
        #---------------------------------------------------------------
        # returns all the quran ayats count.
        $ayats = $quran->AyahCount; # returns 6236
        #---------------------------------------------------------------
        #returns all surah ayats Quran in an array.
        @surah = $quran->Surah(1); 
        #---------------------------------------------------------------
        #returns the number of surah ayats.
        $surah_number = 1; # 1 to 114
        $surah_ayats = $quran->SurahAyahCount($surah_number);
        #---------------------------------------------------------------
        # returns the surah name using the surah number from 1 to 114.
        $surah_name = $quran->SurahName($surah_number, $optional_language);
        #---------------------------------------------------------------
        # returns Quran text of specific surah ayah.
        $ayah = $quran->Ayah($surah_number, $ayah_number);
        #---------------------------------------------------------------
        # returns Quran text of specific surah ayah range in an array .
        @ayats = $quran->Ayats($surah_number, $from_ayah, $to_ayah);
        #---------------------------------------------------------------
        # returns all the Quran text of specific surah in an array.
        @ayats = $quran->Surah($surah_number);
        #---------------------------------------------------------------
        # returns the names of each surah in the Quran sort order.
        @surahs_name = $quran->SurahsNames();
        #---------------------------------------------------------------
        # returns the ayats number for each surah in the Quran sort order.
        @surahs_ayats = $quran->SurahsAyats();
        #---------------------------------------------------------------
        # search specific Surah for specific text and returns the ayahs numbers
        @ayats = $quran->SearchSurah($surah, $findwhat);
        #---------------------------------------------------------------
        #Remove Diacritic from Arabic Text
        $TextWithoutDiacritic = $quran->RemoveDiacritic($TextWithDiacritic);
        #---------------------------------------------------------------
        #The Wajib Sajdah of the Qur'an
        #In four Surahs of the Qur'an there are ayats of sajdah that if a person reads one 
        #of these ayats, or if he hears someone else recite one of these ayats, once the 
        #ayat is finished, one must immediately go into sajdah.
        #Returns the Surah=>Ayah pairs
        %SajdahCompulsaryAyats = $quran->SajdahCompulsaryAyats();
        print $quran->IsSajdahCompulsaryAyah($surah, $ayah);
        
        #The recommended (mustahab) Sajdah of the Qur'an
        #Returns the Surah=>Ayah pairs
        %SajdahRecommendedAyats = $quran->SajdahRecommendedAyats();
        print  $quran->IsSajdahRecommendedAyah($surah, $ayah);
        
        #Surah Number Order of Revelation
        #Returns surah number=>order of revelation pairs
        %OrderOfRevelation = $quran->OrderOfRevelation();
        print "Surah Order Of Revelation: " . $quran->SurahOrderOfRevelation($surah);
        
        #Where each surah revealed, Mekkah or Medianh
        #Return 1 for Medinah and 0 for Mekkah
        print $quran->SurahRevelation($surah);

DESCRIPTION ^

This module contains the full Holy Quran Book database searchable and provides many methods for retriving whole quran, specific surahs, or specific ayats and information about Quran and each surah in different languages and transliterations. Quran database files are simply text files pipe separated each line is formated as:

<SurahNumber>|<AyahNumber>|<AyahText><CRLF>

Example of Arabic database file first Surah QuranArabic.txt:

        1|1|بِسْمِ اللّهِ الرَّحْمَنِ الرَّحِيمِ
        1|2|الْحَمْدُ للّهِ رَبِّ الْعَالَمِينَ
        1|3|الرَّحْمنِ الرَّحِيمِ
        1|4|مَلِكِ يَوْمِ الدِّينِ
        1|5|إِيَّاكَ نَعْبُدُ وإِيَّاكَ نَسْتَعِينُ
        1|6|اهدِنَا الصِّرَاطَ المُستَقِيمَ
        1|7|صِرَاطَ الَّذِينَ أَنعَمتَ عَلَيهِمْ غَيرِ المَغضُوبِ عَلَيهِمْ وَلاَ الضَّالِّينَ

and the 112th Surah in QuranEnglish.txt:

        112|1|Say: He is Allah, the One and Only; 
        112|2|Allah, the Eternal, Absolute; 
        112|3|He begetteth not, nor is He begotten; 
        112|4|And there is none like unto Him. 

Database text files located in the module directory /Religion/Islam/Quran. Default module comes with the Quran Arabic and some other translations. You can download more quran translations and transliterations from www.islamware.com.

Languages and databases included with the module are:

        Albanian
        Arabic
        Azerbaijani
        Chinese
        Dutch
        English
        EnglishUS
        Finnish
        French
        German
        Harun
        Indonesian
        Italian
        Japanese
        Latin
        Malaysian
        Mexican
        Persian
        Poland
        Portuguese
        Russian
        Spanish
        Swahili
        Tamil
        Thai
        Turkish

        EnglishTransliteration

Surah names are only available in English and Arabic languages.

Methods

SEE ALSO ^

Date::HijriDate Religion::Islam::Qibla Religion::Islam::PrayTime Religion::Islam::PrayerTimes

AUTHOR ^

Ahmed Amin Elsheshtawy, <support@islamware.com> <support@mewsoft.com> Website: http://www.islamware.com http://www.mewsoft.com

COPYRIGHT AND LICENSE ^

Copyright (C) 2006-2013 by Ahmed Amin Elsheshtawy support@islamware.com, support@mewsoft.com http://www.islamware.com http://www.mewsoft.com

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

syntax highlighting: