PDL::PPp - ক্লাউডে অনলাইন

কার্যক্রম:

NAME এর

PDL::PP - সংক্ষিপ্ত বিবরণ থেকে PDL রুটিন তৈরি করুন

সাইনোপিসিস

যেমন

pp_def(
'sumover',
পার্স => 'a(n); [ও]বি();',
কোড => q{
ডবল tmp = 0;
লুপ(n) %{
tmp += $a();
%}
$b() = tmp;
},
);

pp_done();

ফাংশন

এখানে PDL::PP দ্বারা প্রদত্ত ফাংশনগুলির একটি দ্রুত রেফারেন্স তালিকা রয়েছে।

pp_add_boot
জেনারেট করা XS ফাইলের বুট বিভাগে কোড যোগ করুন

pp_add_exported
রপ্তানিকৃত ফাংশনের তালিকায় ফাংশন যোগ করুন

pp_add_isa
@ISA তালিকায় এন্ট্রি যোগ করুন

pp_addbegin
জেনারেট .pm ফাইলের উপরে যোগ করার জন্য কোড সেট করে

pp_addhdr
কোড যোগ করুন এবং জেনারেট করা XS ফাইলের C বিভাগে অন্তর্ভুক্ত করুন

pp_addpm
জেনারেট করা .pm ফাইলে কোড যোগ করুন

pp_addxs
জেনারেট করা XS ফাইলে অতিরিক্ত XS কোড যোগ করুন

pp_beginwrap
জেনারেট করা .pm ফাইলের জন্য কোডে BEGIN-ব্লক র‌্যাপিং যোগ করুন

pp_bless
প্যাকেজ সেট করে যেখানে XS কোড যোগ করা হয়েছে (ডিফল্ট হল PDL)

pp_boundscheck
PDL বাউন্ড চেকিং কার্যকলাপের নিয়ন্ত্রণ অবস্থা

pp_core_importList
PDL::Core থেকে কি আমদানি করা হয়েছে তা উল্লেখ করুন

pp_def
একটি নতুন PDL ফাংশন সংজ্ঞায়িত করুন

pp_deprecate_module
একটি মডিউল অবহেলিত হওয়ার বিষয়ে রানটাইম এবং POD সতর্কতা যোগ করুন

pp_done
ফাইলে PDL::PP সংজ্ঞার শেষ চিহ্নিত করুন

pp_export_nothing
আপনার তৈরি মডিউলের জন্য রপ্তানি তালিকা সাফ করুন

pp_লাইন_সংখ্যা
PDL::PP কোডের ডিবাগিং সহজ করতে লাইন নম্বর তথ্য যোগ করুন

pp_setversion
.pm এবং .xs ফাইলগুলির জন্য সংস্করণ সেট করুন৷

এক নজরে

কেন আমরা পিপি প্রয়োজন? বেশ কয়েকটি কারণ: প্রথমত, আমরা সাবরুটিন তৈরি করতে সক্ষম হতে চাই
PDL ডেটাটাইপের প্রতিটির জন্য কোড (PDL_Byte, PDL_Short, ইত্যাদি)। স্বয়ংক্রিয়ভাবে. দ্বিতীয়ত,
যখন পার্লে পিডিএল অ্যারের স্লাইস উল্লেখ করা হয় (যেমন "$a->স্লাইস('0:10:2,:')" বা অন্য
ট্রান্সপোজের মতো জিনিস) এটি স্বচ্ছভাবে করতে সক্ষম হওয়া এবং সক্ষম হওয়া ভাল
এটি করার জন্য 'ইন-প্লেস' - অর্থাৎ, বিভাগের একটি মেমরি কপি তৈরি করতে হবে না। পিপি হ্যান্ডলগুলি
আপনার জন্য সমস্ত প্রয়োজনীয় উপাদান এবং অফসেট পাটিগণিত। এর ধারণাও রয়েছে
থ্রেডিং (একাধিক স্লাইসের জন্য একই রুটিনের বারবার কলিং, দেখুন PDL::Indexing)
এবং ডেটাফ্লো (পিডিএল::ডেটাফ্লো দেখুন) যা পিপি ব্যবহারের অনুমতি দেয়।

এর বেশিরভাগ ক্ষেত্রে আমরা এর ধারণাগুলির সাথে পাঠকের পরিচিতি অনুমান করব
PDL-এর মধ্যে অন্তর্নিহিত এবং স্পষ্ট থ্রেডিং এবং সূচক ম্যানিপুলেশন। আপনি যদি এখনও না
এই ধারণাগুলি শুনেছি বা তাদের সাথে খুব আরামদায়ক নয় এটি পরীক্ষা করার সময়
পিডিএল::ইনডেক্সিং।

আপনি এর নাম থেকে প্রশংসা করতে পারেন PDL::PP হল একটি প্রাক-প্রসেসর, অর্থাৎ এটি এর মাধ্যমে কোড প্রসারিত করে
বাস্তব সি-কোড করতে প্রতিস্থাপন। প্রযুক্তিগতভাবে, আউটপুট হল XS কোড (দেখুন perlxs) কিন্তু
যেটা C এর খুব কাছাকাছি।

তাহলে আপনি কিভাবে পিপি ব্যবহার করবেন? ওয়েল বেশিরভাগ অংশের জন্য আপনি শুধুমাত্র সাধারণ সি কোড ব্যতীত লিখুন
বিশেষ পিপি গঠন যা ফর্ম নেয়:

$something (অন্য কিছু)

বা:

পিপি ফাংশন %{

%}

সবচেয়ে গুরুত্বপূর্ণ পিপি গঠন হল "$array()" ফর্ম। খুব সাধারণ পিপি বিবেচনা করুন
একটি 1D ভেক্টরের উপাদানগুলির যোগফলের জন্য ফাংশন (আসলে এটি বাস্তবের সাথে খুব মিল
'sumover' দ্বারা ব্যবহৃত কোড):

pp_def('সুমিত',
পার্স => 'a(n); [ও]বি();',
কোড => q{
ডবল tmp;
tmp = 0;
লুপ(n) %{
tmp += $a();
%}
$b() = tmp;
}
);

কি হচ্ছে? "Pars =>" লাইনটি PP-এর জন্য অত্যন্ত গুরুত্বপূর্ণ - এটি সমস্ত নির্দিষ্ট করে
যুক্তি এবং তাদের মাত্রা। আমরা এই কল স্বাক্ষর পিপি ফাংশনের (তুলনা করুন
এছাড়াও PDL::ইনডেক্সিং-এ ব্যাখ্যা। এই ক্ষেত্রে রুটিন একটি 1-ডি ফাংশন হিসাবে নেয়
ইনপুট এবং আউটপুট হিসাবে একটি 0-ডি স্কেলার প্রদান করে। "$a()" PP কনস্ট্রাক্ট অ্যাক্সেস করতে ব্যবহৃত হয়
আপনার জন্য অ্যারের উপাদান a(n) - PP সমস্ত প্রয়োজনীয় C কোড পূরণ করে।

আপনি লক্ষ্য করবেন যে আমরা "q{}" একক-উদ্ধৃতি অপারেটর ব্যবহার করছি। এই একটি না
দুর্ঘটনা আপনি সাধারণত আপনার পিপি কোড বিভাগগুলি বোঝাতে একক উদ্ধৃতি ব্যবহার করতে চান। পিডিএল::পিপি
এটির পার্সিংয়ের জন্য "$var()" ব্যবহার করে এবং আপনি যদি একক উদ্ধৃতি ব্যবহার না করেন তবে পার্ল চেষ্টা করবে
ইন্টারপোলেট "$var()"। এছাড়াও, কোঁকড়া ধনুর্বন্ধনী সহ একক উদ্ধৃতি "q" অপারেটর ব্যবহার করে এটি তৈরি করে
দেখে মনে হচ্ছে আপনি একটি কোড ব্লক তৈরি করছেন, যা আপনি বলতে চাচ্ছেন। (পার্ল যথেষ্ট স্মার্ট
নেস্টেড কোঁকড়া ধনুর্বন্ধনী সন্ধান করুন এবং উদ্ধৃতিটি বন্ধ করবেন না যতক্ষণ না এটি মিলে যাওয়া কোঁকড়াটি খুঁজে পায়
বন্ধনী, তাই নেস্টেড ব্লক রাখা নিরাপদ।) অন্যান্য পরিস্থিতিতে, যেমন আপনি যখন
স্ট্রিং সংযোজন ব্যবহার করে একটি কোড ব্লক একসাথে সেলাই করা, এটি ব্যবহার করা প্রায়শই সহজ
বাস্তব একক উদ্ধৃতি হিসাবে

কোড => 'something'.$interpolatable.'somethingelse;'

সাধারণ ক্ষেত্রে এখানে যেখানে সমস্ত উপাদান অ্যাক্সেস করা হয় সেখানে পিপি কনস্ট্রাকট "লুপ(এন)%{ ...
"n" মাত্রার সমস্ত উপাদান লুপ করতে %}" ব্যবহার করা হয়৷ PP-এর এই বৈশিষ্ট্যটি নোট করুন: ALL
মাত্রা নাম দ্বারা নির্দিষ্ট করা হয়.

আমরা পিপি এড়িয়ে চললে এটি পরিষ্কার করা হয় লুপ() লুপটি স্পষ্টভাবে তৈরি করুন এবং লিখুন
প্রচলিত সি ব্যবহার করে:

pp_def('সুমিত',
পার্স => 'a(n); [ও]বি();',
কোড => q{
int i,n_size;
ডবল tmp;
n_size = $SIZE(n);
tmp = 0;
জন্য(i=0; i
tmp += $a(n=>i);
}
$b() = tmp;
},
);

যা আগের মতই কাজ করে, কিন্তু আরো দীর্ঘ-উন্নত। আপনি উপাদান "i" পেতে দেখতে পারেন
a() আমরা বলি "$a(n=>i)" - আমরা "n" নামে মাত্রা নির্দিষ্ট করছি। 2D তে আমরা বলতে পারি:

Pars =>'a(m,n);',
...
tmp += $a(m=>i,n=>j);
...

সিনট্যাক্স "m=>i" পার্ল হ্যাশ থেকে ধার করে, যা বাস্তবে বাস্তবায়নে ব্যবহৃত হয়
পিপি এর। কেউ "$a(n=>j,m=>i)" বলতে পারে কারণ অর্ডার গুরুত্বপূর্ণ নয়।

আপনি উপরের উদাহরণে অন্য পিপি কনস্ট্রাক্ট - $SIZE(n) এর ব্যবহার দেখতে পারেন
মাত্রা "n" এর দৈর্ঘ্য।

তবে, এটি লক্ষ করা উচিত যে আপনি যখন পারেন তখন একটি স্পষ্ট সি-লুপ লেখা উচিত নয়
PDL::PP স্বয়ংক্রিয়ভাবে লুপের সীমা চেক করার পর থেকে PP "লুপ" কনস্ট্রাকট ব্যবহার করেছে
আপনি, "লুপ" এর ব্যবহার কোডটিকে আরও সংক্ষিপ্ত করে তোলে, ইত্যাদি। তবে অবশ্যই পরিস্থিতি রয়েছে
যেখানে আপনার লুপের সুস্পষ্ট নিয়ন্ত্রণ প্রয়োজন এবং এখন আপনি জানেন কিভাবে এটি করতে হয়;)।

'কেন পিপি?' - জন্য উপরের কোড সুমিত() প্রতিটি ডেটা-টাইপের জন্য তৈরি করা হবে। এটা
'ইন-প্লেস' অ্যারের স্লাইসগুলিতে কাজ করবে। এটি স্বয়ংক্রিয়ভাবে থ্রেড হবে - যেমন যদি একটি 2D হয়
অ্যারে দেওয়া হয়েছে এটি প্রতিটি 1D সারির জন্য বারবার কল করা হবে (আবার PDL::এর জন্য ইনডেক্সিং পরীক্ষা করুন
থ্রেডিংয়ের বিবরণ)। এবং তারপর b() হবে প্রতিটি সারির যোগফলের একটি 1D অ্যারে। আমরা পারতাম
পরিবর্তে কলাম যোগ করতে $a->xchg(0,1) দিয়ে কল করুন। এবং ডেটাফ্লো ট্রেসিং ইত্যাদি হবে
পাওয়া যায়.

আপনি দেখতে পাচ্ছেন যে পিপি প্রোগ্রামারকে অনেক অপ্রয়োজনীয় পুনরাবৃত্তিমূলক সি-কোড লেখা থেকে বাঁচায় --
আমাদের মতে এটি PDL তৈরির নতুন সি সাবরুটিন লেখার অন্যতম সেরা বৈশিষ্ট্য
PDL-এর জন্য একটি আশ্চর্যজনকভাবে সংক্ষিপ্ত ব্যায়াম। একটি দ্বিতীয় কারণ হল পিপি প্রসারিত করার ক্ষমতা
আপনার সংক্ষিপ্ত কোড সংজ্ঞা কম্পিউটারের প্রয়োজনের উপর ভিত্তি করে বিভিন্ন সি কোডে
প্রশ্নবিদ্ধ স্থাপত্য. উদাহরণস্বরূপ কল্পনা করুন যে আপনি একটি সুপার কম্পিউটার পেয়ে ভাগ্যবান
তুমার হাত; সেই ক্ষেত্রে আপনি PDL::PP অবশ্যই এমন কোড তৈরি করতে চান যা সুবিধা নেয়
আপনার মেশিনের ভেক্টরাইজিং/সমান্তরাল কম্পিউটিং বৈশিষ্ট্যগুলির (এটি একটি প্রকল্প
ভবিষ্যত)। যাই হোক না কেন, নীচের লাইন হল যে আপনার অপরিবর্তিত কোডটি এখনও প্রসারিত হওয়া উচিত
PDL এর অভ্যন্তরীণ পরিবর্তিত হলেও XS কোড কাজ করে।

এছাড়াও, যেহেতু আপনি একটি প্রকৃত পার্ল স্ক্রিপ্টে কোড তৈরি করছেন, সেখানে অনেক মজা আছে
আপনি করতে পারেন যে জিনিস. ধরা যাক যে আপনাকে sumit (উপরের মত) এবং multit উভয়ই লিখতে হবে।
একটু সৃজনশীলতার সাথে, আমরা করতে পারি

এর জন্য ({নাম => 'সুমিত', ইনিট => '0', অপ => '+='},
{নাম => 'মাল্টিট', ইনিট => '1', অপ => '*='}) {
pp_def($_->{নাম},
পার্স => 'a(n); [ও]বি();',
কোড => '
ডবল tmp;
tmp = '.$_->{Init}.';
লুপ(n) %{
tmp '.$_->{অপ}।' $a();
%}
$b() = tmp;
');
}

যা উভয় ফাংশন সহজেই সংজ্ঞায়িত করে। এখন, যদি আপনি পরে স্বাক্ষর পরিবর্তন করতে হবে বা
মাত্রিকতা বা যাই হোক না কেন, আপনাকে আপনার কোডে শুধুমাত্র একটি জায়গা পরিবর্তন করতে হবে। হ্যা অবশ্যই,
আপনার সম্পাদকের 'কাট এবং পেস্ট' এবং 'অনুসন্ধান এবং প্রতিস্থাপন' আছে তবে এটি এখনও কম
শুধুমাত্র একটি জায়গা ভুলে যাওয়া এবং অদ্ভুত বাগ থাকা বিরক্তিকর এবং অবশ্যই আরও কঠিন
creep in. এছাড়াও, 'orit' (bitwise বা) পরে যোগ করা একটি ওয়ান-লাইনার।

এবং মনে রাখবেন, আপনার কাছে সত্যিই পার্লের সম্পূর্ণ ক্ষমতা রয়েছে - আপনি খুব সহজেই পড়তে পারেন
যেকোনো ইনপুট ফাইল এবং সেই ফাইলের তথ্য থেকে রুটিন তৈরি করুন। যেমন সহজ ক্ষেত্রে
উপরের, লেখক (Tjl) বর্তমানে উপরের মত হ্যাশ সিনট্যাক্সের পক্ষে - এটি খুব বেশি নয়
সংশ্লিষ্ট অ্যারে সিনট্যাক্সের তুলনায় অনেক বেশি অক্ষর কিন্তু বোঝা অনেক সহজ এবং
পরিবর্তন.

আমাদের এখানে ডেটার শুরুতে পয়েন্টার পাওয়ার ক্ষমতাও উল্লেখ করা উচিত
মেমরি - কিছু লাইব্রেরিতে PDL ইন্টারফেস করার পূর্বশর্ত। এই সঙ্গে পরিচালিত হয়
"$P(var)" নির্দেশিকা, নীচে দেখুন।

একটি নতুন pp_def'ined ফাংশনে কাজ শুরু করার সময়, আপনি যদি ভুল করেন তবে আপনি সাধারণত করবেন
উৎপন্ন XS ফাইলে লাইন সংখ্যা নির্দেশ করে কম্পাইলার ত্রুটির একটি গাদা খুঁজুন। আপনি যদি
XS ফাইলগুলি কীভাবে পড়তে হয় তা জানুন (বা আপনি যদি কঠিন উপায়ে শিখতে চান), আপনি খুলতে পারেন
XS ফাইল তৈরি করুন এবং ত্রুটি সহ লাইন নম্বর অনুসন্ধান করুন। তবে সাম্প্রতিক একটি
PDL::PP এর সাথে আপনার ত্রুটির সঠিক লাইন নম্বর রিপোর্ট করতে সাহায্য করে:
"pp_line_numbers"। মূল সামিট উদাহরণের সাথে কাজ করা, যদি আপনার ভুল বানান থাকে
আপনার কোডে tmp, আপনি (erroneos) কোডটিকে এরকম কিছুতে পরিবর্তন করতে পারেন এবং
কম্পাইলার আপনাকে আরও অনেক দরকারী তথ্য দেবে:

pp_def('সুমিত',
পার্স => 'a(n); [ও]বি();',
কোড => pp_line_numbers(__LINE__, q{
ডবল tmp;
tmp = 0;
লুপ(n) %{
tmp += $a();
%}
$b() = rmp;
})
);

উপরের পরিস্থিতির জন্য, আমার কম্পাইলার আমাকে বলে:

...
test.pd:15: ত্রুটি: 'rmp' অঘোষিত (এই ফাংশনে প্রথম ব্যবহার)
...

আমার উদাহরণ স্ক্রিপ্টে (যাকে test.pd বলা হয়), লাইন 15 ঠিক সেই লাইনটি যেখানে আমি আমার তৈরি করেছি
টাইপো: "tmp" এর পরিবর্তে "rmp"।

সুতরাং, প্রোগ্রামিং PDL রুটিন ব্যবহার করে সাধারণ স্বাদ এই দ্রুত ওভারভিউ পরে
PDL::PP এর সংক্ষিপ্ত বিবরণ দেওয়া যাক কোন পরিস্থিতিতে আপনার আসলে এটি ব্যবহার করা উচিত
প্রিপ্রসেসর/প্রি-কম্পাইলার। আপনি যদি চান PDL::PP ব্যবহার করুন

· কিছু বহিরাগত লাইব্রেরিতে ইন্টারফেস PDL

· কিছু অ্যালগরিদম লিখুন যা পার্লে কোড করা হলে ধীর হবে (এটি আপনার মতো প্রায়ই নয়
চিন্তা করা প্রথমে থ্রেডিং এবং ডেটাফ্লো দেখুন)।

· একজন PDL বিকাশকারী হন (এবং তারপরেও এটি বাধ্যতামূলক নয়)

সতর্কতামূলক

এর স্থাপত্যের কারণে, PDL::PP একদিকে নমনীয় এবং সহজে ব্যবহার করা যেতে পারে,
এখনও একই সময়ে exuberantly জটিল. বর্তমানে, সমস্যার অংশ হল সেই ত্রুটি
বার্তাগুলি খুব তথ্যপূর্ণ নয় এবং যদি কিছু ভুল হয়ে যায় তবে আপনি কী জানেন তা আপনি আরও ভালভাবে জানতে চান
করছেন এবং অভ্যন্তরীণ মাধ্যমে আপনার পথ হ্যাক করতে সক্ষম হবেন (বা এর দ্বারা বের করতে সক্ষম হবেন
ট্রায়াল এবং ত্রুটি "pp_def" এ আপনার args এর সাথে কি ভুল)। যদিও কাজ করা হচ্ছে
আরও ভাল সতর্কতা তৈরি করুন, যদি মেইলিং তালিকায় আপনার প্রশ্ন পাঠাতে ভয় পাবেন না
আপনি সমস্যায় পড়েন।

বর্ণনাঃ

নতুন পিডিএল ফাংশনগুলিকে সংজ্ঞায়িত করতে "pp_def" কীভাবে ব্যবহার করবেন তা এখন আপনার কাছে কিছু ধারণা আছে এটি করার সময়
"pp_def" এর সাধারণ সিনট্যাক্স ব্যাখ্যা করুন। "pp_def" আর্গুমেন্ট হিসেবে প্রথমে এর নাম নেয়
ফাংশন আপনি সংজ্ঞায়িত করছেন এবং তারপর একটি হ্যাশ তালিকা যা বিভিন্ন কী ধারণ করতে পারে।

এই কীগুলির উপর ভিত্তি করে PP XS কোড এবং একটি .pm ফাইল তৈরি করে। ফাংশন "pp_done" (দেখুন
SYNOPSIS-এ উদাহরণ) PDL::PP বলতে ব্যবহৃত হয় যে এর মধ্যে আর কোন সংজ্ঞা নেই
এই ফাইলটি এবং এটি .xs এবং উৎপন্ন করার সময়
.pm ফাইল।

ফলস্বরূপ, বেশ কয়েকটি হতে পারে pp_def() একটি ফাইলের ভিতরে কল করে (কনভেনশন ফাইল দ্বারা
পিপি কোডের সাথে এক্সটেনশন .pd বা .pp) থাকে তবে সাধারণত শুধুমাত্র একটি pp_done().

দুটি প্রধান ভিন্ন ধরনের ব্যবহার আছে pp_def(), 'ডেটা অপারেশন' এবং 'স্লাইস
অপারেশন' প্রোটোটাইপ।

'ডেটা অপারেশন' ব্যবহার করা হয় কিছু ডাটা নিতে, ম্যাঙ্গেল করতে এবং অন্য কিছু ডাটা আউটপুট করতে। এই
উদাহরণস্বরূপ '+' অপারেশন, ম্যাট্রিক্স ইনভার্স, সুমোভার ইত্যাদি এবং সমস্ত উদাহরণ অন্তর্ভুক্ত করে
আমরা এ পর্যন্ত এই নথিতে কথা বলেছি। অন্তর্নিহিত এবং স্পষ্ট থ্রেডিং এবং
ফলাফল সৃষ্টি ঐ অপারেশন স্বয়ংক্রিয়ভাবে যত্ন নেওয়া হয়. আপনি এমনকি করতে পারেন
"সুমিট", "সুমোভার" ইত্যাদি দিয়ে ডেটাফ্লো করুন (আপনি যদি বুঝতে না পারেন তবে হতাশ হবেন না
PDL-এ ডেটাফ্লো ধারণা এখনও খুব ভাল; এটি এখনও অনেক পরীক্ষামূলক)।

'স্লাইস অপারেশন' একটি ভিন্ন ধরনের অপারেশন: একটি স্লাইস অপারেশনে, আপনি নন
যেকোনো তথ্য পরিবর্তন করে, আপনি দুটির বিভিন্ন উপাদানের মধ্যে চিঠিপত্র সংজ্ঞায়িত করছেন
পিডলস (উদাহরণগুলি ফাইলে সূচক ম্যানিপুলেশন/স্লাইসিং ফাংশন সংজ্ঞা অন্তর্ভুক্ত করে
slices.pd এটি PDL বিতরণের অংশ; কিন্তু সাবধান, এটি পরিচায়ক স্তর নয়
জিনিসপত্র).

যদি PDL খারাপ মানগুলির জন্য সমর্থন সহ কম্পাইল করা হয় (যেমন "WITH_BADVAL => 1"), তাহলে অতিরিক্ত
"pp_def" এর জন্য কীগুলি প্রয়োজন, যেমনটি নীচে ব্যাখ্যা করা হয়েছে।

আপনি যদি কিছু বহিরাগত লাইব্রেরির সাথে যোগাযোগ করতে আগ্রহী হন (উদাহরণস্বরূপ কিছু
রৈখিক বীজগণিত/ম্যাট্রিক্স লাইব্রেরি), আপনি সাধারণত 'ডেটা অপারেশন' চাইবেন তাই আমরা যাচ্ছি
প্রথমে আলোচনা করতে।

উপাত্ত অপারেশন

A সহজ উদাহরণ
ডেটা ক্রিয়াকলাপে, আপনাকে অবশ্যই জানতে হবে যে আপনার কী পরিমাণ ডেটা দরকার। প্রথমত, একটি উদাহরণ
স্কেলার সহ:

pp_def('যোগ করুন',
পার্স => 'a(); b(); [o]c();',
কোড => '$c() = $a() + $b();'
);

এটা একটু অদ্ভুত দেখায় কিন্তু এর ব্যবচ্ছেদ করা যাক. প্রথম লাইনটি সহজ: আমরা একটি সংজ্ঞায়িত করছি
'যোগ' নামের সাথে রুটিন। দ্বিতীয় লাইনটি কেবল আমাদের পরামিতি ঘোষণা করে এবং
বন্ধনী মানে যে তারা স্কেলার। আমরা স্ট্রিংকে কল করি যা আমাদের পরামিতি এবং সংজ্ঞায়িত করে
তাদের মাত্রিকতা স্বাক্ষর যে ফাংশন. এর প্রাসঙ্গিকতার জন্য
থ্রেডিং এবং ইনডেক্স ম্যানিপুলেশন PDL::ইনডেক্সিং ম্যান পেজ চেক করুন।

তৃতীয় লাইন হল প্রকৃত অপারেশন। আপনাকে ডলারের চিহ্ন এবং বন্ধনী ব্যবহার করতে হবে
আপনার পরামিতি উল্লেখ করতে (এটি সম্ভবত ভবিষ্যতে কোনো সময়ে পরিবর্তিত হবে, একবার a
ভাল সিনট্যাক্স পাওয়া যায়)।

এই লাইনগুলি আসলে PDL-এর জন্য ফাংশনটি সংজ্ঞায়িত করার জন্য প্রয়োজনীয় সবকিছু (ভাল,
আসলে এটা না; আপনাকে অতিরিক্ত একটি Makefile.PL লিখতে হবে (নীচে দেখুন) এবং তৈরি করতে হবে
মডিউল ('perl Makefile.PL; make' এর মতো কিছু); তবে আসুন এই মুহুর্তের জন্য এটি উপেক্ষা করি)।
তাই এখন আপনি করতে পারেন

MyModule ব্যবহার করুন;
$a = pdl 2,3,4;
$b = pdl 5;

$c = add($a,$b);
# অথবা
যোগ করুন($a,$b,($c=null)); # বিকল্প ফর্ম, $c থাকলে দরকারী
# বড় কিছু প্রিসেট, এখানে দরকারী নয়।

এবং সঠিকভাবে থ্রেডিং কাজ করুন (ফলাফল হল $c == [7 8 9])।

সার্জারির অংশ অধ্যায়: দ্য স্বাক্ষর of a PP ক্রিয়া
উপরের উদাহরণ কোডটি দেখে আপনি সম্ভবত জিজ্ঞাসা করবেন: এই অদ্ভুত "$c=null" কি
আমাদের নতুন "অ্যাড" ফাংশনে দ্বিতীয় কলে সিনট্যাক্স? আপনি যদি আরেকবার দেখে নেন
"add" এর সংজ্ঞা আপনি লক্ষ্য করবেন যে তৃতীয় আর্গুমেন্ট "c" এর সাথে পতাকাঙ্কিত
কোয়ালিফায়ার "[o]" যা PDL::PP কে বলে যে এটি একটি আউটপুট আর্গুমেন্ট। তাই উপরের কল
যোগ করার অর্থ 'সঠিক মাত্রা সহ স্ক্র্যাচ থেকে একটি নতুন $c তৈরি করুন' - "নাল" একটি বিশেষ
'খালি পিডল'-এর জন্য টোকেন (আপনি জিজ্ঞাসা করতে পারেন কেন আমরা এটিকে পতাকাঙ্কিত করতে "undef" মান ব্যবহার করিনি
PDL নির্দিষ্ট "নাল" এর পরিবর্তে; আমরা বর্তমানে এটি সম্পর্কে চিন্তা করছি;)

[এটি ম্যানুয়ালটির অন্য কোনও বিভাগেও ব্যাখ্যা করা উচিত!] এর কারণ
একটি বিকল্প হিসাবে এই সিনট্যাক্স হচ্ছে যে আপনি যদি সত্যিই বিশাল piddles আছে, আপনি করতে পারেন

$c = PDL->শূন্য;
জন্য (কিছু দীর্ঘ লুপ) {
# মুঙ্গে ক, খ
যোগ করুন($a,$b,$c);
# মুঙ্গে গ, ক, খ তে কিছু ফিরিয়ে দিন
}

এবং প্রতিবার $c বরাদ্দ এবং ডিলকেটিং এড়িয়ে চলুন। এটি প্রথমে একবার বরাদ্দ করা হয়
যোগ করুন () এবং তারপরে $c ধ্বংস না হওয়া পর্যন্ত মেমরি থাকে।

আপনি যদি শুধু বলেন

$c = add($a,$b);

PP দ্বারা উত্পন্ন কোড স্বয়ংক্রিয়ভাবে "$c=null" পূরণ করবে এবং ফলাফলটি ফেরত দেবে। যদি
আপনি কেন PDL::PP এই স্টাইল সমর্থন করে সেই কারণ সম্পর্কে আরও জানতে চান যেখানে আউটপুট
শেষ আর্গুমেন্ট হিসাবে আর্গুমেন্ট দেওয়া হয় PDL::Indexing man page চেক করুন।

"[o]" একমাত্র কোয়ালিফায়ার নয় যে একটি pdl আর্গুমেন্ট স্বাক্ষরে থাকতে পারে। আরেকটা
গুরুত্বপূর্ণ কোয়ালিফায়ার হল "[t]" বিকল্প যা একটি পিডিএলকে অস্থায়ী হিসাবে ফ্ল্যাগ করে। যে কি করে
মানে? আপনি PDL::PP বলবেন যে এই pdl শুধুমাত্র কোর্সের অস্থায়ী ফলাফলের জন্য ব্যবহার করা হয়
গণনা এবং আপনি গণনা করা হয়েছে পরে তার মান আগ্রহী না
সম্পন্ন কিন্তু কেন PDL::PP প্রথমে এই বিষয়ে জানতে চাইবে? কারন
pdl অটো তৈরির ধারণার সাথে ঘনিষ্ঠভাবে সম্পর্কিত (আপনি উপরে এটি সম্পর্কে শুনেছেন) এবং
অন্তর্নিহিত থ্রেডিং আপনি অন্তর্নিহিত থ্রেডিং ব্যবহার করলে স্বয়ংক্রিয়তার মাত্রা
তৈরি করা পিডিএল আসলে স্বাক্ষরে নির্দিষ্ট করা থেকে বড়। "[o]" পতাকাযুক্ত
pdls তৈরি করা হবে যাতে সংখ্যার প্রয়োজন অনুসারে তাদের অতিরিক্ত মাত্রা থাকে
অন্তর্নিহিত থ্রেড মাত্রা. একটি অস্থায়ী পিডিএল তৈরি করার সময়, তবে, এটি সর্বদা শুধুমাত্র হবে
যথেষ্ট বড় করা হবে যাতে এটি একটি থ্রেড লুপে একটি পুনরাবৃত্তির জন্য ফলাফল ধরে রাখতে পারে, যেমন
স্বাক্ষর দ্বারা প্রয়োজন হিসাবে বড়. তাই কম মেমরি নষ্ট হয় যখন আপনি একটি pdl হিসেবে ফ্ল্যাগ করেন
অস্থায়ী দ্বিতীয়ত, আপনি অস্থায়ী pdls সহ আউটপুট স্বয়ংক্রিয় নির্মাণ ব্যবহার করতে পারেন এমনকি যখন আপনি
স্পষ্ট থ্রেডিং ব্যবহার করছে যা "[o]" দিয়ে পতাকাঙ্কিত সাধারণ আউটপুট pdls-এর জন্য নিষিদ্ধ
(পিডিএল::ইনডেক্সিং দেখুন)।

এখানে একটি উদাহরণ যেখানে আমরা [t] কোয়ালিফায়ার ব্যবহার করি। আমরা যে ফাংশন "calf" সংজ্ঞায়িত
একটি সি রুটিনকে "f" কল করে যার জন্য অ্যারের মতো একই আকার এবং টাইপের একটি অস্থায়ী অ্যারে প্রয়োজন
"a" ($P এর জন্য ফরোয়ার্ড রেফারেন্সের জন্য দুঃখিত; এটি একটি পয়েন্টার অ্যাক্সেস, নীচে দেখুন):

pp_def('calf',
পার্স => 'a(n); [t] tmp(n); [o] b()',
কোড => 'int ns = $SIZE(n);
f($P(a),$P(b),$P(tmp),ns);
'
);

যুক্তি মাত্রা এবং দ্য স্বাক্ষর
এখন আমরা শুধু pdls এর মাত্রা এবং স্বাক্ষর সম্পর্কে কথা বলেছি। তারা কিভাবে সম্পর্কিত?
ধরা যাক আমরা একটি ভেক্টরে একটি স্কেলার + সূচক নম্বর যোগ করতে চাই:

pp_def('add2',
পার্স => 'a(n); b(); [o]c(n);',
কোড => 'লুপ(এন) %{
$c() = $a() + $b() + n;
%}'
);

এখানে লক্ষ্য করার জন্য বেশ কয়েকটি পয়েন্ট রয়েছে: প্রথমত, "পার্স" আর্গুমেন্টে এখন রয়েছে n
আমাদের একটি একক মাত্রা আছে দেখানোর জন্য আর্গুমেন্ট a এবং c. এটা নোট করা গুরুত্বপূর্ণ
যে মাত্রাগুলি প্রকৃত সত্তা যা নাম দ্বারা অ্যাক্সেস করা হয় তাই এটি ঘোষণা করে a এবং c থেকে
আছে একই প্রথম মাত্রা। বেশিরভাগ PP সংজ্ঞায় নামকৃত মাত্রার আকার হবে
নন-আউটপুট পিডিএল (যাদের "[o]" পতাকা নেই) এর নিজ নিজ মাত্রা থেকে সেট করা হবে কিন্তু
কখনও কখনও আপনি একটি নামের মাধ্যমে স্পষ্টভাবে একটি নামযুক্ত মাত্রার আকার সেট করতে চাইতে পারেন
পূর্ণসংখ্যা প্যারামিটার। এটি কীভাবে কাজ করে "অন্যান্যপারস" বিভাগের বিবরণে নীচে দেখুন।

ধ্রুব যুক্তি মাত্রা in দ্য স্বাক্ষর
ধরুন আপনি একটি আউটপুট পিডল স্বয়ংক্রিয়ভাবে তৈরি করতে চান এবং আপনি এটি প্রতিবারই জানেন
কল এর মাত্রা একই আকার থাকবে (বলুন 9) এর মাত্রা নির্বিশেষে
ইনপুট piddles. এই ক্ষেত্রে আপনি নির্দিষ্ট করার জন্য পার্স বিভাগে নিম্নলিখিত সিনট্যাক্স ব্যবহার করুন
মাত্রার আকার:

' [o] y(n=9); '

প্রত্যাশিত হিসাবে, প্রয়োজনে থ্রেডিং দ্বারা প্রয়োজনীয় অতিরিক্ত মাত্রা তৈরি করা হবে। আপনি যদি
একটি আরও জটিল সূত্র অনুসারে একটি নামযুক্ত মাত্রা নির্ধারণ করতে হবে (একটি ধ্রুবকের চেয়ে)
আপনাকে অবশ্যই নীচে বর্ণিত "RedoDimsCode" কী ব্যবহার করতে হবে।

আদর্শ ধর্মান্তর এবং দ্য স্বাক্ষর
স্বাক্ষর এছাড়াও টাইপ রূপান্তর নির্ধারণ করে যে সঞ্চালিত হবে যখন একটি PP
ফাংশন আহ্বান করা হয়। তাই কি হয় যখন আমরা আমাদের পূর্বে সংজ্ঞায়িত এক আহ্বান
বিভিন্ন ধরনের pdls সহ ফাংশন, যেমন

add2($a,$b,($ret=null));

যেখানে $a টাইপের "PDL_Float" এবং $b টাইপের "PDL_Short"? স্বাক্ষর সহ যেমন দেখানো হয়েছে
অপারেশনের ডেটাটাইপের উপরে "add2" এর সংজ্ঞা (রানটাইমে নির্ধারিত)
'সর্বোচ্চ' টাইপ সহ pdl এর (ক্রম হল বাইট < সংক্ষিপ্ত < ushort < দীর্ঘ < ফ্লোট
< দ্বিগুণ)। অ্যাড 2 উদাহরণে অপারেশনের ডেটাটাইপটি ফ্লোট ($a এর আছে
ডেটাটাইপ)। সমস্ত পিডিএল আর্গুমেন্টগুলি তারপর সেই ডেটাটাইপে রূপান্তরিত টাইপ করা হয় (সেগুলি নয়
inplace রূপান্তরিত কিন্তু একটি pdl আর্গুমেন্ট না থাকলে সঠিক টাইপের একটি অনুলিপি তৈরি করা হয়
অপারেশনের ধরন)। নাল pdls এর সংকল্পে কোন প্রকার অবদান রাখে না
অপারেশনের ধরন। যাইহোক, তারা অপারেশনের ডেটাটাইপ দিয়ে তৈরি করা হবে;
এখানে, উদাহরণস্বরূপ, $ret টাইপের ফ্লোট হবে। আপনি যখন এই নিয়ম সচেতন হতে হবে
অতিরিক্ত স্টোরেজ নিতে বিভিন্ন ধরনের pdls সহ পিপি ফাংশন কল করা এবং
অ্যাকাউন্টে রানটাইম প্রয়োজনীয়তা.

এই ধরনের রূপান্তরগুলি আপনি সাধারণত "pp_def" দিয়ে সংজ্ঞায়িত বেশিরভাগ ফাংশনের জন্য সঠিক।
যাইহোক, কিছু কিছু ক্ষেত্রে আছে যেখানে সামান্য পরিবর্তিত ধরনের রূপান্তর আচরণ
আকাঙ্ক্ষিত. এই ক্ষেত্রে স্বাক্ষরের অতিরিক্ত যোগ্যতা নির্দিষ্ট করতে ব্যবহার করা যেতে পারে
টাইপ রূপান্তর সংক্রান্ত পছন্দসই বৈশিষ্ট্য. এই কোয়ালিফায়ারগুলির সাথে মিলিত হতে পারে
যাদের আমরা ইতিমধ্যেই সম্মুখীন হয়েছি ( সৃষ্টি কোয়ালিফায়ার "[o]" এবং "[t]")। চলো যাই
কোয়ালিফায়ারদের তালিকার মাধ্যমে যা টাইপ রূপান্তর আচরণ পরিবর্তন করে।

সবচেয়ে গুরুত্বপূর্ণ হল "int" কোয়ালিফায়ার যা pdl আর্গুমেন্টের সময় কাজে আসে
সূচকগুলিকে অন্য পিডিএলে উপস্থাপন করে। আসুন "PDL::Ufunc" থেকে একটি উদাহরণ দেখি:

pp_def('সর্বোচ্চ_ইন্ড',
পার্স => 'a(n); int [o] b()',
কোড => '$GENERIC() cur;
int curind;
লুপ(n) %{
যদি (!n || $a() > cur) {cur = $a(); curind = n;}
%}
$b() = curind;',
);

"maximum_ind" ফাংশনটি একটি ভেক্টরের বৃহত্তম উপাদানের সূচক খুঁজে পায়। যদি তুমি তাকাও
স্বাক্ষরে আপনি লক্ষ্য করেছেন যে আউটপুট আর্গুমেন্ট "b" এর সাথে ঘোষণা করা হয়েছে
অতিরিক্ত "int" কোয়ালিফায়ার। টাইপ রূপান্তরগুলির জন্য এটির নিম্নলিখিত ফলাফল রয়েছে:
ইনপুট pdl "a" প্রকার নির্বিশেষে আউটপুট pdl "b" টাইপের হবে "PDL_Long"
যা বোঝায় যেহেতু "b" একটি সূচককে "a" তে উপস্থাপন করবে। উপরন্তু, যদি আপনি কল
একটি বিদ্যমান আউটপুট pdl "b" সহ ফাংশন এর টাইপ ডেটাটাইপকে প্রভাবিত করবে না
অপারেশন (উপরে দেখুন)। তাই, "a" "b" এর চেয়ে ছোট টাইপের হলেও তা হবে না
"b" টাইপের সাথে মেলে রূপান্তরিত কিন্তু অস্পর্শ থাকে, যা মেমরি এবং CPU চক্র সংরক্ষণ করে
এবং যখন "b" সূচকের প্রতিনিধিত্ব করে তখন এটি করা সঠিক জিনিস। এছাড়াও মনে রাখবেন যে আপনি ব্যবহার করতে পারেন
'int' কোয়ালিফায়ার একসাথে অন্যান্য কোয়ালিফায়ারের সাথে ("[o]" এবং "[t]" কোয়ালিফায়ার)। অর্ডার হল
উল্লেখযোগ্য -- টাইপ কোয়ালিফায়ারগুলি ক্রিয়েশন কোয়ালিফায়ারের আগে থাকে ("[o]" এবং "[t]")।

উপরের উদাহরণটি "$GENERIC()" ম্যাক্রোর সাধারণ ব্যবহারও দেখায়। এটি প্রসারিত হয়
একটি তথাকথিত জেনেরিক লুপে বর্তমান প্রকারে। একটি জেনেরিক লুপ কি? আপনি ইতিমধ্যে
শুনেছি একটি PP ফাংশনের একটি রানটাইম ডেটাটাইপ আছে যেমন pdl আর্গুমেন্টের ধরন দ্বারা নির্ধারিত হয়
এটা দিয়ে আহ্বান করা হয়েছে. এই ফাংশনের জন্য পিপি জেনারেট করা XS কোডে একটি থাকে
"switch (type) {case PDL_Byte: ... case PDL_Double: ...}" এর মত স্যুইচ করুন যা একটি কেস নির্বাচন করে
ফাংশনের রানটাইম ডেটাটাইপের উপর ভিত্তি করে (এটিকে একটি টাইপ ``লুপ'' বলা হয় কারণ সেখানে
পিপি কোডের একটি লুপ যা কেস তৈরি করে)। যে কোনো ক্ষেত্রে আপনার কোড একবার ঢোকানো হয়
প্রতিটি পিডিএল-এর জন্য এই সুইচ স্টেটমেন্টে টাইপ করুন। "$GENERIC()" ম্যাক্রো শুধু প্রসারিত হয়
এই "সুইচ" বিবৃতিতে আপনার পার্স করা কোডের প্রতিটি অনুলিপিতে সংশ্লিষ্ট টাইপ করুন, যেমন, তে
"কেস PDL_Byte" বিভাগ "cur" প্রসারিত হবে "PDL_Byte" এবং অন্যান্য ক্ষেত্রেও
বিবৃতি আমার ধারণা আপনি বুঝতে পেরেছেন যে এটি কিছুতে pdls এর মান ধরে রাখার জন্য একটি দরকারী ম্যাক্রো
কোড।

"int" এর মতো অনুরূপ প্রভাব সহ আরও কয়েকটি কোয়ালিফায়ার রয়েছে। আপনার জন্য
সুবিধার্থে "ফ্লোট" এবং "ডাবল" কোয়ালিফায়ার আছে
"int" হিসাবে রূপান্তর টাইপ করুন। ধরা যাক আপনি একটি আছে খুব বড় অ্যারে যার জন্য আপনি চান
"sumover" ফাংশনের সমতুল্য সহ সারি এবং কলামের যোগফল গণনা করুন। যাইহোক, সঙ্গে
"sumover" এর স্বাভাবিক সংজ্ঞা যখন আপনার ডেটা হয় তখন আপনি সমস্যায় পড়তে পারেন, যেমন
সংক্ষিপ্ত টাইপ করুন। একটি কল মত

sumover($large_pdl,($sums = null));

এর ফলে $sums ছোট আকারের হবে এবং তাই যদি ওভারফ্লো ত্রুটির প্রবণতা থাকে
$large_pdl একটি খুব বড় অ্যারে। অন্যদিকে ডাকছে

@dims = $large_pdl->dims; শিফট @dims;
sumover($large_pdl,($sums = zeroes(Duble,@dims)));

একটি ভাল বিকল্প হয় না. এখন আমাদের $sums এর সাথে ওভারফ্লো সমস্যা নেই কিন্তু এ
$large_pdl-এর টাইপ রূপান্তরের খরচ দ্বিগুণ, যদি এটি সত্যিই হয় তবে খারাপ কিছু
একটি বড় পিডিএল। সেখানেই "ডাবল" কাজে আসে:

pp_def('sumoverd',
পার্স => 'a(n); দ্বিগুণ [ও] বি()',
কোড => 'ডবল tmp=0;
loop(n) %{ tmp += a(); %}
$b() = tmp;',
);

এটি আমাদের টাইপ রূপান্তর এবং ওভারফ্লো সমস্যার কাছাকাছি পায়। আবার, অনুরূপ
"int" কোয়ালিফায়ার "ডবল" এর ফলে "বি" টাইপ নির্বিশেষে সবসময় ডাবল টাইপের হয়
পার্শ্ব প্রতিক্রিয়া হিসাবে "a"-এর টাইপ রূপান্তর না করেই "a" এর।

অবশেষে, "টাইপ+" কোয়ালিফায়ার আছে যেখানে টাইপ হল "int" বা "float" এর মধ্যে একটি। কি
এর মানে হবে এর প্রকৃত সংজ্ঞা দিয়ে "int+" কোয়ালিফায়ারকে চিত্রিত করা যাক
sumover:

pp_def('sumover',
পার্স => 'a(n); int+ [o] b()',
কোড => '$GENERIC(b) tmp=0;
loop(n) %{ tmp += a(); %}
$b() = tmp;',
);

আমরা ইতিমধ্যেই "int", "float" এবং "ডাবল" কোয়ালিফায়ারের জন্য দেখেছি, একটি পিডিএল চিহ্নিত
"type+" কোয়ালিফায়ার pdl অপারেশনের ডেটাটাইপকে প্রভাবিত করে না। এর অর্থ হল
"এই পিডিএলটি কমপক্ষে "টাইপ" বা উচ্চতর টাইপের তৈরি করুন, যেমন টাইপের প্রয়োজন
অপারেশন। sumover উদাহরণে এর মানে হল যখন আপনি একটি "a" দিয়ে ফাংশনটিকে কল করেন
PDL_Short টাইপের আউটপুট pdl হবে PDL_Long টাইপের (ঠিক যেমন হতো
"int" কোয়ালিফায়ারের ক্ষেত্রে)। এটি আবার ব্যবহার করার সময় ওভারফ্লো সমস্যা এড়াতে চেষ্টা করে
ছোট ডেটাটাইপ (যেমন বাইট ইমেজ)। তবে অপারেশনের ডাটাটাইপ বেশি হলে
"type+" কোয়ালিফায়ারে উল্লেখিত টাইপের চেয়ে "b" এর ডেটাটাইপ দিয়ে তৈরি করা হবে
অপারেশন, যেমন "a" টাইপের দ্বিগুণ হলে "b"ও দ্বিগুণ হবে। আমরা আশা করি
আপনি সম্মত হন যে এটি "sumover" এর জন্য বুদ্ধিমান আচরণ। এটা কিভাবে সুস্পষ্ট হওয়া উচিত
"float+" কোয়ালিফায়ার সাদৃশ্য দ্বারা কাজ করে। এটি একটি সেট নির্দিষ্ট করতে সক্ষম হতে প্রয়োজনীয় হতে পারে
পরামিতি জন্য বিকল্প ধরনের. যাইহোক, এটি সম্ভবত বাস্তবায়িত হবে না
যতক্ষণ না কেউ এটির জন্য একটি যুক্তিসঙ্গত ব্যবহার নিয়ে আসে।

উল্লেখ্য, আমাদের এখন পিডিএল-এর নামের সাথে $GENERIC ম্যাক্রো নির্দিষ্ট করতে হবে
যে যুক্তি থেকে টাইপ করুন. তা কেন? আপনি সাবধানে আমাদের ব্যাখ্যা অনুসরণ করলে আপনি হবে
বুঝতে পেরেছি যে কিছু ক্ষেত্রে "b" এর ধরন থেকে ভিন্ন ধরনের হবে
অপারেশন. আর্গুমেন্ট হিসাবে "b" সহ '$GENERIC' ম্যাক্রো কল করা নিশ্চিত করে যে টাইপ
জেনেরিক লুপের সেই অংশে সর্বদা "b" এর মতই থাকবে।

এটি একটি "pp_def" কলে "Pars" বিভাগ সম্পর্কে যা বলার আছে। তোমার উচিত
মনে রাখবেন যে এই বিভাগটি সংজ্ঞায়িত করে স্বাক্ষর একটি PP সংজ্ঞায়িত ফাংশন, আপনি ব্যবহার করতে পারেন
আউটপুট এবং অস্থায়ী আর্গুমেন্ট এবং সমস্ত হিসাবে নির্দিষ্ট আর্গুমেন্ট যোগ্যতা অর্জনের জন্য বেশ কয়েকটি বিকল্প
যে মাত্রাগুলি আপনি পরে "কোড" বিভাগে উল্লেখ করতে পারেন সেগুলি নাম দ্বারা সংজ্ঞায়িত করা হয়৷

সাম্প্রতিক PDL-এ আপনি স্বাক্ষরের অর্থ বোঝা গুরুত্বপূর্ণ
সংস্করণগুলি আপনি পার্লের মধ্যে থেকে থ্রেডেড ফাংশন সংজ্ঞায়িত করতে এটি ব্যবহার করতে পারেন, যেমন আমরা যা বলি
পার্ল স্তর থ্রেডিং. বিস্তারিত জানার জন্য অনুগ্রহ করে PDL::Indexing চেক করুন।

সার্জারির কোড অধ্যায়
"কোড" বিভাগে প্রকৃত XS কোড রয়েছে যা a এর সবচেয়ে ভিতরের অংশে থাকবে
থ্রেড লুপ (যদি আপনি জানেন না থ্রেড লুপ কী তাহলে আপনি এখনও পড়েননি
PDL::সূচীকরণ; এখন এটি করুন ;) যেকোনো পিপি ম্যাক্রো (যেমন $জেনেরিক) এবং পিপি ফাংশন হওয়ার পরে
প্রসারিত (যেমন "লুপ" ফাংশন আমরা পরবর্তী ব্যাখ্যা করতে যাচ্ছি)।

আসুন দ্রুত "sumover" উদাহরণটি পুনরাবৃত্তি করি:

pp_def('sumover',
পার্স => 'a(n); int+ [o] b()',
কোড => '$GENERIC(b) tmp=0;
loop(n) %{ tmp += a(); %}
$b() = tmp;',
);

"কোড" বিভাগে "লুপ" গঠনটি মাত্রার নামটিকেও নির্দেশ করে যাতে আপনি তা না করেন
কোন সীমা নির্দিষ্ট করতে হবে: লুপ সঠিকভাবে মাপ করা হয়েছে এবং সবকিছু আপনার জন্য করা হয়েছে,
আবার.

এরপরে, "$a()" এবং "$b()" যেটি করে তা আশ্চর্যজনক ঘটনা রয়েছে না সূচক ধারণ করুন। এই
প্রয়োজন নেই কারণ আমরা লুপ করছি n এবং উভয় ভেরিয়েবলই জানে কোন মাত্রা
তাদের আছে তাই তারা স্বয়ংক্রিয়ভাবে জানে যে তারা লুপ করা হচ্ছে।

এই বৈশিষ্ট্যটি অনেক জায়গায় খুব কাজে আসে এবং অনেক ছোট কোড তৈরি করে। এর
অবশ্যই, এমন সময় আছে যখন আপনি এটিকে এড়াতে চান; এখানে একটি ফাংশন যা একটি তৈরি করে
ম্যাট্রিক্স সিমেট্রিক এবং কীভাবে স্পষ্ট লুপিং কোড করতে হয় তার একটি উদাহরণ হিসাবে কাজ করে:

pp_def('symm',
পার্স => 'a(n,n); [o]c(n,n);',
কোড => 'লুপ(এন) %{
int n2;
জন্য(n2=n; n2<$SIZE(n); n2++) {
$c(n0 => n, n1 => n2) =
$c(n0 => n2, n1 => n) =
$a(n0 => n, n1 => n2);
}
%}
'
);

কি ঘটছে এর ব্যবচ্ছেদ করা যাক. প্রথমত, এই ফাংশন কি করতে অনুমিত হয়? এর থেকে
স্বাক্ষর আপনি দেখতে পাচ্ছেন যে এটি সমান সংখ্যক কলাম এবং সারি সহ একটি 2D ম্যাট্রিক্স নেয় এবং
একই আকারের একটি ম্যাট্রিক্স আউটপুট করে। একটি প্রদত্ত ইনপুট ম্যাট্রিক্স $a থেকে এটি একটি প্রতিসম গণনা করে
আউটপুট ম্যাট্রিক্স $c (ম্যাট্রিক্স অর্থে প্রতিসম যে A^T = A যেখানে ^T মানে ম্যাট্রিক্স
ট্রান্সপোজ, অথবা PDL ভাষায় $c == $c->xchg(0,1))। এটি শুধুমাত্র মান ব্যবহার করে এটি করে
$a এর কর্ণের উপর এবং নীচে। আউটপুট ম্যাট্রিক্সে $c এর উপর এবং নীচের সমস্ত মান
তির্যকগুলি $a-তে থাকাগুলির মতো একই যখন তির্যকের উপরে থাকাগুলি একটি মিরর ইমেজ৷
যেগুলি তির্যকের নীচে (উপরে এবং নীচে PDL প্রিন্ট করে সেভাবে ব্যাখ্যা করা হয়েছে
2D pdls)। যদি এই ব্যাখ্যাটি এখনও কিছুটা অদ্ভুত মনে হয় তবে এগিয়ে যান, একটি ছোট ফাইল তৈরি করুন
যেটিতে আপনি এই সংজ্ঞাটি লিখুন, নতুন PDL এক্সটেনশন তৈরি করুন (অনুচ্ছেদ দেখুন
পিপি কোডের জন্য মেকফাইলস) এবং কয়েকটি উদাহরণ দিয়ে এটি চেষ্টা করুন।

ফাংশনটি কী করতে হবে তা ব্যাখ্যা করার পর কয়েকটি পয়েন্টের মূল্য রয়েছে
সিনট্যাক্টিক্যাল দৃষ্টিকোণ থেকে লক্ষ্য করা। প্রথমত, আমরা নামের মাত্রার আকার পাই
$SIZE ম্যাক্রো ব্যবহার করে আবার "n"। দ্বিতীয়ত, হঠাৎ এই মজার "n0" এবং "n1" আছে
কোডে সূচকের নাম যদিও স্বাক্ষর শুধুমাত্র মাত্রা "n" সংজ্ঞায়িত করে। কেন এটা? দ্য
কারণ স্পষ্ট হয়ে যায় যখন আপনি লক্ষ্য করেন যে $a এবং $b-এর প্রথম এবং দ্বিতীয় মাত্রা উভয়ই
"symm" এর স্বাক্ষরে "n" নামকরণ করা হয়েছে। এটি PDL::PP বলে যে প্রথম এবং দ্বিতীয়
এই আর্গুমেন্টের মাত্রা একই আকার হওয়া উচিত। অন্যথায় উত্পন্ন ফাংশন
একটি রানটাইম ত্রুটি বাড়াবে। যাইহোক, এখন $a এবং $c PDL::PP-এর একটি অ্যাক্সেসের মধ্যে এটা বোঝা যায় না
কোন সূচী "n" শুধুমাত্র সূচকের নাম থেকে আর কোন নির্দেশ করে। সুতরাং, এটি
সমান মাত্রার নামের সূচকগুলি 0 থেকে শুরু করে বাম থেকে ডানে সংখ্যাযুক্ত হয়, যেমন in
উপরের উদাহরণ "n0" $a এবং $c এর প্রথম মাত্রা, "n1" দ্বিতীয় এবং
শীঘ্রই.

এখন পর্যন্ত সমস্ত উদাহরণে, আমরা হ্যাশের শুধুমাত্র "পার্স" এবং "কোড" সদস্য ব্যবহার করেছি
"pp_def" এ পাস করা হয়েছে। PDL::PP এবং দ্বারা স্বীকৃত অন্যান্য কী অবশ্যই আছে
আমরা এই নথির কোর্সে তাদের কিছু সম্পর্কে শুনব। একটি খুঁজুন (অ-সম্পূর্ণ)
পরিশিষ্ট A-তে কীগুলির তালিকা। ম্যাক্রো এবং পিপি ফাংশনের একটি তালিকা (আমরা শুধুমাত্র সম্মুখীন হয়েছি
উপরের উদাহরণগুলির মধ্যে কিছু এখনও) যা হ্যাশ আর্গুমেন্টের মানগুলিতে প্রসারিত
to "pp_def" পরিশিষ্ট বি তে সংক্ষিপ্ত করা হয়েছে।

এই মুহুর্তে, এটি উল্লেখ করা উপযুক্ত হতে পারে যে PDL::PP সম্পূর্ণরূপে স্থির নয়,
ভালোভাবে ডিজাইন করা রুটিনের সেট (যেমন টুমাস বলেছেন: "পিপিকে একটি সেট হিসাবে ভাবা বন্ধ করুন
পাথরে খোদাই করা রুটিন") বরং পিডিএল::পিপি লেখকের জিনিসগুলির একটি সংগ্রহ
(Tuomas J. Lukka) মনে করেন যে তাকে প্রায়ই তার PDL এক্সটেনশন রুটিনে লিখতে হবে।
পিপি প্রসারণযোগ্য হওয়ার চেষ্টা করে যাতে ভবিষ্যতে, নতুন চাহিদা দেখা দিলে, নতুন সাধারণ কোড হতে পারে
এটা ফিরে বিমূর্ত করা. আপনি কেন পরিবর্তন করতে চান সে সম্পর্কে আরও জানতে চাইলে
পিডিএল::পিপি এবং এটি কীভাবে করবেন তা পিডিএল::পিপি ইন্টারনালের বিভাগটি পরীক্ষা করুন।

হ্যান্ডলিং পায়খানা মূল্যবোধ
আপনার যদি পিডিএল-এ কম্পাইল করা খারাপ-মান সমর্থন না থাকে তবে আপনি এই বিভাগটি এবং উপেক্ষা করতে পারেন
সম্পর্কিত কী: "BadCode", "HandleBad", ... (এর মান প্রিন্ট করার চেষ্টা করুন
$PDL::খারাপ::স্থিতি - যদি এটি 0 এর সমান হয় তাহলে সরাসরি এগিয়ে যান)।

খারাপ মানগুলি পরিচালনা করতে কোড লেখার সময় বেশ কয়েকটি কী এবং ম্যাক্রো ব্যবহার করা হয়। প্রথম
একটি হল "HandleBad" কী:

হ্যান্ডেলব্যাড => ১
এটি একটি pp-রুটিন হিসাবে চিহ্নিত করে৷ না খারাপ মান পরিচালনা করা। যদি এই রুটিন পাঠানো হয় piddles
তাদের "ব্যাডফ্ল্যাগ" সেটের সাথে, তারপর STDOUT এবং পিডলে একটি সতর্কতা বার্তা মুদ্রিত হয়
এমনভাবে প্রক্রিয়া করা হয় যেন খারাপ মানগুলিকে উপস্থাপন করতে ব্যবহৃত মানটি একটি বৈধ সংখ্যা। দ্য
"badflag" মান আউটপুট piddles প্রচার করা হয় না.

এটি কখন ব্যবহার করা হয় তার একটি উদাহরণ হল এফএফটি রুটিনের জন্য, যার সাধারণত কোনও উপায় থাকে না
ডেটার অংশ উপেক্ষা করা।

হ্যান্ডেলব্যাড => ১
এর ফলে PDL::PP অতিরিক্ত কোড লিখতে পারে যা নিশ্চিত করে যে ব্যাডকোড বিভাগটি ব্যবহার করা হয়েছে, এবং
যে "$ISBAD()" ম্যাক্রো (এবং এর ভাইরা) কাজ করে।

হ্যান্ডেলব্যাড দেওয়া হয় না
যদি কোনো ইনপুট পিডলে তাদের "ব্যাডফ্ল্যাগ" সেট থাকে, তাহলে আউটপুট পিডল হবে
তাদের "ব্যাডফ্ল্যাগ" সেট আছে, কিন্তু সরবরাহ করা কোনো ব্যাডকোড উপেক্ষা করা হয়।

"HandleBad" এর মান "BadDoc" কী এর বিষয়বস্তু নির্ধারণ করতে ব্যবহৃত হয়, যদি এটি না হয়
দেওয়া।

খারাপ মান পরিচালনা করতে, কোড কিছুটা ভিন্নভাবে লিখতে হবে; এই ক্ষেত্রে,

$c() = $a() + $b();

মত কিছু হয়ে যায়

যদি ( $a() != BADVAL && $b() != BADVAL ) {
$c() = $a() + $b();
} অন্য {
$c() = BADVAL;
}

যাইহোক, আমরা শুধুমাত্র দ্বিতীয় সংস্করণ চাই যদি ইনপুট পিডলে খারাপ মান উপস্থিত থাকে
(এবং সেই খারাপ-মান সমর্থন চাই!) - অন্যথায় আমরা আসলে আসল কোড চাই।
এখানেই "BadCode" কী আসে; খারাপ হলে চালানোর জন্য কোড নির্দিষ্ট করতে আপনি এটি ব্যবহার করেন
মান উপস্থিত থাকতে পারে, এবং PP কিছু তৈরি করতে এটি এবং "কোড" বিভাগ উভয়ই ব্যবহার করে
মত:

যদি ( খারাপ_মান_আছে_বর্তমান ) {
অভিনব_থ্রেডলুপ_স্টাফ {
খারাপ কোড
}
} অন্য {
অভিনব_থ্রেডলুপ_স্টাফ {
কোড
}
}

এই পদ্ধতির অর্থ হল যে খারাপ মানগুলি উপস্থিত না থাকলে কার্যত কোনও ওভারহেড নেই৷
(অর্থাৎ ব্যাডফ্ল্যাগ রুটিন 0 প্রদান করে)।

ব্যাডকোড বিভাগটি কোড বিভাগের মতো একই ম্যাক্রো এবং লুপিং কনস্ট্রাক্ট ব্যবহার করতে পারে।
যাইহোক, নিম্নলিখিত অতিরিক্ত ম্যাক্রো ছাড়া এটি খুব বেশি ব্যবহার করা হবে না:

$ISBAD(var)
একটি পিডলের মান খারাপ কিনা তা পরীক্ষা করতে $ISBAD ম্যাক্রো ব্যবহার করুন:

যদি ( $ISBAD(a()) ) { printf("a() খারাপ\n"); }

আপনি একটি পিডলের প্রদত্ত উপাদানগুলিও অ্যাক্সেস করতে পারেন:

যদি ( $ISBAD(a(n=>l)) ) { printf("a() এর %d উপাদান খারাপ\n", l); }

$ISGOOD(var)
এটি $ISBAD ম্যাক্রোর বিপরীত।

$SETBAD(var)
যখন আপনি একটি পিডল খারাপ একটি উপাদান সেট করতে চান.

$ISBADVAR(c_var,pdl)
আপনি যদি একটি পিডল "$a()" এর মান একটি সি-ভেরিয়েবল ("foo" বলে) তে ক্যাশে করে থাকেন, তাহলে
এটি খারাপ কিনা তা পরীক্ষা করে দেখুন, "$ISBADVAR(foo,a)" ব্যবহার করুন।

$ISGOODVAR(c_var,pdl)
উপরের হিসাবে, কিন্তু এই সময় পরীক্ষা করা হচ্ছে যে ক্যাশে মান খারাপ নয়।

$SETBADVAR(c_var,pdl)
এসি ভেরিয়েবলে পিডলের খারাপ মান কপি করতে, "$SETBADVAR(foo,a)" ব্যবহার করুন।

করতে: "$PPISBAD()" ইত্যাদি ম্যাক্রো উল্লেখ করুন।

এই ম্যাক্রো ব্যবহার করে, উপরের কোডটি নির্দিষ্ট করা যেতে পারে:

কোড => '$c() = $a() + $b();',
খারাপ কোড => '
যদি ( $ISBAD(a()) || $ISBAD(b()) ) {
$SETBAD(c());
} অন্য {
$c() = $a() + $b();
}',

যেহেতু এটি পার্ল, TMTOWTDI, তাই আপনি লিখতে পারেন:

খারাপ কোড => '
যদি ( $ISGOOD(a()) && $ISGOOD(b()) ) {
$c() = $a() + $b();
} অন্য {
$SETBAD(c());
}',

আপনি যদি একটি প্রদত্ত পিডলের জন্য ব্যাডফ্ল্যাগের মান অ্যাক্সেস করতে চান তবে আপনি ব্যবহার করতে পারেন
"$PDLSTATExxxx()" ম্যাক্রো:

$PDLSTATEISBAD(pdl)
$PDLSTATEISGOOD(pdl)
$PDLSTATESETBAD(pdl)
$PDLSTATESETGOOD(pdl)

করতে: পাশাপাশি "pp_def" তে "FindBadStatusCode" এবং "CopyBadStatusCode" বিকল্পগুলি উল্লেখ করুন
"BadDoc" কী হিসাবে।

পোশাকের তোমার নিজস্ব/লাইব্রেরি ক্রিয়াকলাপ ব্যবহার PP
এখন, নিম্নলিখিতগুলি বিবেচনা করুন: আপনার নিজস্ব সি ফাংশন রয়েছে (যা আসলে এর অংশ হতে পারে
কিছু লাইব্রেরি যা আপনি PDL এ ইন্টারফেস করতে চান) যা আর্গুমেন্ট হিসাবে দুটি পয়েন্টার নেয়
দ্বিগুণ ভেক্টর:

void myfunc(int n,double *v1, double *v2);

PDL ফাংশন সংজ্ঞায়িত করার সঠিক উপায়

pp_def('myfunc',
পার্স => 'a(n); [o]b(n);',
জেনেরিক টাইপস => ['ডি'],
কোড => 'myfunc($SIZE(n),$P(a),$P(b));'
);

"$P("দ্বারা")" সিনট্যাক্স প্রথম উপাদানে একটি পয়েন্টার প্রদান করে এবং অন্যান্য উপাদানগুলি হল
এর পরে মিথ্যা বলার নিশ্চয়তা।

লক্ষ্য করুন যে এখানে অনেক ভুল করা সম্ভব। প্রথমে $SIZE(n) ব্যবহার করতে হবে
"n" এর পরিবর্তে। দ্বিতীয়ত, আপনার এই কোডে কোনো লুপ রাখা উচিত নয়। তৃতীয়, এখানে আমরা সম্মুখীন
PDL::PP দ্বারা স্বীকৃত একটি নতুন হ্যাশ কী : "জেনারিক টাইপস" ঘোষণা PDL::PP কে বলে
শুধুমাত্র নির্দিষ্ট ধরনের তালিকার টাইপলুপ তৈরি করুন। এই ক্ষেত্রে "ডবল"। এই
দুটি সুবিধা আছে। প্রথমত সংকলিত কোডের আকার ব্যাপকভাবে হ্রাস করা হয়, দ্বিতীয়ত যদি
নন-ডাবল আর্গুমেন্টগুলি "myfunc()"-এ পাস করা হয় PDL স্বয়ংক্রিয়ভাবে সেগুলিকে রূপান্তর করবে
বাহ্যিক C রুটিনে যাওয়ার আগে দ্বিগুণ করুন এবং পরে সেগুলিকে আবার রূপান্তর করুন।

পৃথক আর্গুমেন্টের ধরনগুলিকে যোগ্যতা অর্জন করতে কেউ "পার্স" ব্যবহার করতে পারে। এভাবে একজনও পারে
এইভাবে লিখুন:

pp_def('myfunc',
পার্স => 'ডবল a(n); দ্বিগুণ [o]b(n);',
কোড => 'myfunc($SIZE(n),$P(a),$P(b));'
);

"Pars"-এ টাইপ স্পেসিফিকেশন টাইপলুপের ভিন্নতা থেকে যুক্তিকে ছাড় দেয় -
বরং এটি স্বয়ংক্রিয়ভাবে রূপান্তরিত হয় এবং নির্দিষ্ট প্রকার থেকে। এটা স্পষ্টতই
আরও সাধারণ উদাহরণে দরকারী, যেমন:

void myfunc(int n,float *v1, long *v2);

pp_def('myfunc',
Pars => 'float a(n); দীর্ঘ [o]b(n);',
জেনেরিক টাইপস => ['এফ'],
কোড => 'myfunc($SIZE(n),$P(a),$P(b));'
);

নোট করুন আমরা এখনও টাইপ লুপের আকার কমাতে "জেনারিক টাইপস" ব্যবহার করি, স্পষ্টতই পিপি পারে
নীতিগতভাবে এটি চিহ্নিত করুন এবং এটি স্বয়ংক্রিয়ভাবে করুন যদিও কোডটি এখনও এটি অর্জন করতে পারেনি
পরিশীলিত স্তর!

অবশেষে নোট করুন যখন প্রকারগুলি স্বয়ংক্রিয়ভাবে রূপান্তরিত হয় তখন একজনকে অবশ্যই "[o]" কোয়ালিফায়ার ব্যবহার করতে হবে৷
আউটপুট ভেরিয়েবল বা আপনার কঠিন একটি পরিবর্তন পিপি দ্বারা অপ্টিমাইজ করা হবে!

আপনি যদি একটি বড় লাইব্রেরি ইন্টারফেস করেন তবে আপনি ইন্টারফেসিংটিকে আরও স্বয়ংক্রিয় করতে পারেন। পার্ল পারে
এটি করতে আপনাকে আবার সাহায্য করুন(!) অনেক লাইব্রেরিতে আপনার নির্দিষ্ট কলিং কনভেনশন আছে।
এই শোষণ করা যেতে পারে. সংক্ষেপে, আপনি একটু পার্সার লিখতে পারেন (যা সত্যিই নয়
পার্লে কঠিন) যা তারপরে পার্সকৃত বিবরণ থেকে "pp_def" এ কল তৈরি করে
যে লাইব্রেরি ফাংশন. একটি উদাহরণের জন্য, চেক করুন স্লেটেক মধ্যে ইন্টারফেস
PDL বিতরণের "Lib" গাছ। আপনি যদি চেক করতে চান (ডিবাগিংয়ের সময়) কোনটিতে কল করে
পিপি ফাংশন আপনার পার্ল কোড তৈরি একটি সামান্য সহায়ক প্যাকেজ যা কাজে আসে
PP ফাংশনগুলিকে অভিন্ন নাম দিয়ে প্রতিস্থাপন করে যা তাদের আর্গুমেন্টগুলিকে stdout-এ ডাম্প করে।

শুধু বল

perl -MPDL::PP::Dump myfile.pd

"pp_def" এবং বন্ধুদের কল দেখতে। এটি দিয়ে চেষ্টা করুন ops.pd এবং slatec.pd. আপনি যদি
আগ্রহী (বা এটি উন্নত করতে চান), উত্সটি বেসিক/জেন/পিপি/ডাম্প.পিএম-এ রয়েছে

অন্যান্য ম্যাক্রো এবং ক্রিয়াকলাপ in দ্য কোড অধ্যায়
ম্যাক্রো: এখন পর্যন্ত আমরা $SIZE, $GENERIC এবং $P ম্যাক্রোর সম্মুখীন হয়েছি। এখন আমরা যাচ্ছি
PDL::PP এর "কোড" বিভাগে প্রসারিত অন্যান্য ম্যাক্রোগুলি দ্রুত ব্যাখ্যা করুন
তাদের ব্যবহারের উদাহরণ সহ।

$T $T ম্যাক্রো টাইপ সুইচের জন্য ব্যবহৃত হয়। এটি খুব দরকারী যখন আপনি ব্যবহার করতে হবে
ইনপুট ধরনের আর্গুমেন্টের উপর নির্ভর করে বিভিন্ন বাহ্যিক (যেমন লাইব্রেরি) ফাংশন।
সাধারণ সিনট্যাক্স হল

$Typeleters(type_alternatives)

যেখানে "টাইপেলেটার্স" হল "BSULFD" অক্ষরগুলির একটি উপসেটের একটি স্থানান্তর যা দাঁড়ায়
বাইট, শর্ট, উশর্ট ইত্যাদির জন্য এবং "টাইপ_বিকল্প" হল বিস্তৃতি যখন টাইপ
পিপি অপারেশন সংশ্লিষ্ট চিঠি দ্বারা নির্দেশিত যে সমান. চলুন
একটি উদাহরণ দ্বারা এই অবোধগম্য বর্ণনা ব্যাখ্যা করুন. ধরে নিচ্ছি আপনার দুটি সি আছে
প্রোটোটাইপ সহ ফাংশন

void float_func (float *in, float *out);
void double_func (ডাবল *ইন, ডবল *আউট);

যা মূলত একই জিনিস করে কিন্তু একটি ফ্লোট এবং অন্য ডবল পয়েন্টার গ্রহণ করে।
আপনি একটি জেনেরিক ফাংশন "foofunc" সংজ্ঞায়িত করে তাদের PDL এ ইন্টারফেস করতে পারেন (যা হবে
রূপান্তরের ধরণের উপর নির্ভর করে সঠিক ফাংশনটি কল করুন):

pp_def('foofunc',
পার্স => 'a(n); [o] b();',
কোড => '$TFD(float_func,double_func) ($P(a),$P(b));'
জেনেরিক টাইপস => [qw(FD)],
);

দয়া করে মনে রাখবেন আপনি বলতে পারবেন না

কোড => '$TFD(float,double)_func ($P(a),$P(b));'

যেহেতু $T ম্যাক্রো ট্রেলিং স্পেস সহ প্রসারিত হয়, অনুরূপভাবে C প্রিপ্রসেসর ম্যাক্রোর সাথে।
উপরে চিত্রিত সামান্য দীর্ঘ ফর্ম সঠিক. আপনি যদি সত্যিই সংক্ষিপ্ততা চান, আপনি
অবশ্যই করতে পারেন

'$TBSULFD('.(যোগ দিন',',ম্যাপ {"long_identifier_name_$_"}
qw/byt সংক্ষিপ্ত স্বাক্ষরবিহীন লাউঞ্জ ফ্লোট ডাবল/)।');'

$PP
$PP ম্যাক্রো একটি তথাকথিত জন্য ব্যবহৃত হয় শারীরিক ইশারা প্রবেশ. দ্য শারীরিক বোঝায়
PDL এর কিছু অভ্যন্তরীণ অপ্টিমাইজেশন (যারা PDL কোরের সাথে পরিচিত তাদের জন্য আমরা
ভ্যাফিন অপ্টিমাইজেশন সম্পর্কে কথা বলা)। এই ম্যাক্রোটি মূলত অভ্যন্তরীণ ব্যবহারের জন্য এবং আপনার জন্য
আপনার স্বাভাবিক কোডের কোনোটিতে এটি ব্যবহার করার প্রয়োজন নেই।

$COMP (এবং "অন্যান্যপারস" বিভাগ)
$COMP ম্যাক্রো কোড বিভাগে নন-পিডিএল মান অ্যাক্সেস করতে ব্যবহৃত হয়। এর নাম হল
PDL-এ রূপান্তর বাস্তবায়ন থেকে প্রাপ্ত। আপনি উল্লেখ করতে পারেন ভেরিয়েবল
$COMP ব্যবহার করার জন্য তারা ``সংকলিত'' কাঠামোর সদস্য যা PDL প্রতিনিধিত্ব করে
প্রশ্নে রূপান্তর কিন্তু মাত্রা সম্পর্কে এখনও কোনো তথ্য ধারণ করে না
(আরও বিস্তারিত জানার জন্য PDL::ইন্টারনাল চেক করুন)। যাইহোক, আপনি $COMP কে একটি হিসাবে বিবেচনা করতে পারেন
ব্ল্যাক বক্স পিডিএল-এ রূপান্তর বাস্তবায়ন সম্পর্কে কিছু না জেনে।
তাহলে আপনি এই ম্যাক্রো কখন ব্যবহার করবেন? এর প্রধান ব্যবহার হল আর্গুমেন্টের মানগুলি অ্যাক্সেস করা যা
একটি "pp_def" সংজ্ঞার "অন্যান্যপারস" বিভাগে ঘোষণা করা হয়েছে। কিন্তু তারপর আপনি না
এখনও "অন্যান্যপারস" কী সম্পর্কে শুনেছেন?! এর আরেকটি উদাহরণ দেওয়া যাক যা ব্যাখ্যা করে
উভয় নতুন বৈশিষ্ট্যের সাধারণ ব্যবহার:

pp_def('pnmout',
পার্স =>'a(মি)',
OtherPars => "char* fd",
জেনেরিক টাইপস => [qw(BUSL)],
কোড => 'PerlIO *fp;
IO *io;

io = GvIO(gv_fetchpv($COMP(fd), FALSE,SVt_PVIO));
যদি (!io || !(fp = IoIFP(io)))
croak("FP বের করতে পারছি না");

যদি (PerlIO_write(fp,$P(a),len) != len)
croak("পিএনএম ফাইল লেখার ত্রুটি");
');

এই ফাংশনটি একটি পিডিএল থেকে একটি ফাইলে ডেটা লিখতে ব্যবহৃত হয়। ফাইল বর্ণনাকারী পাস হয়
এই ফাংশন মধ্যে একটি স্ট্রিং হিসাবে. এই প্যারামিটারটি "Pars" বিভাগে যায় না
যেহেতু এটিকে পিডিএলের মতো ব্যবহার করা যায় না বরং যথাযথভাবে নামকরণ করা যায়
"অন্যান্যপারস" বিভাগ। "অন্যান্যপারস" বিভাগে পরামিতিগুলি "পার্স"-এ যা অনুসরণ করে
ফাংশন আহ্বান করার সময় বিভাগ, যেমন

FILE খুলুন,">out.dat" বা ডাই "out.dat খুলতে পারেনি";
pnmout($pdl,'FILE');

আপনি যখন কোড বিভাগের ভিতরে এই প্যারামিটারটি অ্যাক্সেস করতে চান তখন আপনাকে পিপিকে বলতে হবে
$COMP ম্যাক্রো ব্যবহার করে, যেমন আপনি উদাহরণ হিসাবে "$COMP(fd)" লিখুন। অন্যথায় পিপি
আপনি জানেন না যে আপনি যে "fd" এর কথা উল্লেখ করছেন তাতে উল্লেখ করা একই রকম
"অন্যান্যপারস" বিভাগ।

"অন্যান্যপারস" বিভাগের আরেকটি ব্যবহার হল স্বাক্ষরে একটি নামযুক্ত মাত্রা সেট করা।
আসুন এটি কীভাবে করা হয় তার একটি উদাহরণ দেওয়া যাক:

pp_def('setdim',
পার্স => '[o] a(n)',
অন্যান্য পার্স => 'int ns => n',
কোড => 'লুপ(n) %{ $a() = n; %}',
);

এটি বলে যে নামযুক্ত মাত্রা "n" এর মান থেকে শুরু করা হবে অন্যান্য
স্থিতিমাপ "ns" যা পূর্ণসংখ্যার প্রকারের (আমার ধারণা আপনি বুঝতে পেরেছেন যে আমরা ব্যবহার করি
"CType From => name_dim" সিনট্যাক্স)। এখন আপনি এই ফাংশনটিকে স্বাভাবিক উপায়ে কল করতে পারেন:

setdim(($a=null),5);
প্রিন্ট $a;
[ 0 1 2 3 4 ]

স্বীকার্য যে এই ফাংশন খুব দরকারী নয় কিন্তু এটি কিভাবে কাজ করে তা প্রদর্শন করে। আপনি যদি
একটি বিদ্যমান পিডিএল দিয়ে ফাংশনটি কল করুন এবং আপনাকে স্পষ্টভাবে নির্দিষ্ট করার দরকার নেই
"n" এর আকার যেহেতু PDL::PP নন-নাল pdl-এর মাত্রা থেকে এটি বের করতে পারে। ভিতরে
সেক্ষেত্রে আপনি কেবলমাত্র "-1" হিসাবে মাত্রা প্যারামিটার দেন:

$a = hist($b);
setdim($a,-1);

যা করা উচিৎ.

একমাত্র PP ফাংশন যা আমরা এখন পর্যন্ত উদাহরণগুলিতে ব্যবহার করেছি তা হল "লুপ"। উপরন্তু,
বর্তমানে দুটি অন্যান্য ফাংশন রয়েছে যা "কোড" বিভাগে স্বীকৃত:

থ্রেডলুপ
আমরা উপরে শুনেছি একটি পিপি সংজ্ঞায়িত ফাংশন স্বাক্ষর সব মাত্রা সংজ্ঞায়িত করে
একটি জড়িত pdl আর্গুমেন্ট আদিম অপারেশন. যাইহোক, আপনি প্রায়ই কল
যে ফাংশনগুলি আপনি PP এর সাথে pdls এর সাথে সংজ্ঞায়িত করেছেন যেগুলির চেয়ে বেশি মাত্রা রয়েছে৷
স্বাক্ষরে উল্লেখ করা হয়েছে। এই ক্ষেত্রে আদিম অপারেশন সকলের উপর সঞ্চালিত হয়
উপযুক্ত মাত্রার সাবস্লাইস যাকে বলা হয় সুতা লুপ (আরো দেখুন
উপরে ওভারভিউ এবং PDL::Indexing)। আপনি এই ধারণার কিছু ধারণা আছে অনুমান আপনি
কোড বিভাগে নির্দিষ্ট অপারেশন হওয়া উচিত বলে সম্ভবত প্রশংসা করবে
অপ্টিমাইজ করা হয়েছে যেহেতু এটি একটি থ্রেড লুপের ভিতরে সবচেয়ে টাইট লুপ। যাইহোক, যদি আপনি পুনরায় দেখুন
উদাহরণ যেখানে আমরা "pnmout" ফাংশন সংজ্ঞায়িত করি, আপনি দ্রুত বুঝতে পারবেন যে খুঁজছেন
লেখার সময় অভ্যন্তরীণ থ্রেড লুপে "IO" ফাইলের বর্ণনাকারী খুব কার্যকর নয়
অনেক সারি সহ একটি পিডিএল। একটি ভাল পদ্ধতি একবার "IO" বর্ণনাকারীর সন্ধান করা হবে
থ্রেড লুপের বাইরে এবং এর মান ব্যবহার করুন তারপর সবচেয়ে টাইট থ্রেড লুপের ভিতরে। এই
ঠিক যেখানে "থ্রেডলুপ" ফাংশনটি কাজে আসে। এখানে একটি উন্নত সংজ্ঞা
"pnmout" এর যা এই ফাংশনটি ব্যবহার করে:

pp_def('pnmout',
পার্স =>'a(মি)',
OtherPars => "char* fd",
জেনেরিক টাইপস => [qw(BUSL)],
কোড => 'PerlIO *fp;
IO *io;
int len;

io = GvIO(gv_fetchpv($COMP(fd), FALSE,SVt_PVIO));
যদি (!io || !(fp = IoIFP(io)))
croak("FP বের করতে পারছি না");

len = $আকার(মি) * আকার ($GENERIC());

থ্রেডলুপ %{
যদি (PerlIO_write(fp,$P(a),len) != len)
croak("পিএনএম ফাইল লেখার ত্রুটি");
%}
');

এই নিম্নরূপ কাজ করে. সাধারণত "কোড" বিভাগের ভিতরে আপনি যে সি কোডটি লেখেন তা স্থাপন করা হয়
একটি থ্রেড লুপের ভিতরে (যেমন পিপি এটির চারপাশে উপযুক্ত মোড়ানো XS কোড তৈরি করে)।
যাইহোক, যখন আপনি স্পষ্টভাবে "threadloop" ফাংশন ব্যবহার করেন, PDL::PP এটিকে স্বীকৃতি দেয় এবং
একটি অতিরিক্ত থ্রেড লুপ দিয়ে আপনার কোড মোড়ানো হয় না। এই প্রভাব আছে যে কোড আপনি
থ্রেড লুপের বাইরে লিখুন প্রতি ট্রান্সফর্মেশন এবং শুধুমাত্র কোডটি একবারই কার্যকর করা হয়
আশেপাশের "%{ ... %}" জোড়াটি সবচেয়ে টাইট থ্রেড লুপের মধ্যে স্থাপন করা হয়। এই
আপনি যখন সিদ্ধান্ত নিতে চান (বা অন্য কোন কোড, বিশেষ করে
CPU নিবিড় কোড) প্রতি থ্রেডে শুধুমাত্র একবার, অর্থাৎ

pp_addhdr('
#RAW 0 সংজ্ঞায়িত করুন
#ASCII 1 সংজ্ঞায়িত করুন
');
pp_def('do_raworascii',
পার্স => 'a(); b(); [o]c()',
OtherPars => 'int mode',
কোড => ' সুইচ ($Comp(মোড)) {
কেস RAW:
থ্রেডলুপ %{
/* কাঁচা জিনিস করুন */
%}
বিরতি;
কেস ASCII:
থ্রেডলুপ %{
/* ASCII স্টাফ করুন */
%}
বিরতি;
ডিফল্ট:
croak("অজানা মোড");
}'
);

ধরনের
প্রকার ফাংশন $T ম্যাক্রোর অনুরূপ কাজ করে। যাইহোক, "টাইপস" ফাংশন দিয়ে
নিম্নলিখিত ব্লকের কোড (সাধারণভাবে "%{" এবং "%}" দ্বারা সীমাবদ্ধ) সকলের জন্য কার্যকর করা হয়েছে
যে ক্ষেত্রে অপারেশন ডেটাটাইপ হয় কোন of দ্বারা উপস্থাপিত ধরনের
আর্গুমেন্টের অক্ষর "টাইপ", যেমন

কোড => '...

প্রকার (BSUL) %{
/* ইন্টিজার টাইপ অপারেশন করুন */
%}
প্রকার (FD) %{
/* ফ্লোটিং পয়েন্ট অপারেশন করুন */
%}
...'

সার্জারির রিডোডিমসকোড অধ্যায়
"RedoDimsCode" কী একটি ঐচ্ছিক কী যা পিডলের মাত্রা গণনা করতে ব্যবহৃত হয়
রানটাইম যদি স্বাক্ষর থেকে মাত্রা গণনার জন্য আদর্শ নিয়ম না হয়
যথেষ্ট "RedoDimsCode" এন্ট্রির বিষয়বস্তু একইভাবে ব্যাখ্যা করা হয়েছে
কোড বিভাগটি ব্যাখ্যা করা হয়েছে-- অর্থাত, PP ম্যাক্রো প্রসারিত হয় এবং ফলাফল হয়
সি কোড হিসাবে ব্যাখ্যা করা হয়। কোডের উদ্দেশ্য হল কিছু মাত্রার আকার নির্ধারণ করা
স্বাক্ষরে উপস্থিত হয়। স্টোরেজ বরাদ্দ এবং থ্রেডলুপ ইত্যাদি হিসাবে সেট আপ করা হবে
যদি গণনা করা মাত্রা স্বাক্ষরে উপস্থিত হত। আপনার কোড, আপনি প্রথম গণনা
আপনার প্রয়োজন অনুসারে স্বাক্ষরে একটি নামযুক্ত মাত্রার পছন্দসই আকার এবং তারপর
$ এর মাধ্যমে এটিতে সেই মানটি নির্ধারণ করুনSIZE() ম্যাক্রো

একটি উদাহরণ হিসাবে, নিম্নলিখিত পরিস্থিতি বিবেচনা করুন। আপনি একটি বহিরাগত লাইব্রেরি ইন্টারফেস করছেন
রুটিন যেটি একটি আর্গুমেন্ট হিসাবে পাস করার জন্য ওয়ার্কস্পেসের জন্য একটি অস্থায়ী অ্যারে প্রয়োজন। দুই
পাস করা হয় যে ইনপুট ডেটা অ্যারে হয় p(m) এবং x(n)। আউটপুট ডেটা অ্যারে হল y(n)। দ্য
রুটিনের জন্য n+m*m দৈর্ঘ্য সহ একটি ওয়ার্কস্পেস অ্যারে প্রয়োজন এবং আপনি স্টোরেজ চান
স্বয়ংক্রিয়ভাবে তৈরি হয়েছে ঠিক যেমন এটি [t] বা [o] দিয়ে পতাকাঙ্কিত যেকোনো পিডলের জন্য হবে। কি
আপনি কিছু বলতে চান

pp_def( "myexternalfunc",
পার্স => " p(মি); x(n); [o] y; [t] কাজ (n+m*m); ",...

কিন্তু এটি কাজ করবে না, কারণ PP পাটিগণিতের সাথে অভিব্যক্তিকে ব্যাখ্যা করতে পারে না
স্বাক্ষর বরং আপনি লিখুন

pp_def( "myexternalfunc",
পার্স => " p(মি); x(n); [o] y; [t] কাজ(wn); ",
RedoDimsCode => "
int im = $PDL(p)->dims[0];
int in = $PDL(x)->dims[0];
int min = in + im * im;
int inw = $PDL(work)->dims[0];
$SIZE(wn) = inw >= মিনিট? inw: মিনিট; ",
কোড => "
externalfunc($P(p),$P(x),$আকার(m),$SIZE(n),$P(কাজ));
";)

এই কোডটি নিম্নরূপ কাজ করে: ম্যাক্রো $PDL(p) এর জন্য pdl struct-এর একটি পয়েন্টারে প্রসারিত হয়
পিডল পি. আপনি এই ক্ষেত্রে ডেটার (যেমন $P ) একটি পয়েন্টার চান না, কারণ আপনি
সি স্তরে পিডলের জন্য পদ্ধতিগুলি অ্যাক্সেস করতে চান। আপনি প্রথম মাত্রা পেতে
প্রতিটি piddles এবং পূর্ণসংখ্যা তাদের সংরক্ষণ করুন. তারপর আপনি সর্বনিম্ন দৈর্ঘ্য গণনা
কাজের অ্যারে হতে পারে। ব্যবহারকারী পর্যাপ্ত সঞ্চয়স্থান সহ একটি পিডল "কাজ" পাঠালে, তারপর এটি ছেড়ে দিন
একা যদি ব্যবহারকারী পাঠান, একটি নাল pdl বলুন, বা আদৌ কোনো pdl না বলুন, তাহলে wn এর আকার হবে
শূন্য এবং আপনি সর্বনিম্ন মান এটি পুনরায় সেট. কোডের আগে কোড সেকশনে থাকে
কার্যকরী পিপি "কাজের" জন্য সঠিক স্টোরেজ তৈরি করবে যদি এটি বিদ্যমান না থাকে। উল্লেখ্য যে আপনি
শুধুমাত্র "p" এবং "x" এর প্রথম মাত্রা নিয়েছে কারণ ব্যবহারকারী হয়তো এর সাথে পিডল পাঠিয়েছেন
অতিরিক্ত থ্রেডিং মাত্রা। অবশ্যই, অস্থায়ী পিডল "কাজ" (দ্রষ্টব্য [টি] পতাকা)
যাইহোক কোন থ্রেড মাত্রা দেওয়া উচিত নয়.

এছাড়াও আপনি [o] দিয়ে পতাকাঙ্কিত একটি পিডলের মাত্রা সেট করতে "RedoDimsCode" ব্যবহার করতে পারেন। এই
যদি আপনি $ ব্যবহার করে স্বাক্ষরে নামযুক্ত মাত্রার জন্য মাত্রা সেট করেনSIZE() হিসাবে হিসাবে
পূর্ববর্তী উদাহরণ। যাইহোক, যেহেতু পিডলটি [t] এর পরিবর্তে [o] দিয়ে পতাকাঙ্কিত,
প্রয়োজন হলে থ্রেডিং মাত্রা যোগ করা হবে ঠিক যেমন মাত্রার আকার ছিল
স্বাভাবিক নিয়ম অনুযায়ী স্বাক্ষর থেকে গণনা করা হয়। এখানে থেকে একটি উদাহরণ
PDL::গণিত

pp_def("পলিরুট",
Pars => 'cr(n); ci(n); [ও]rr(মি); [ও]ri(মি);',
RedoDimsCode => 'int sn = $PDL(cr)->dims[0]; $আকার(m) = sn-1;',

ইনপুট পিডল হল a এর জটিল সহগগুলির বাস্তব এবং কাল্পনিক অংশ
বহুপদ আউটপুট পিডলগুলি মূলের বাস্তব এবং কাল্পনিক অংশ। সেখানে নাই"
একটি "n"ম ক্রম বহুপদীর শিকড় এবং এই জাতীয় বহুপদীতে "n+1" সহগ রয়েছে (
"n"th মাধ্যমে zeoreth)। এই উদাহরণে, থ্রেডিং সঠিকভাবে কাজ করবে। অর্থাৎ, দ
আউটপুট পিডল এর ​​প্রথম ডাইমেনশন এর ডাইমেনশন অ্যাডজাস্ট করা আছে কিন্তু অন্য থ্রেডিং
মাত্রা ঠিক এমনভাবে বরাদ্দ করা হবে যেন কোনো "RedoDimsCode" না থাকে।

টাইপম্যাপ হ্যান্ডলিং in দ্য "অন্যান্য পার্স" অধ্যায়
উপরে আলোচিত "অন্যান্যপারস" বিভাগটি প্রায়শই একেবারে গুরুত্বপূর্ণ যখন আপনি
PDL এর সাথে বাহ্যিক লাইব্রেরি ইন্টারফেস। তবে অনেক ক্ষেত্রে বহিরাগত লাইব্রেরি হয়
প্রাপ্ত ধরনের বা বিভিন্ন ধরনের পয়েন্টার ব্যবহার করুন।

পার্লে এটি পরিচালনা করার আদর্শ উপায় হল একটি "টাইপম্যাপ" ফাইল ব্যবহার করা। এ নিয়ে আলোচনা করা হয়েছে
স্ট্যান্ডার্ড পার্ল ডকুমেন্টেশনে perlxs-এ কিছু বিশদ বিবরণ। পিপি-তে কার্যকারিতা খুব বেশি
অনুরূপ, যাতে আপনার পিপি ফাইলটি যে ডিরেক্টরিতে থাকে সেখানে আপনি একটি "টাইপম্যাপ" ফাইল তৈরি করতে পারেন
এবং যখন এটি নির্মিত হয় তখন উপযুক্ত অনুবাদ বের করার জন্য এটি স্বয়ংক্রিয়ভাবে পড়া হয়
সি টাইপ এবং পার্লের বিল্ট-ইন টাইপের মধ্যে।

এটি বলেছে, প্রকারের সাধারণ পরিচালনা থেকে কয়েকটি গুরুত্বপূর্ণ পার্থক্য রয়েছে
XS-এ। প্রথম, এবং সম্ভবত সবচেয়ে গুরুত্বপূর্ণ, এই মুহুর্তে ধরন নির্দেশক হয়
"অন্যান্যপারস" বিভাগে অনুমোদিত নয়। এই সীমাবদ্ধতার কাছাকাছি পেতে আপনাকে অবশ্যই ব্যবহার করতে হবে
"IV" টাইপ (এটি বহনযোগ্যতার জন্য প্রয়োজনীয় তা নির্দেশ করার জন্য জুড টেলরকে ধন্যবাদ)।

এটি সম্ভবত কয়েকটি কোড-স্নিপেট দিয়ে চিত্রিত করা ভাল:

উদাহরণস্বরূপ "gsl_spline_init" ফাংশনে নিম্নলিখিত C ঘোষণা রয়েছে:

int gsl_spline_init(gsl_spline * spline,
const double xa[], const double ya[], size_t size);

স্পষ্টতই "xa" এবং "ya" অ্যারেগুলি piddles হিসাবে পাস করার জন্য প্রার্থী এবং
"আকার" যুক্তি হল এই পিডলের দৈর্ঘ্য যাতে এটি দ্বারা পরিচালনা করা যায়
পিপিতে "$SIZE()" ম্যাক্রো। সমস্যা হল "gsl_spline" টাইপের পয়েন্টার। প্রাকৃতিক
সমাধান হল ফর্মের একটি "অন্যান্যপারস" ঘোষণা লিখতে হবে

অন্যান্য পার্স => 'gsl_spline *spl'

এবং একটি ছোট "টাইপম্যাপ" ফাইল লিখুন যা এই ধরনের পরিচালনা করে। এটি বর্তমানে কাজ করে না
যাহোক! তাই আপনাকে যা করতে হবে তা হল সমস্যাটি সামান্য (এবং কিছু উপায়ে) কাছাকাছি যেতে হবে
এটিও সহজ!):

সমাধান হল "Integer Value" ব্যবহার করে "OtherPars" বিভাগে "spline" ঘোষণা করা।
"IV"। এটি PP থেকে ভেরিয়েবলের প্রকৃতি লুকিয়ে রাখে এবং তারপরে আপনাকে (এড়াতে ভাল
কম্পাইলার সতর্কতা কমপক্ষে!) আপনি যখন আপনার কোডে ভেরিয়েবল ব্যবহার করেন তখন একটি টাইপ কাস্ট করুন।
এইভাবে "অন্যান্যপারস" ফর্মটি গ্রহণ করা উচিত:

অন্যান্য পার্স => 'IV spl'

এবং যখন আপনি এটি কোডে ব্যবহার করবেন তখন আপনি লিখবেন

INT2PTR(gsl_spline *, $COMP(spl))

যেখানে পার্ল এপিআই ম্যাক্রো "INT2PTR" এড়ানোর জন্য পয়েন্টার কাস্ট পরিচালনা করতে ব্যবহার করা হয়েছে
মিশ্র 32 বিট এবং 64 বিট পার্ল সহ মেশিনগুলির জন্য কম্পাইলার সতর্কতা এবং সমস্যা
কনফিগারেশন আন্দ্রেস জর্ডান যেভাবে করেছেন (পরিবর্তন সহ
জুড টেলরের "IV" ব্যবহার করে) "gsl_interp.pd"-এ আপনি যে বিতরণ উত্সটি পান:

pp_def('init_meat',
পার্স => 'ডাবল x(n); ডবল y(n);',
অন্যান্য পার্স => 'IV spl',
কোড =>'
gsl_spline_init,( INT2PTR(gsl_spline *, $COMP(spl)), $P(x),$P(y),$SIZE(n)));'
);

যেখানে আমি একটি ম্যাক্রো র্যাপার কল মুছে ফেলেছি, কিন্তু এটি আলোচনাকে অস্পষ্ট করবে।

পার্লে স্ট্যান্ডার্ড টাইপম্যাপ পরিচালনার তুলনায় অন্যান্য ছোটখাটো পার্থক্য হল
ব্যবহারকারী অ-মানক টাইপম্যাপ অবস্থান বা টাইপম্যাপ ফাইলের নাম ব্যবহার করে নির্দিষ্ট করতে পারে না
MakeMaker-এ "TYPEMAPS" বিকল্প... এইভাবে আপনি শুধুমাত্র "টাইপম্যাপ" নামে একটি ফাইল ব্যবহার করতে পারেন এবং/অথবা
উপরে "IV" কৌশল।

অন্যান্য দরকারী PP কী in উপাত্ত অপারেশন সংজ্ঞা
আপনি ইতিমধ্যে "OtherPars" কী সম্পর্কে শুনেছেন। বর্তমানে, অন্য অনেক কী নেই
একটি ডেটা অপারেশনের জন্য যা সাধারণ (যাই হোক না কেন) পিপি প্রোগ্রামিং-এ কার্যকর হবে। ভিতরে
আসলে, এমন একটি কেস সম্পর্কে শুনতে আকর্ষণীয় হবে যেখানে আপনি মনে করেন যে আপনার কিসের চেয়ে বেশি প্রয়োজন
এই মুহূর্তে প্রদান করা হয়. অনুগ্রহ করে PDL মেলিং তালিকার একটিতে কথা বলুন। অধিকাংশ অন্যান্য
"pp_def" দ্বারা স্বীকৃত কীগুলি কেবলমাত্র আমরা যাকে কল করি তার জন্যই কার্যকর ফালি অপারেশন (দেখুন
এছাড়াও উপরে)।

একটি জিনিস যা দৃঢ়ভাবে পরিকল্পনা করা হচ্ছে তা হল পরিবর্তনশীল সংখ্যার আর্গুমেন্ট, যা হবে একটি
সামান্য চতুর

উপলব্ধ কীগুলির একটি অসম্পূর্ণ তালিকা:

জায়গায়
এই কী সেট করা রুটিনকে কাজের ইনপ্লেস হিসাবে চিহ্নিত করে - যেমন ইনপুট এবং আউটপুট
piddles একই. একটি উদাহরণ হল "$a->inplace->sqrt()" (বা "sqrt(inplace($a))")।

ইনপ্লেস => ১
যখন রুটিন একটি unary ফাংশন হয়, যেমন "sqrt" ব্যবহার করুন।

ইনপ্লেস => ['a']
যদি একাধিক ইনপুট পিডল থাকে তবে যেটি হতে পারে তার নাম উল্লেখ করুন
একটি অ্যারে রেফারেন্স ব্যবহার করে ইনপ্লেস পরিবর্তন করা হয়েছে।

ইনপ্লেস => ['a', 'b']
যদি একাধিক আউটপুট পিডল থাকে, তাহলে ইনপুট পিডলের নাম উল্লেখ করুন এবং
একটি 2-এলিমেন্ট অ্যারে রেফারেন্সে আউটপুট পিডল। এটি সম্ভবত প্রয়োজন নেই, কিন্তু বাকি
সম্পূর্ণতার জন্য

যদি খারাপ মান ব্যবহার করা হয়, তবে এর প্রচার নিশ্চিত করার জন্য যত্ন নেওয়া আবশ্যক
যখন ইনপ্লেস ব্যবহার করা হচ্ছে তখন ব্যাডফ্ল্যাগ; থেকে এই উদ্ধৃতি বিবেচনা করুন মৌলিক/খারাপ/খারাপ.pd:

pp_def('replacebad',HandleBad => 1,
পার্স => 'a(); [ও]বি();',
OtherPars => 'ডাবল নিউভাল',
ইনপ্লেস => 1,
CopyBadStatusCode =>
'/* স্থানান্তরিত হলে ব্যাডফ্ল্যাগ প্রচার করুন এবং এটি পরিবর্তিত হয়েছে */
যদি ( a == b && $ISPDLSTATEBAD(a) )
PDL->propogate_badflag( b, 0);

/* সর্বদা নিশ্চিত করুন যে আউটপুট "ভাল" */
$SETPDLSTATEGOOD(b);
',
...

যেহেতু এই রুটিনটি সমস্ত খারাপ মানগুলিকে সরিয়ে দেয়, তাই আউটপুট পিডলের খারাপ পতাকা ছিল
সাফ যদি অভ্যন্তরে চালানো হয় (তাই "a == b"), তাহলে আমাদের "a" এর সমস্ত বাচ্চাদের বলতে হবে
যে খারাপ পতাকা সাফ করা হয়েছে (সময় বাঁচাতে আমরা নিশ্চিত করি যে আমরা কল করি
"PDL->propogate_badgflag" শুধুমাত্র যদি ইনপুট পিডল এর ​​খারাপ পতাকা সেট থাকে)।

দ্রষ্টব্য: একটি ধারণা হল যে রুটিনের জন্য ডকুমেন্টেশন স্বয়ংক্রিয়ভাবে হতে পারে
পতাকাঙ্কিত নির্দেশিত যে এটি ইনপ্লেস কার্যকর করা যেতে পারে, যেমন কিছু অনুরূপ কিভাবে
"HandleBad" "BadDoc" সেট করে যদি এটি সরবরাহ না করা হয় (এটি একটি আদর্শ সমাধান নয়)।

অন্যান্য পিডিএল::পিপি ক্রিয়াকলাপ থেকে সমর্থন সংক্ষিপ্ত প্যাকেজ সংজ্ঞা
এখন পর্যন্ত, আমরা "pp_def" এবং "pp_done" ফাংশন বর্ণনা করেছি। PDL::PP কিছু রপ্তানি করে
সংক্ষিপ্ত PDL এক্সটেনশন প্যাকেজ সংজ্ঞা লিখতে সাহায্য করার জন্য অন্যান্য ফাংশন।

pp_addhdr

প্রায়শই যখন আপনি উপরের উদাহরণের মতো লাইব্রেরি ফাংশন ইন্টারফেস করেন তখন আপনাকে অন্তর্ভুক্ত করতে হবে
অতিরিক্ত সি ফাইল অন্তর্ভুক্ত. যেহেতু XS ফাইলটি PP দ্বারা তৈরি করা হয়েছে আমাদের কিছু উপায় প্রয়োজন
উত্পন্ন XS-এ সঠিক স্থানে যথাযথ নির্দেশাবলী অন্তর্ভুক্ত করে PP সন্নিবেশ করান
ফাইল এই লক্ষ্যে "pp_addhdr" ফাংশন আছে। এটিও ব্যবহার করার ফাংশন
যখন আপনি কিছু XS ফাংশন দ্বারা অভ্যন্তরীণ ব্যবহারের জন্য কিছু C ফাংশন সংজ্ঞায়িত করতে চান
(যা বেশিরভাগ ফাংশন "pp_def" দ্বারা সংজ্ঞায়িত)। এখানে এই ফাংশন অন্তর্ভুক্ত করে আপনি
নিশ্চিত করুন যে PDL::PP প্রকৃত XS মডিউলের বিন্দুর আগে আপনার কোড সন্নিবেশ করাচ্ছে
বিভাগ শুরু হয় এবং তাই xsubpp (cf. perlxs এবং perlxstut
ম্যান পেজ)।

একটি সাধারণ কল হবে

pp_addhdr('
#অন্তর্ভুক্ত /* আমাদের XXXX এর ডিফ দরকার */
#include "libprotos.h" /* লাইব্রেরি ফাংশনের প্রোটোটাইপ */
#ইনক্লুড "mylocaldecs.h" /* Local decs */

স্ট্যাটিক ভ্যাইড ডু_দ্য রিয়েল_ওয়ার্ক(PDL_Byte * in, PDL_Byte * আউট, int n)
{
/* ডেটা দিয়ে কিছু গণনা করুন */
}
');

এটি নিশ্চিত করে যে আপনার প্রয়োজনীয় সমস্ত ধ্রুবক এবং প্রোটোটাইপগুলি সঠিকভাবে অন্তর্ভুক্ত করা হবে এবং
যে আপনি এখানে "pp_def" তে সংজ্ঞায়িত অভ্যন্তরীণ ফাংশনগুলি ব্যবহার করতে পারেন, যেমন:

pp_def('বারফু',
পার্স => 'a(n); [o] b(n)',
জেনেরিক টাইপস => ['বি'],
কোড => 'int ns = $SIZE(n);
do_the_real_work($P(a),$P(b),ns);
',
);

pp_addpm

অনেক ক্ষেত্রে প্রকৃত PP কোড (অর্থাৎ "pp_def" কলের আর্গুমেন্ট) শুধুমাত্র এর অংশ
আপনি বর্তমানে যে প্যাকেজটি বাস্তবায়ন করছেন। প্রায়ই অতিরিক্ত পার্ল কোড এবং XS আছে
কোডটি আপনি সাধারণত pm এবং XS ফাইলগুলিতে লিখতেন যা এখন স্বয়ংক্রিয়ভাবে হয়
পিপি দ্বারা উত্পন্ন। তাই কিভাবে যারা গতিশীলভাবে উত্পন্ন ফাইল মধ্যে এই জিনিস পেতে?
সৌভাগ্যবশত, কিছু ফাংশন আছে, যাকে সাধারণত "pp_addXXX" বলা হয় যা আপনাকে সহায়তা করে
এটা করার মধ্যে

ধরুন আপনার কাছে অতিরিক্ত পার্ল কোড আছে যা জেনারেট হওয়া উচিত pm- ফাইল। এই
"pp_addpm" কমান্ড দিয়ে সহজেই অর্জন করা হয়:

pp_addpm(<<'EOD');

= head1 NAME

PDL::Lib::Mylib -- Mylib লাইব্রেরির একটি PDL ইন্টারফেস

=head1 বর্ণনা

এই প্যাকেজটি সম্পূর্ণ সহ Mylib প্যাকেজের একটি ইন্টারফেস প্রয়োগ করে
থ্রেডিং এবং ইন্ডেক্সিং সমর্থন (এল )

= কাটা

PGPLOT ব্যবহার করুন;

=head2 use_myfunc
এই ফাংশনটি সমস্ত ক্ষেত্রে myfunc অপারেশন প্রযোজ্য
ইনপুট pdl-এর উপাদানগুলি মাত্রা নির্বিশেষে
এবং ফলাফলের যোগফল প্রদান করে
= কাটা

সাব use_myfunc {
আমার $pdl = শিফট;

myfunc($pdl->ক্লাম্প(-1),($res=null));

$res->সমষ্টি ফেরত দিন;
}

ইওডি

pp_add_exported

আপনি সম্ভবত ধারণা পেয়েছেন. কিছু ক্ষেত্রে আপনি আপনার অতিরিক্ত রপ্তানি করতে চান
ফাংশন PP এর সাথে ঝামেলা এড়াতে যা @EXPORT এর সাথেও গোলমাল করে
অ্যারে আপনি শুধু PP কে বলবেন আপনার ফাংশন এক্সপোর্ট করা ফাংশনের তালিকায় যোগ করতে:

pp_add_exported('use_myfunc gethynx');

pp_add_isa

"pp_add_isa" কমান্ডটি "pp_add_exported" ফাংশনের মতো কাজ করে। যুক্তি
@ISA তালিকায় "pp_add_isa" যোগ করা হয়েছে, যেমন

pp_add_isa('কিছু::অন্যান্য::শ্রেণী');

pp_bless

যদি আপনার pp_def রুটিনগুলি অবজেক্ট পদ্ধতি হিসাবে ব্যবহার করা হয় তবে নির্দিষ্ট করতে "pp_bless" ব্যবহার করুন
প্যাকেজ (অর্থাৎ ক্লাস) যা আপনার pp_defed পদ্ধতি যোগ করা হবে। উদাহরণ স্বরূপ,
"pp_bless('PDL::MyClass')"। এটি বাদ দিলে ডিফল্ট "PDL" হয়।

pp_addxs

কখনও কখনও আপনি আপনার নিজের অতিরিক্ত XS কোড যোগ করতে চান (যা সাধারণত এর সাথে জড়িত নয়
কোনো থ্রেডিং/ইনডেক্সিং সমস্যা কিন্তু আপনি অ্যাক্সেস করতে চান এমন কিছু অন্যান্য কার্যকারিতা সরবরাহ করে
পার্ল পাশ থেকে) জেনারেট করা XS ফাইলে, উদাহরণস্বরূপ

pp_addxs('','

# মেশিনের অন্তিমতা নির্ধারণ করুন

কোন int
ইসবিজেন্ডিয়ান()
কোড:
স্বাক্ষরবিহীন সংক্ষিপ্ত i;
PDL_Byte *b;

i = 42; b = (PDL_Byte*) (void*) &i;

যদি (*b == 42)
RETVAL = 0;
অন্যথায় যদি (*(b+1) == 42)
RETVAL = 1;
আর
croak("অসম্ভব - মেশিনটি বড় বা ছোট এন্ডিয়ান নয়!!\n");
আউটপুট:
RETVAL
');

বিশেষ করে "pp_add_exported" এবং "pp_addxs" যত্ন সহকারে ব্যবহার করা উচিত। পিপি ব্যবহার করে
PDL:: রপ্তানিকারক, তাই পিপিকে আপনার ফাংশন রপ্তানি করতে দেওয়ার অর্থ হল যে তারা এতে যুক্ত হবে
ডিফল্টভাবে এক্সপোর্ট করা ফাংশনের স্ট্যান্ডার্ড তালিকা (রপ্তানি ট্যাগ দ্বারা সংজ্ঞায়িত তালিকা
``:ফাঙ্ক'')। আপনি যদি "pp_addxs" ব্যবহার করেন তবে আপনার থ্রেডিং জড়িত এমন কিছু করার চেষ্টা করা উচিত নয়
অথবা সরাসরি ইন্ডেক্সিং। আপনার থেকে উপযুক্ত কোড জেনারেট করার ক্ষেত্রে পিপি অনেক ভালো
সংজ্ঞা

pp_add_boot

অবশেষে, আপনি XS ফাইলের বুট বিভাগে কিছু কোড যোগ করতে চাইতে পারেন (যদি আপনি না করেন
চেক কি জানি perlxs) এটি "pp_add_boot" কমান্ড দিয়ে সহজেই করা হয়:

pp_add_boot(<
descrip = mylib_initialize(KEEP_OPEN);

যদি (বর্ণনা == NULL)
croak("লাইব্রেরি আরম্ভ করা যাবে না");

GlobalStruc->descrip = descrip;
GlobalStruc->maxfiles = 200;
ইওবি

pp_export_nothing

ডিফল্টরূপে, PP.pm আউটপুট .pm-এ pp_def ফাংশন ব্যবহার করে সংজ্ঞায়িত সমস্ত সাবস রাখে
ফাইলের রপ্তানি তালিকা। যদি আপনি একটি সাবক্লাসড অবজেক্ট তৈরি করেন যেখানে এটি সমস্যা তৈরি করতে পারে
আপনি কোন পদ্ধতি রপ্তানি করতে চান না. (অর্থাৎ পদ্ধতি শুধুমাত্র ব্যবহার করে বলা হবে
$object->পদ্ধতি সিনট্যাক্স)।

এই ক্ষেত্রে আপনি কল করতে পারেন pp_export_nothing() রপ্তানি তালিকা পরিষ্কার করতে। উদাহরণ (এ
.pd ফাইলের শেষে):

pp_export_nothing();
pp_done();

pp_core_importList

ডিফল্টরূপে, PP.pm 'ব্যবহার কোর' রাখে; আউটপুট .pm ফাইলে লাইন করুন। এটি কোর আমদানি করে
বর্তমান নামস্থানে রপ্তানি করা নাম, যা সমস্যা তৈরি করতে পারে যদি আপনি বেশি হন-
বর্তমান ফাইলে কোরের একটি পদ্ধতিতে রাইড করা। আপনি মত বার্তা পেয়ে শেষ
"সতর্কতা: সাব sumover ফাইল subclass.pm-এ পুনরায় সংজ্ঞায়িত করা হয়েছে" যখন প্রোগ্রাম চালানো হয়।

এই ক্ষেত্রে pp_core_importList যা থেকে আমদানি করা হয়েছে তা পরিবর্তন করতে ব্যবহার করা যেতে পারে
কোর.pm. উদাহরণ স্বরূপ:

pp_core_importList('()')

এর ফলে হবে

Core();

আউটপুট .pm ফাইলে তৈরি করা হচ্ছে। এর ফলে কোনো নাম আমদানি করা হবে না
কোর.pm. একইভাবে, কলিং

pp_core_importList('qw/ barf/')

ফলাফল হবে

Core qw/ barf/ ব্যবহার করুন;

আউটপুট .pm ফাইলে তৈরি করা হচ্ছে। এর ফলে শুধু 'বারফ' আমদানি করা হবে
Core.pm থেকে।

pp_setversion

আমি নিশ্চিত যে এটি আপনাকে একই সাথে .pm এবং .xs ফাইল সেট করতে দেয়
সংস্করণ, এইভাবে উভয়ের মধ্যে অপ্রয়োজনীয় সংস্করণ-তিরস্কার এড়ানো। এটি ব্যবহার করার জন্য, সহজভাবে আছে
আপনার .pd ফাইলের এক পর্যায়ে নিম্নলিখিত লাইনটি:

pp_setversion('0.0.3');

যাইহোক, আপনি যদি মডিউল::বিল্ড::পিডিএল ব্যবহার করেন তবে এটি ব্যবহার করবেন না। জন্য যে মডিউল এর ডকুমেন্টেশন দেখুন
বিবরণ।

pp_deprecate_module

যদি একটি নির্দিষ্ট মডিউল অপ্রচলিত বলে মনে করা হয়, এই ফাংশনটি এটি হিসাবে চিহ্নিত করতে ব্যবহার করা যেতে পারে
অবমূল্যায়ন এটি একটি সতর্কতা নির্গত করার প্রভাব আছে যখন একজন ব্যবহারকারী "ব্যবহার" করার চেষ্টা করে
মডিউল এই মডিউলের জন্য তৈরি করা POD একটি অবচয় বিজ্ঞপ্তিও বহন করে। দ্য
প্রতিস্থাপন মডিউল এই মত একটি যুক্তি হিসাবে পাস করা যেতে পারে:

pp_deprecate_module( infavor => "PDL::NewNonDeprecatedModule");

লক্ষ্য করুন যে ফাংশন প্রভাবিত করে কেবল রানটাইম সতর্কতা এবং POD.

মেকিং তোমার PP ক্রিয়া "ব্যক্তিগত"

ধরা যাক আপনার মডিউলে PDL::foo নামক একটি ফাংশন আছে যা পিপি ব্যবহার করে
ভারী উত্তোলন করতে "bar_pp" ফাংশন। কিন্তু আপনি "bar_pp" এর বিজ্ঞাপন দিতে চান না
বিদ্যমান এটি করার জন্য, আপনাকে অবশ্যই আপনার পিপি ফাংশনটি আপনার মডিউল ফাইলের শীর্ষে নিয়ে যেতে হবে
কল

pp_export_nothing()

"রপ্তানি" তালিকা সাফ করতে। কোন ডকুমেন্টেশন (এমনকি ডিফল্ট পিপি ডক্স) তা নিশ্চিত করতে
উৎপন্ন, সেট

ডক => undef

এবং প্রতীক টেবিলে ফাংশন যোগ করা থেকে প্রতিরোধ করতে, সেট করুন

PMFunc => ''

আপনার pp_def ঘোষণায় (একটি উদাহরণের জন্য Image2D.pd দেখুন)। এটি কার্যকরভাবে তৈরি করবে
আপনার পিপি ফাংশন "ব্যক্তিগত।" যাইহোক, এটা হয় সর্বদা পার্লের কারণে PDL::bar_pp এর মাধ্যমে অ্যাক্সেসযোগ্য
মডিউল নকশা। কিন্তু এটিকে ব্যক্তিগত করলে ব্যবহারকারী তার থেকে অনেক দূরে চলে যাবে
এটি ব্যবহার করার উপায়, তাই তার কাঁধে পরিণতি!

ফালি অপারেশন

এই ম্যানুয়ালটির স্লাইস অপারেশন বিভাগটি ডেটাফ্লো এবং অলস মূল্যায়ন ব্যবহার করে সরবরাহ করা হয়েছে:
যখন আপনার প্রয়োজন হয়, Tjl কে এটি লিখতে বলুন। আমি ইমেল পাওয়ার পর থেকে এক সপ্তাহের মধ্যে একটি ডেলিভারি
95% সম্ভাব্য এবং দুই সপ্তাহের ডেলিভারি 99% সম্ভাব্য।

এবং যাইহোক, স্লাইস ক্রিয়াকলাপগুলির জন্য পিডিএল অভ্যন্তরীণ সম্পর্কে অনেক বেশি ঘনিষ্ঠ জ্ঞান প্রয়োজন
ডেটা অপারেশনের চেয়ে। তদুপরি, জটিলতা জড়িত সমস্যা
গড় ডেটা অপারেশনের তুলনায় যথেষ্ট বেশি। আপনি যদি বোঝাতে চান
নিজেকে এই বাস্তবতা কটাক্ষপাত মৌলিক/Slices/slices.pd পিডিএলে ফাইল করুন
বিতরণ :-) তবুও, স্লাইস অপারেশন ব্যবহার করে উত্পন্ন ফাংশন আছে
PDL-এর সূচক ম্যানিপুলেশন এবং ডেটাফ্লো ক্ষমতার হৃদয়।

এছাড়াও, ভার্চুয়াল পিডলস এবং ভ্যাফিনগুলির সাথে অনেক নোংরা সমস্যা রয়েছে যা আমরা করব
সম্পূর্ণভাবে এখানে এড়িয়ে যান।

স্লাইস এবং পায়খানা মূল্যবোধ
স্লাইস অপারেশনগুলি খারাপ মানগুলি পরিচালনা করতে সক্ষম হওয়া দরকার (যদি সমর্থন PDL এ কম্পাইল করা হয়)।
সবচেয়ে সহজ কাজ হল তাকান মৌলিক/Slices/slices.pd এই কাজ কিভাবে দেখতে.

"BadCode" এর পাশাপাশি "BadBackCode" এবং "BadRedoDimsCode" কী আছে
"pp_def"। যাইহোক, যেকোনো "EquivCPOffsCode" উচিত না পরিবর্তন প্রয়োজন, যেহেতু কোনো পরিবর্তন হয়
"$EQUIVCPOFFS()" ম্যাক্রোর সংজ্ঞার মধ্যে শোষিত (অর্থাৎ এটি পরিচালনা করা হয়
স্বয়ংক্রিয়ভাবে PDL::PP> দ্বারা।

A কয়েক নোট on লেখা a slicing রুটিন...
নিম্নলিখিত কয়েকটি অনুচ্ছেদ একটি নতুন স্লাইসিং রুটিন ('রেঞ্জ') লেখার বর্ণনা দেয়; যেকোনো
ত্রুটিগুলি CED এর। (--CED 26-Aug-2002)

হ্যান্ডলিং of "সতর্ক" এবং "বারফ" in PP কোড

সতর্কতামূলক বার্তা প্রিন্ট করার জন্য বা বাতিল/মৃত্যুর জন্য, আপনি পিপি থেকে "সতর্ক" বা "বারফ" কল করতে পারেন
কোড যাইহোক, আপনার সচেতন হওয়া উচিত যে এই কলগুলি সি ব্যবহার করে পুনরায় সংজ্ঞায়িত করা হয়েছে
প্রিপ্রসেসর ম্যাক্রো থেকে "PDL->barf" এবং "PDL->সতর্ক"। এই পুনঃসংজ্ঞা জায়গায় আছে
আপনাকে অসাবধানতাবশত পার্লের "সতর্কতা" বা "বারফ" কে সরাসরি কল করা থেকে বিরত রাখে, যা হতে পারে
pthreading এর সময় segfaults (যেমন প্রসেসর মাল্টি-থ্রেডিং)।

পিডিএল-এর নিজস্ব সংস্করণ "বারফ" এবং "সতর্কতা" এর পর পর্যন্ত সতর্কতা বা বারফ বার্তাগুলি সারিবদ্ধ করবে
pthreading সম্পন্ন হয়েছে, এবং তারপর এই রুটিনগুলির পার্ল সংস্করণগুলিকে কল করুন।

pthreading সম্পর্কে আরও তথ্যের জন্য PDL::ParallelCPU দেখুন।

দরকারী রুটিন

পিডিএল "কোর" গঠন, সংজ্ঞায়িত করা হয়েছে বেসিক/কোর/pdlcore.h.PL, একটি পয়েন্টার রয়েছে
আপনার কাজে লাগতে পারে এমন রুটিনের সংখ্যা। এই রুটিন সংখ্যাগরিষ্ঠ সঙ্গে মোকাবিলা
পিডলগুলিকে হেরফের করা, তবে কিছু আরও সাধারণ:

PDL->qsort_B( PDL_Byte *xx, int a, int b)
"এ" এবং "বি" সূচকগুলির মধ্যে অ্যারে "xx" সাজান। এর জন্য সংস্করণও রয়েছে
পোস্টফিক্স "_S", "_U", "_L", "_F", এবং "_D" সহ অন্যান্য PDL ডেটাটাইপ। কোন মডিউল ব্যবহার করে
এটি নিশ্চিত করতে হবে যে "PDL::Ufunc" লোড হয়েছে।

PDL->qsort_ind_B( PDL_Byte *xx, int *ix, int a, int b)
"PDL->qsort_B" এর জন্য, কিন্তু এবার ডেটার পরিবর্তে সূচকগুলি সাজানো হচ্ছে।

রুটিন "med2d" ইন Lib/Image2D/image2d.pd দেখায় কিভাবে এই ধরনের রুটিন ব্যবহার করা হয়।

মেকফাইলস জন্য PP নথি পত্র

আপনি যদি আপনার পিপি ফাইল থেকে একটি প্যাকেজ তৈরি করতে যাচ্ছেন (সাধারণ ফাইল এক্সটেনশনগুলি হল
পিপি কোড ধারণকারী ফাইলগুলির জন্য ".pd" বা ".pp") এটি ছেড়ে যাওয়া সবচেয়ে সহজ এবং নিরাপদ
মেকফাইলে যথাযথ কমান্ড তৈরি করা। নিম্নলিখিত আমরা রূপরেখা হবে
স্বয়ংক্রিয়ভাবে আপনার প্যাকেজ তৈরি এবং ইনস্টল করার জন্য একটি পার্ল মেকফাইলের সাধারণ বিন্যাস
একটি পিপি ফাইলে একটি বিবরণ। বেশির ভাগ নিয়মে xs, pm এবং অন্যান্য প্রয়োজনীয় ফাইল তৈরি করতে হয়
PP ফাইল থেকে PDL::Core::Dev প্যাকেজে ইতিমধ্যেই পূর্বনির্ধারিত। আমরা শুধু আছে
মেকমেকারকে এটি ব্যবহার করতে বলুন।

বেশিরভাগ ক্ষেত্রে আপনি আপনার Makefile এর মত সংজ্ঞায়িত করতে পারেন

# Makefile.PL PP কোড দ্বারা সংজ্ঞায়িত একটি প্যাকেজের জন্য।

PDL::Core::Dev ব্যবহার করুন; # ডেভেলপমেন্ট ইউটিলিটি তুলে নিন
ExtUtils::MakeMaker ব্যবহার করুন;

$package = ["mylib.pd", Mylib,PDL::Lib::Mylib];
%হ্যাশ = pdlpp_stdargs($package);
$হ্যাশ{OBJECT} .= 'অতিরিক্ত_Ccode$(OBJ_EXT)';
$hash{clean}->{FILES} .= 'todelete_Ccode$(OBJ_EXT)';
$hash{'VERSION_FROM'} = 'mylib.pd';
WriteMakefile(% হ্যাশ);

sub MY::postamble { pdlpp_postamble($package); }

এখানে, $package-এর তালিকা হল: প্রথমে: PP সোর্স ফাইলের নাম, তারপর এর উপসর্গ
উত্পাদিত ফাইল এবং অবশেষে পুরো প্যাকেজের নাম। আপনি যাই হোক না কেন হ্যাশ পরিবর্তন করতে পারেন
আপনার পছন্দ মতো কিন্তু কিছু সীমার মধ্যে থাকা যুক্তিসঙ্গত হবে যাতে আপনার প্যাকেজ
PDL এর পরবর্তী সংস্করণগুলির সাথে কাজ করা চালিয়ে যাবে।

আপনি প্রিপ্যাকেজড আর্গুমেন্ট ব্যবহার করতে না চাইলে, এখানে একটি জেনেরিক আছে Makefile.PL যেটা তুমি পারো
আপনার নিজের প্রয়োজনের জন্য মানিয়ে নিন:

# Makefile.PL PP কোড দ্বারা সংজ্ঞায়িত একটি প্যাকেজের জন্য।

PDL::Core::Dev ব্যবহার করুন; # ডেভেলপমেন্ট ইউটিলিটি তুলে নিন
ExtUtils::MakeMaker ব্যবহার করুন;

লিখুন মেকফাইল(
'NAME' => 'PDL::Lib::Mylib',
'VERSION_FROM' => 'mylib.pd',
'TYPEMAPS' => [&PDL_TYPEMAP()],
'OBJECT' => 'mylib$(OBJ_EXT) অতিরিক্ত_Ccode$(OBJ_EXT)',
'PM' => { 'Mylib.pm' => '$(INST_LIBDIR)/Mylib.pm'},
'INC' => &PDL_INCLUDE(), # আপনার lib দ্বারা প্রয়োজন অনুযায়ী dirs যোগ করুন
'LIBS' => [''], # প্রয়োজনে লিঙ্ক নির্দেশিকা যোগ করুন
'ক্লিন' => {'ফাইল' =>
'Mylib.pm Mylib.xs Mylib$(OBJ_EXT)
অতিরিক্ত_Ccode$(OBJ_EXT)'},
);

# genpp নিয়ম যোগ করুন; এটি আমাদের পিপি ফাইলে PDL::PP আহ্বান করবে
# আর্গুমেন্ট হল একটি অ্যারের রেফারেন্স যেখানে অ্যারের তিনটি স্ট্রিং উপাদান রয়েছে:
# arg1: সোর্স ফাইলের নাম যেখানে পিপি কোড রয়েছে
# arg2: xs এবং pm ফাইলের বেসনেম তৈরি করা হবে
# arg3: প্যাকেজের নাম যা তৈরি করা হবে
sub MY::postamble { pdlpp_postamble(["mylib.pd",Mylib,PDL::Lib::Mylib]); }

জীবনকে আরও সহজ করতে PDL::Core::Dev ফাংশন "pdlpp_stdargs" সংজ্ঞায়িত করে যা রিটার্ন করে
ডিফল্ট মান সহ একটি হ্যাশ যা পাস করা যেতে পারে (হয় সরাসরি বা উপযুক্ত পরে
পরিবর্তন) WriteMakefile-এ একটি কল করতে। বর্তমানে, "pdlpp_stdargs" যেখানে একটি হ্যাশ প্রদান করে
কীগুলি নিম্নরূপ পূরণ করা হয়:

(
'NAME' => $mod,
'TYPEMAPS' => [&PDL_TYPEMAP()],
'OBJECT' => "$pref\$(OBJ_EXT)",
PM => {"$pref.pm" => "\$(INST_LIBDIR)/$pref.pm"},
MAN3PODS => {"$src" => "\$(INST_MAN3DIR)/$mod.\$(MAN3EXT)"},
'INC' => &PDL_INCLUDE(),
'LIBS' => [''],
'clean' => {'FILES' => "$pref.xs $pref.pm $pref\$(OBJ_EXT)"},
)

এখানে, $src হল পিপি কোড সহ সোর্স ফাইলের নাম, $pref উৎপন্নের উপসর্গ
.pm এবং .xs ফাইল এবং $mod উৎপন্ন করার জন্য এক্সটেনশন মডিউলের নাম।

অভ্যন্তরীণ

বর্তমান সংস্করণের অভ্যন্তরীণগুলি একটি বড় টেবিল নিয়ে গঠিত যা নিয়মগুলি দেয়৷
যা অনুসারে জিনিসগুলি অনুবাদ করা হয় এবং সাবগুলি যা এই নিয়মগুলি প্রয়োগ করে৷

পরবর্তীতে, ব্যবহারকারীর দ্বারা টেবিলটিকে পরিবর্তনযোগ্য করে তোলা ভালো হবে যাতে ভিন্ন হয়
জিনিস চেষ্টা করা যেতে পারে.

[মেটা মন্তব্য: এখানে আশা করি ভবিষ্যতে আরো হবে; বর্তমানে, আপনার সেরা বাজি হবে
সোর্স কোড পড়তে :-( অথবা তালিকায় জিজ্ঞাসা করুন (পরেরটি প্রথমে চেষ্টা করুন) ]

উপাঙ্গ A: কিছু কী স্বীকৃত by পিডিএল::পিপি

অন্যথায় নির্দিষ্ট করা না থাকলে, আর্গুমেন্টগুলি স্ট্রিং। (খারাপ) দিয়ে চিহ্নিত কীগুলি শুধুমাত্র
ব্যাড-ভ্যালু সমর্থন PDL এ কম্পাইল করা হলে ব্যবহার করা হয়।

অংশ
আপনার ফাংশনের স্বাক্ষর সংজ্ঞায়িত করুন

অন্যান্য পার্স
আর্গুমেন্ট যা pdls নয়। ডিফল্ট: কিছুই না। এটি একটি সেমি-কোলন আলাদা করা তালিকা
আর্গুমেন্ট, যেমন, "OtherPars=>'int k; দ্বিগুণ মান; char* fd'"। $COMP(x) এবং এছাড়াও দেখুন
পরিশিষ্ট বি-তে একই এন্ট্রি।

কোড
কার্যকারিতা বাস্তবায়নকারী প্রকৃত কোড; বেশ কিছু পিপি ম্যাক্রো এবং পিপি ফাংশন
স্ট্রিং মান স্বীকৃত হয়

হ্যান্ডেলব্যাড (খারাপ)
যদি 1 তে সেট করা হয়, রুটিনটি খারাপ মান এবং ব্যাডকোডের কোড সমর্থন করে বলে ধরে নেওয়া হয়
খারাপ মান উপস্থিত থাকলে কী ব্যবহার করা হয়; এটি জিনিসগুলিও সেট আপ করে যাতে "$ISBAD()"
ইত্যাদি ম্যাক্রো ব্যবহার করা যেতে পারে। যদি 0 তে সেট করা হয়, তাহলে রুটিনকে একটি সতর্কতা প্রিন্ট করতে দিন
ইনপুট piddles তাদের খারাপ পতাকা সেট আছে.

ব্যাডকোড (খারাপ)
ইনপুট পিডলে খারাপ মান উপস্থিত থাকলে ব্যবহার করার জন্য কোডটি দিন। শুধুমাত্র ব্যবহার করা হয়
যদি "HandleBad => 1"।

জেনেরিক প্রকার
একটি অ্যারে রেফারেন্স। অ্যারেতে এক-অক্ষর স্ট্রিং `B' এর যেকোনো উপসেট থাকতে পারে,
`S', `U', `L', `Q', `F' এবং `D', যা আপনার অপারেশন কোন ধরনের গ্রহণ করবে তা নির্দিষ্ট করে।
প্রতিটি প্রকারের অর্থ হল:

B - স্বাক্ষরিত বাইট (অর্থাৎ স্বাক্ষরিত চর)
S - সংক্ষিপ্ত স্বাক্ষর (দুই-বাইট পূর্ণসংখ্যা)
U - স্বাক্ষরবিহীন ছোট
L - স্বাক্ষরিত দীর্ঘ (চার-বাইট পূর্ণসংখ্যা, 32 বিট সিস্টেমে int)
Q - স্বাক্ষরিত লম্বা লম্বা (আট বাইট পূর্ণসংখ্যা)
F - float
ডি - ডবল

একটি বহিরাগত লাইব্রেরি ইন্টারফেস করার সময় এটি খুব দরকারী (এবং গুরুত্বপূর্ণ!) ডিফল্ট:
[qw/BSULQFD/]

জায়গায়
ইনপ্লেসে কাজ করতে সক্ষম হিসাবে একটি ফাংশন চিহ্নিত করুন।

ইনপ্লেস => 1 যদি Pars => 'a(); [o]b();'
ইনপ্লেস => ['a'] যদি Pars => 'a(); b(); [o]c();'
ইনপ্লেস => ['a', 'b'] যদি Pars => 'a(); b(); [ও] গ(); [o]d();'

যদি খারাপ মান ব্যবহার করা হয়, তবে এর প্রচার নিশ্চিত করার জন্য যত্ন নেওয়া আবশ্যক
যখন ইনপ্লেস ব্যবহার করা হচ্ছে তখন ব্যাডফ্ল্যাগ; উদাহরণস্বরূপ "রিপ্লেসব্যাড" এর কোডটি দেখুন
মৌলিক/খারাপ/খারাপ.pd.

ডক পড ফরম্যাটে একটি ডকুমেন্টেশন স্ট্রিং নির্দিষ্ট করতে ব্যবহৃত হয়। তথ্যের জন্য PDL::Doc দেখুন
পিডিএল ডকুমেন্টেশন কনভেনশন। দ্রষ্টব্য: বিশেষ ক্ষেত্রে যেখানে PP 'Doc' স্ট্রিং আছে
একটি লাইন এটি দ্রুত রেফারেন্স এবং ডকুমেন্টেশনের জন্য অন্তর্নিহিতভাবে ব্যবহৃত হয়!

যদি ডক ক্ষেত্রটি বাদ দেওয়া হয় তবে পিপি ডিফল্ট ডকুমেন্টেশন তৈরি করবে (সবকিছুর পরে এটি জানে
স্বাক্ষর সম্পর্কে)।

আপনি যদি সত্যিই চান যে এই সময়ে ফাংশনটি কোনোভাবেই নথিভুক্ত করা হবে না (যেমন
একটি অভ্যন্তরীণ রুটিনের জন্য, অথবা আপনি কোডের অন্য কোথাও এটি করছেন বলে স্পষ্টভাবে
"Doc=>undef" নির্দিষ্ট করুন।

BadDoc (খারাপ)
"badinfo" কমান্ড ("perldl"-এ) বা "-b" সুইচ দ্বারা প্রত্যাবর্তিত পাঠ্য রয়েছে
"pdldoc" শেল স্ক্রিপ্টে। অনেক ক্ষেত্রে, আপনাকে এটি নির্দিষ্ট করতে হবে না, যেহেতু
তথ্য স্বয়ংক্রিয়ভাবে PDL::PP দ্বারা তৈরি করা যেতে পারে। যাইহোক, কম্পিউটারের সুবিধা হিসাবে-
উত্পন্ন টেক্সট, এটা বরং stilted এর; এটা নিজে করা অনেক ভালো হতে পারে!

NoPthread
PDL ফাংশন নির্দেশ করতে ঐচ্ছিক পতাকা উচিত না প্রসেসর থ্রেড ব্যবহার করুন (যেমন
pthreads বা POSIX থ্রেড) বহুবিধ CPU কোর জুড়ে কাজ বিভক্ত করতে। এই বিকল্প হয়
অন্তর্নিহিত PDL ফাংশন থ্রেডসেফ না হলে সাধারণত 1 এ সেট করা হয়। যদি এই বিকল্প
উপস্থিত নেই, তাহলে ফাংশনটি থ্রেডসেফ বলে ধরে নেওয়া হয়। এই বিকল্প শুধুমাত্র প্রযোজ্য
যদি PDL POSIX থ্রেড সক্ষম করে কম্পাইল করা হয়।

পিএমকোড
PDL ফাংশন আপনাকে একটি পিডলে পাস করতে দেয় যেখানে আপনি আউটপুট সংরক্ষণ করতে চান। এই
সুবিধাজনক কারণ আপনি একটি আউটপুট পিডল একবার বরাদ্দ করতে পারেন এবং এটি বহুবার পুনরায় ব্যবহার করতে পারেন; দ্য
PDL এর জন্য প্রতিবার একটি নতুন পিডল তৈরি করার বিকল্প হবে, যা গণনা নষ্ট করতে পারে
চক্র বা, সম্ভবত, RAM. এই যোগ করা নমনীয়তা আরো খরচে আসে
জটিলতা: PDL::PP-কে এমন ফাংশন লিখতে হবে যা গণনা করার জন্য যথেষ্ট স্মার্ট
আর্গুমেন্ট এটি পাস এবং উড়ে নতুন piddles তৈরি, কিন্তু শুধুমাত্র যদি আপনি তাদের চান.

PDL::PP এটা করতে যথেষ্ট স্মার্ট, কিন্তু আর্গুমেন্ট অর্ডারে সীমাবদ্ধতা রয়েছে এবং
মত. আপনি যদি আরও নমনীয় ফাংশন চান তবে আপনি নিজের পার্ল-সাইড লিখতে পারেন
wrapper এবং PMCode কীতে এটি নির্দিষ্ট করুন। আপনি যে স্ট্রিংটি সরবরাহ করবেন তা অবশ্যই (উচিত)
একটি নাম দিয়ে একটি পার্ল ফাংশন সংজ্ঞায়িত করুন যা আপনি প্রথমে pp_def কে যা দিয়েছিলেন তার সাথে মিলে যায়
স্থান আপনি যখন শেষ পর্যন্ত পিপি-জেনারেটেড ফাংশনটি চালু করতে চান, তখন আপনার প্রয়োজন হবে
স্বাক্ষরে উল্লিখিত সঠিক ক্রমে সমস্ত পিডল সরবরাহ করুন: আউটপুট পিডলগুলি
ঐচ্ছিক নয়, এবং PP-উত্পন্ন ফাংশন কিছুই ফেরত দেবে না। অস্পষ্ট
আপনি যে নামে ডাকবেন তা হল _ _int.

আমি বিশ্বাস করি এই ডকুমেন্টেশনের আরও স্পষ্টীকরণ প্রয়োজন, কিন্তু এটি করতে হবে।
:-(

PMFunc
যখন pp_def ফাংশন তৈরি করে, এটি সাধারণত PDL প্যাকেজে সেগুলিকে সংজ্ঞায়িত করে। তারপর,
.pm ফাইলে এটি আপনার মডিউলের জন্য তৈরি করে, এটি সাধারণত একটি লাইন যোগ করে যা
মূলত কোড সহ আপনার বর্তমান প্যাকেজের প্রতীক টেবিলে সেই ফাংশনটি অনুলিপি করে
এটি দেখতে এরকম দেখাচ্ছে:

*func_name = \&PDL::func_name;

এটি তার চেয়ে কিছুটা স্মার্ট (এটি জানে যে কখন এই ধরণের জিনিসটি মোড়ানো হবে
BEGIN ব্লক, উদাহরণস্বরূপ, এবং যদি আপনি pp_bless এর জন্য আলাদা কিছু উল্লেখ করেন), কিন্তু
যে এটা সারাংশ. আপনি যদি আপনার বর্তমান মধ্যে ফাংশন আমদানি করতে যত্ন না
প্যাকেজের প্রতীক টেবিল, আপনি নির্দিষ্ট করতে পারেন

PMFunc => '',

PMFunc এর অন্য কোন পার্শ্ব-প্রতিক্রিয়া নেই, তাই আপনি নির্বিচারে পার্ল কোড সন্নিবেশ করতে এটি ব্যবহার করতে পারেন
আপনি যদি চান আপনার মডিউল মধ্যে. যাইহোক, আপনি যদি পার্ল যোগ করতে চান তবে আপনার pp_addpm ব্যবহার করা উচিত
আপনার মডিউল কোড.

উপাঙ্গ B: PP ম্যাক্রো এবং ক্রিয়াকলাপ

ম্যাক্রো
(খারাপ) দ্বারা লেবেলযুক্ত ম্যাক্রো শুধুমাত্র তখনই ব্যবহার করা হয় যখন খারাপ-মান সমর্থন PDL-এ কম্পাইল করা হয়।

$variablename_from_sig()
একটি পিডিএল (এর নাম দ্বারা) অ্যাক্সেস করুন যা স্বাক্ষরে নির্দিষ্ট করা হয়েছিল

$COMP(x)
এই রূপান্তরের ব্যক্তিগত ডেটা কাঠামোতে একটি মান অ্যাক্সেস করুন (প্রধানত ব্যবহৃত হয়
"অন্যান্যপারস" বিভাগে নির্দিষ্ট করা একটি যুক্তি ব্যবহার করুন)

$SIZE(n)
রানটাইমে একটি প্রকৃত আকার দ্বারা প্রতিস্থাপিত নামে মাত্রা (যেমন উল্লেখ করা হয়েছে
স্বাক্ষর)

$জেনেরিক()
C টাইপ দ্বারা প্রতিস্থাপিত হয় যা অপারেশনের রানটাইম টাইপের সমান

$P(a) স্বাক্ষরে "a" নামক PDL-এ একটি পয়েন্টার অ্যাক্সেস। C-তে ইন্টারফেস করার জন্য দরকারী
ক্রিয়াকলাপ

$PP(a) pdl "a" এ একটি ফিজিক্যাল পয়েন্টার অ্যাক্সেস; প্রধানত অভ্যন্তরীণ ব্যবহারের জন্য

$TXXX(বিকল্প, বিকল্প)
রানটাইম অপারেশনের ধরন অনুযায়ী সম্প্রসারণের বিকল্প, যেখানে XXX কিছু
স্ট্রিং যা "/[BSULFD+]/" দ্বারা মেলে।

$PDL(a)
পিডল "a" এর pdl ডেটা স্ট্রাকচারে (pdl *) একটি পয়েন্টার ফেরত দিন

$ISBAD(a()) (খারাপ)
"a()" তে সংরক্ষিত মান যদি এই পিডলের জন্য খারাপ মানের সমান হয় তবে সত্য প্রদান করে।
"HandleBad" 1 এ সেট করা প্রয়োজন৷

$ISGOOD(a()) (খারাপ)
"a()" তে সংরক্ষিত মান যদি এর জন্য খারাপ মানের সমান না হয় তবে সত্য প্রদান করে
পিডল "HandleBad" 1 এ সেট করা প্রয়োজন৷

$SETBAD(a()) (খারাপ)
এই পিডলের জন্য খারাপ মান সমান করতে "a()" সেট করে। "HandleBad" সেট করা প্রয়োজন
1 তে

ক্রিয়াকলাপ
"লুপ(DIMS) %{ ... %}"
নামকৃত মাত্রার উপর লুপ; সীমা পিপি দ্বারা স্বয়ংক্রিয়ভাবে উত্পন্ন হয়

"থ্রেডলুপ %{ ... %}"
একটি থ্রেড লুপে নিম্নলিখিত কোড আবদ্ধ করুন

"টাইপস(টাইপস) %{ ... %}"
অপারেশনের ধরন যদি "TYPES" এর যেকোনো একটি হয় তাহলে নিম্নলিখিত কোডটি চালান

উপাঙ্গ C: কার্যাবলী আমদানিকৃত by পিডিএল::পিপি

আপনি যখন "PDL::PP ব্যবহার করেন" তখন অনেকগুলি ফাংশন আমদানি করা হয়। এই যে ফাংশন অন্তর্ভুক্ত
জেনারেট করা C বা XS কোড নিয়ন্ত্রণ করুন, যে ফাংশনগুলি জেনারেট করা পার্ল কোড নিয়ন্ত্রণ করে, এবং
যে ফাংশনগুলি প্যাকেজ এবং প্রতীক টেবিলগুলিকে ম্যানিপুলেট করে যেখানে কোড তৈরি করা হয়।

উৎপাদক C এবং XS কোড
PDL::PP এর মূল উদ্দেশ্য হল আপনার চারপাশে থ্রেডিং ইঞ্জিন মোড়ানো আপনার জন্য সহজ করা।
নিজের সি কোড, কিন্তু আপনি কিছু অন্যান্য জিনিসও করতে পারেন।

pp_def
আপনার সি কোডের চারপাশে থ্রেডিং ইঞ্জিন মোড়ানোর জন্য ব্যবহৃত হয়। কার্যত এই নথির সব
pp_def ব্যবহার নিয়ে আলোচনা করে।

pp_done
ইঙ্গিত করে যে আপনি PDL::PP দিয়ে সম্পন্ন করেছেন এবং এটির .xs এবং .pm ফাইলগুলি তৈরি করা উচিত
অন্যান্য pp_* ফাংশনের উপর ভিত্তি করে যা আপনি কল করেছেন। এই ফাংশন কোন লাগে
আর্গুমেন্ট।

pp_addxs
এটি আপনাকে আপনার .xs ফাইলে XS কোড যোগ করতে দেয়৷ আপনি যদি পার্ল তৈরি করতে চান তবে এটি কার্যকর-
অ্যাক্সেসযোগ্য ফাংশন যা C কোড ব্যবহার করে কিন্তু থ্রেডিং চালু করতে পারে না বা করা উচিত নয়
ইঞ্জিন XS হল স্ট্যান্ডার্ড মাধ্যম যার মাধ্যমে আপনি পার্ল-অ্যাক্সেসযোগ্য সি কোড মোড়ানো। তুমি পারবে
perlxs এ আরও জানুন।

pp_add_boot
এই ফাংশনটি XS BOOT বিভাগে আপনি যে স্ট্রিং পাস করেন তা যোগ করে। বুট বিভাগ
সি কোড যা আপনার মডিউল লোড হওয়ার সময় পার্ল দ্বারা কল করা হয় এবং এটির জন্য দরকারী
স্বয়ংক্রিয় সূচনা। আপনি perlxs-এ XS এবং BOOT বিভাগ সম্পর্কে আরও জানতে পারেন।

pp_addhdr
আপনার XS ফাইলে বিশুদ্ধ-সি কোড যোগ করে। XS ফাইলগুলি এমনভাবে গঠন করা হয় যে বিশুদ্ধ সি কোড আবশ্যক
এক্সএস স্পেসিফিকেশনের আগে আসা। এটি আপনাকে এই ধরনের সি কোড নির্দিষ্ট করতে দেয়।

pp_boundscheck
PDL সাধারণত সেগুলি তৈরি করার আগে আপনার অ্যাক্সেসের সীমানা পরীক্ষা করে। আপনি এটি চালু করতে পারেন
MyPackage::set_boundscheck সেট করে রানটাইমে চালু বা বন্ধ করুন। এই ফাংশন আপনাকে অনুমতি দেয়
যে রানটাইম নমনীয়তা অপসারণ এবং না সীমানা পরীক্ষা করা. এটিও ফেরত দেয়
কোনো আর্গুমেন ছাড়া কল করা হলে বর্তমান বাউন্ডচেকিং স্ট্যাটাস।

দ্রষ্টব্য: আমি অন্যান্য ডকুমেন্টেশনে সীমানা পরীক্ষা করার বিষয়ে কিছুই খুঁজে পাইনি। যে
সম্বোধন করা প্রয়োজন।

উৎপাদক পার্ল কোড
আপনি যখন PDL::PP ব্যবহার করেন তখন অনেক ফাংশন আমদানি করা হয় যা আপনাকে এর বিষয়বস্তু পরিবর্তন করতে দেয়
.pm ফাইল তৈরি করা হয়েছে। pp_def এবং pp_done ছাড়াও এই ফাংশনগুলির ভূমিকা রয়েছে
প্রাথমিকভাবে আপনার জেনারেট করা .pm ফাইলের বিভিন্ন অংশে কোড যোগ করার জন্য।

pp_addpm
জেনারেট করা .pm ফাইলে পার্ল কোড যোগ করে। PDL::PP আসলে তিনটির ট্র্যাক রাখে
উত্পন্ন কোডের বিভিন্ন বিভাগ: শীর্ষ, মধ্য এবং নীচে। আপনি যোগ করতে পারেন
এক-আর্গুমেন্ট ফর্ম ব্যবহার করে মধ্য বিভাগে পার্ল কোড, যেখানে আর্গুমেন্ট হল
পার্ল কোড আপনি সরবরাহ করতে চান। দ্বি-যুক্তি আকারে, প্রথম যুক্তিটি হল একটি
শুধুমাত্র একটি কী সহ বেনামী হ্যাশ যা নির্দিষ্ট করে যে দ্বিতীয় আর্গুমেন্ট কোথায় রাখতে হবে,
যা আপনি .pm ফাইলে যোগ করতে চান যে স্ট্রিং. হ্যাশ এই একটি
তিন:

{এ => 'শীর্ষ'}
{এ => 'মাঝখানে'}
{এ => 'বট'}

উদাহরণ স্বরূপ:

pp_addpm({At => 'বট'}, <

=head1 কিছু ডকুমেন্টেশন

আমি জানি আমি আমার ফাইলের মাঝখানে এই টাইপ করছি, কিন্তু এটা যেতে হবে
নিচে.

= কাটা

POD

সতর্কতা: যদি, আপনার .pd ফাইলের মাঝখানে, আপনি এর জন্য ডকুমেন্টেশন রাখেন
আপনার পডের নীচে, আপনি পুঙ্খানুপুঙ্খভাবে CPAN বিভ্রান্ত করবেন। অন্যদিকে, যদি
আপনার .pd ফাইলের মাঝখানে, আপনি আপনার নীচে বা উপরের জন্য নির্ধারিত কিছু পার্ল কোড যোগ করুন
.pm ফাইল, আপনি শুধুমাত্র নিজেকে বিভ্রান্ত করতে হবে. :-)

pp_beginwrap
BEGIN-ব্লক মোড়ানো যোগ করে। যদিও কিছু ঘোষণা BEGIN ব্লকে মোড়ানো যেতে পারে
ডিফল্ট আচরণ এই ধরনের কোন মোড়ানো আছে.

pp_addbegin
আপনার .pm ফাইলের উপরে যোগ করার জন্য কোড সেট করে, এমনকি আপনার নির্দিষ্ট করা কোডের উপরেও
সঙ্গে "pp_addpm({At => 'Top'}, ...)"। pp_addpm এর বিপরীতে, এটিকে কল করা যাই হোক না কেন ওভাররাইট করে
আগে ছিল. সাধারণত, আপনার সম্ভবত এটি ব্যবহার করা উচিত নয়।

অনুসরণকরণ লাইন নাম্বার
যখন আপনি কম্পাইল ত্রুটি পান, হয় আপনার সি-এর মতো কোড বা আপনার পার্ল কোড থেকে, এটি সাহায্য করতে পারে
সেই ত্রুটিগুলিকে সোর্স ফাইলের লাইন নম্বরগুলিতে ফিরিয়ে আনতে যেখানে ত্রুটিটি হয়েছে৷
ঘটেছে।

pp_লাইন_সংখ্যা
একটি লাইন নম্বর এবং কোডের একটি (সাধারণত দীর্ঘ) স্ট্রিং নেয়। লাইন নম্বর উচিত
যে লাইনে উদ্ধৃতি শুরু হয় সেটি নির্দেশ করুন। এটি সাধারণত পার্লের "__LINE__"
আক্ষরিক, যদি না আপনি herdocs ব্যবহার করছেন, এই ক্ষেত্রে এটি "__LINE__ + 1"। দ্য
প্রত্যাবর্তিত স্ট্রিং-এ কম্পাইলার রিপোর্ট ত্রুটিগুলিকে সাহায্য করার জন্য # লাইনের নির্দেশাবলী রয়েছে
সঠিক লাইনে।

পরিবর্তন দ্য প্রতীক টেবিল এবং রপ্তানি আচরণ
PDL::PP সাধারণত pp_def ব্যবহার করে উত্পন্ন সমস্ত ফাংশন রপ্তানি করে এবং সাধারণত সেগুলি ইনস্টল করে
PDL প্রতীক টেবিলে। যাইহোক, আপনি এই ফাংশনগুলির সাথে এই আচরণটি সংশোধন করতে পারেন।

pp_bless
প্যাকেজ (প্রতীক টেবিল) সেট করে যেখানে XS কোড যোগ করা হয়েছে। ডিফল্ট হল PDL,
যা সাধারণত আপনি চান কি. আপনি যদি পূর্বনির্ধারিত দোয়া ব্যবহার করেন এবং আপনি একটি তৈরি করেন
ফাংশন myfunc, তারপর আপনি নিম্নলিখিত করতে পারেন:

$piddle->myfunc( );
PDL::myfunc($piddle, );

অন্যদিকে, আপনি যদি আপনার ফাংশনগুলিকে অন্য প্যাকেজে আশীর্বাদ করেন তবে আপনি আহ্বান করতে পারবেন না
এগুলিকে পিডিএল পদ্ধতি হিসাবে, এবং সেগুলিকে এইভাবে আহ্বান করতে হবে:

MyPackage::myfunc($piddle, );

অবশ্যই, আপনি PDL প্রতীকে আপনার ফাংশন যোগ করতে PMFunc কী ব্যবহার করতে পারেন
টেবিল, কিন্তু কেন যে?

pp_add_isa
মডিউলের তালিকায় যোগ করে যা থেকে আপনার মডিউল উত্তরাধিকারসূত্রে ডিফল্ট তালিকা হয়

qw(PDL::রপ্তানিকারক ডায়নালোডার)

pp_core_importlist
আপনার তৈরি করা .pm ফাইলের শীর্ষে একটি লাইন রয়েছে যা দেখতে এইরকম:

PDL::Core ব্যবহার করুন;

আপনি pp_core_importlist-এ একটি স্ট্রিং নির্দিষ্ট করে এটি সংশোধন করতে পারেন। উদাহরণ স্বরূপ,

pp_core_importlist('::Blarg');

ফলাফল হবে

PDL::Core::Blarg ব্যবহার করুন;

আপনি এটি ব্যবহার করতে পারেন, উদাহরণস্বরূপ, PDL::Core থেকে আমদানি করার জন্য প্রতীকগুলির একটি তালিকা যোগ করতে। জন্য
উদাহরণস্বরূপ:

pp_core_importlist("':অভ্যন্তরীণ'");

নিম্নলিখিত ব্যবহারের বিবৃতিতে নেতৃত্ব দেবে:

PDL::Core ':Internal' ব্যবহার করুন;

pp_setversion
আপনার মডিউল এর সংস্করণ সেট করে। সংস্করণটি .xs এবং .pm-এর মধ্যে সামঞ্জস্যপূর্ণ হতে হবে৷
ফাইল, এবং এটি নিশ্চিত করতে ব্যবহৃত হয় যে আপনার পার্লের লাইব্রেরিগুলি সংস্করণে ভোগে না
তির্যক

pp_add_exported
রপ্তানি তালিকায় আপনি যে নামই দেন তাতে যোগ করে। pp_def ব্যবহার করে ফাংশন তৈরি করা হয়েছে
তালিকায় স্বয়ংক্রিয়ভাবে যুক্ত হয়। আপনি যদি কোন পার্ল সংজ্ঞায়িত করেন তবে এই ফাংশনটি কার্যকর
pp_addpm বা pp_addxs ব্যবহার করে ফাংশন যা আপনি রপ্তানি করতে চান।

pp_export_nothing
এটি রপ্তানিকৃত চিহ্নের তালিকাকে রিসেট করে না। এটি সম্ভবত ভাল বলা হয়
"pp_export_clear", যেহেতু আপনি কল করার পরে এক্সপোর্ট করা চিহ্ন যোগ করতে পারেন
"pp_export_nothing"। pp_done কল করার ঠিক আগে কল করা হলে, এটি নিশ্চিত করে যে আপনার
মডিউল কিছু রপ্তানি করে না, উদাহরণস্বরূপ, যদি আপনি শুধুমাত্র প্রোগ্রামারদের আপনার ব্যবহার করতে চান
পদ্ধতি হিসাবে কাজ করে।

onworks.net পরিষেবা ব্যবহার করে PDL::PPp অনলাইন ব্যবহার করুন