C++#

VEX EXP C++ API রেফারেন্সে VEXcode EXP C++ প্রোজেক্টে ব্যবহৃত ক্লাস, অবজেক্ট, কনস্ট্রাক্টর, মেম্বার ফাংশন এবং ভেরিয়েবল ব্যাখ্যা করা হয়েছে।

কোনো ডিভাইস বা ফিচার কীভাবে তৈরি করা হয় তা বুঝতে, কোন ফাংশন সিগনেচার ব্যবহার করতে হবে তা যাচাই করতে, অথবা একটি ক্লাসের মধ্যে সম্পর্কিত মেম্বার ফাংশনগুলোর তুলনা করতে চাইলে এই রেফারেন্সটি ব্যবহার করুন।

VEXcode EXP C++ প্রোজেক্টে C++ কমান্ড ব্যবহার করা হয়। VEX Visual Studio Code Extension-এর সাহায্যে Visual Studio Code-এ লেখা প্রোজেক্টগুলোকেও C++ API তথ্য সমর্থন করতে পারে।

একটি C++ ক্লাস পেজ কীভাবে পড়তে হয়#

একটি C++ ক্লাস পেজ সাধারণত এই ক্রম অনুসরণ করে:

ভূমিকা - ক্লাসটি কী বোঝায় এবং কখন এটি উপযোগী, তা ব্যাখ্যা করে।
ব্যুৎপন্ন ক্লাসসমূহ - এই ক্লাসের উপর ভিত্তি করে তৈরি হওয়া ক্লাসগুলোর তালিকা, যদি প্রযোজ্য হয়।
ক্লাস কনস্ট্রাক্টর বা কনস্ট্রাক্টরসমূহ - ক্লাস থেকে একটি অবজেক্ট তৈরি করার জন্য ব্যবহৃত সিনট্যাক্স দেখায়।
ক্লাস ডেস্ট্রাক্টর - অবজেক্টটি ধ্বংস করতে এবং প্রযোজ্য ক্ষেত্রে এর রিসোর্সসমূহ মুক্ত করতে ব্যবহৃত সিনট্যাক্স দেখায়।
প্যারামিটারসমূহ - অবজেক্ট তৈরির সময় ব্যবহৃত কনস্ট্রাক্টর প্যারামিটারগুলো ব্যাখ্যা করে।
উদাহরণ - কোডে কীভাবে অবজেক্ট তৈরি করতে হয় তা দেখানো হয়েছে।
সদস্য ফাংশনসমূহ - ক্লাসের অন্তর্গত ফাংশনগুলোর তালিকা, যা প্রায়শই উদ্দেশ্য অনুসারে শ্রেণিবদ্ধ করা হয়।
ফাংশন এন্ট্রি - প্রতিটি মেম্বার ফাংশনের ব্যাখ্যা, যার মধ্যে রয়েছে উপলব্ধ ফাংশন, প্যারামিটার, রিটার্ন ভ্যালু, নোট এবং উদাহরণ।

প্রতিটি পৃষ্ঠায় সব বিভাগ থাকে না। উদাহরণস্বরূপ, কিছু পৃষ্ঠায় ডিরাইভড ক্লাস অন্তর্ভুক্ত থাকে না, এবং কিছু ফাংশনে প্যারামিটার বা রিটার্ন ভ্যালু থাকে না।

সাধারণ C++ API উপাদান#

উপাদান	এর মানে কী
Class	কোনো ডিভাইস বা ফিচারের জন্য C++ টাইপ, যেমন `motor` অথবা `drivetrain`।
Object	একটি ক্লাস থেকে তৈরি করা একটি নামযুক্ত ইনস্ট্যান্স, যেমন `motor Motor1` অথবা `drivetrain myDrivetrain`।
নির্মাতা	ক্লাস থেকে অবজেক্ট তৈরি করতে ব্যবহৃত কোড।
সদস্যের কার্যক্রম	কোনো অবজেক্টের উপর কল করা একটি কমান্ড, যেমন `myDrivetrain.drive(…)`.
উপলব্ধ ফাংশন	মেম্বার ফাংশনের জন্য ব্যবহারযোগ্য একটিমাত্র ফাংশন সিগনেচার থাকে। কিছু মেম্বার ফাংশনের একাধিক ব্যবহারযোগ্য ফাংশন থাকে।
প্যারামিটার	কোনো কনস্ট্রাক্টর বা ফাংশনের কার্যকলাপ নিয়ন্ত্রণ করার জন্য সেটির মধ্যে একটি মান পাস করা হয়।
ফেরত মূল্য	একটি ফাংশন যে মান ফেরত দেয়, যেমন `bool`, `int32_t`, বা `double`।

সি++ এর মৌলিক শব্দভান্ডার#

মেয়াদ	এর মানে কী
পরিবর্তনশীল	একটি নাম যা একটি মান সংরক্ষণ করে, যেমন `int speed = 50;`.
ধরণ	কোনো কিছু যে ধরনের ডেটা সংরক্ষণ করে, যেমন `int`, `double`, বা `bool`।
স্ট্রিং	উদ্ধৃতি চিহ্নের ভেতরের লেখা, যেমন `“Hello”`.
int	একটি ধনাত্মক বা ঋণাত্মক পূর্ণ সংখ্যা, যেমন `90`।
দ্বিগুণ	এমন এক ধরনের সংখ্যা যাতে দশমিক থাকতে পারে, যেমন `25.5`।
বুল	এমন একটি মান যা হয় `true` অথবা `false`।
যুক্তি	মেম্বার ফাংশন বা ফাংশন কলে পাস করা একটি মান, যেমন `forward` in `myDrivetrain.drive(forward)`।

কনস্ট্রাক্টর এবং অবজেক্ট#

অনেক C++ ক্লাসের মেম্বার ফাংশন ব্যবহার করার আগে একটি অবজেক্ট থাকা আবশ্যক। কনস্ট্রাক্টর দেখায় কীভাবে সেই অবজেক্টটি তৈরি করতে হয়।

উদাহরণস্বরূপ, কনস্ট্রাক্টরকে প্রয়োজনীয় পোর্ট বা কনফিগারেশন তথ্য দিয়ে একটি মোটর অবজেক্ট তৈরি করা যেতে পারে:

motor Motor1 = motor(PORT1, false);

অবজেক্টটি তৈরি হওয়ার পরে, এর মেম্বার ফাংশনগুলো কল করা যেতে পারে:

Motor1.spin(forward);

VEXcode-এ, ডিভাইস মেনুর মাধ্যমে ডিভাইস কনফিগারেশন প্রায়শই স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায়। VEX এক্সটেনশনসহ Visual Studio Code-এ, কনস্ট্রাক্টরগুলো ম্যানুয়ালি লেখার প্রয়োজন হতে পারে।

সঠিক উপলব্ধ ফাংশন নির্বাচন করা#

কিছু মেম্বার ফাংশনের একাধিক ফাংশন উপলব্ধ থাকে। প্রতিটি ফাংশন ভিন্ন ভিন্ন প্যারামিটার সেট ব্যবহার করে, তাই আপনার প্রোজেক্টের প্রয়োজনীয় ভ্যালুগুলোর সাথে মেলে এমন ফাংশনটি বেছে নিন।

উদাহরণস্বরূপ, একটি ড্রাইভট্রেইন ফাংশনের একটি সংস্করণ থাকতে পারে যা বর্তমান বেগ ব্যবহার করে এবং আরেকটি সংস্করণ থাকতে পারে যা প্রজেক্টকে একটি বেগ বেছে নিতে দেয়:

void drive(directionType dir);

void drive(directionType dir, double velocity, velocityUnits units);

উভয় ফাংশনই driveচালাতে বলে, কিন্তু দ্বিতীয় ফাংশনটি আরও বেশি নিয়ন্ত্রণ দেয় কারণ এতে বেগের প্যারামিটার অন্তর্ভুক্ত রয়েছে।

উদাহরণ ফাংশন এন্ট্রি#

ড্রাইভ#

ড্রাইভ drive রোবটটিকে অনির্দিষ্টকালের জন্য সামনে বা পেছনে চালনা করে। রোবটটি ততক্ষণ চলতে থাকবে যতক্ষণ না এটিকে মোড় নেওয়া বা থামানোর মতো অন্য কোনো কাজ দেওয়া হয়। RPM বা DPS-এর সীমা ড্রাইভট্রেনের গিয়ার অনুপাতের মাধ্যমে পরিবর্তন করা হয়।

উপলব্ধ ফাংশনসমূহ

void drive(directionType dir);

void drive(directionType dir, double velocity, velocityUnits units);

প্যারামিটার	প্রকার	বর্ণনা
`dir`	`directionType`	রোবটটি যেদিকে চলে: `forward` বা `reverse`।
`velocity`	`double`	`velocityUnits::pct`ব্যবহার করলে চালনার বেগ 0% থেকে 100%, `rpm`ব্যবহার করলে 0 থেকে 600 rpm, অথবা `dps`ব্যবহার করলে 0 থেকে 3600 ডিগ্রি প্রতি সেকেন্ড পর্যন্ত হয়। যদি কোনো বেগ প্রদান করা না হয়, তবে রোবটটি বর্তমান চালনার বেগে চলে।
`units`	`velocityUnits`	বেগের একক: `velocityUnits::pct` (শতাংশ), `rpm` (প্রতি মিনিটে ঘূর্ণন), অথবা `dps` (প্রতি সেকেন্ডে ডিগ্রি)।

ফেরত মূল্য

এই ফাংশনটি কোনো মান ফেরত দেয় না।

টীকা

ড্রাইভ drive সাথে সাথেই প্রজেক্টটি কোডের পরবর্তী লাইনটি চালানো শুরু করবে।
ড্রাইভট্রেনটি ততক্ষণ চলতে থাকবে যতক্ষণ না stop কল করা হয় অথবা অন্য কোনো ড্রাইভট্রেন মুভমেন্ট ফাংশন কার্যকর করা হয়।
isDone এবং isMoving এর মতো ফাংশনগুলি driveএর ক্ষেত্রে প্রযোজ্য নয়, কারণ এটি লক্ষ্য-ভিত্তিক চলাচল ব্যবহার করে না।

উদাহরণ

// Drive forward and back
myDrivetrain.drive(forward);
wait(2, seconds);
myDrivetrain.drive(reverse, 25, rpm);
wait(2, seconds);
myDrivetrain.stop();

অপেক্ষা এবং অ-অপেক্ষা আচরণ#

কিছু C++ মুভমেন্ট ফাংশন কোনো একটি কাজ শেষ না হওয়া পর্যন্ত অপেক্ষা করে এবং তারপরই প্রজেক্টটি কোডের পরবর্তী লাইনে যায়। আবার অন্য কিছু ফাংশন কোনো কাজ শুরু করে দেয় এবং সাথে সাথেই পরবর্তী লাইনটি রান হতে দেয়।

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

Some functions include a parameter such as waitForCompletion to choose this behavior. For those functions, true usually makes the project wait, while false lets the next line run right away.

উপবিভাগে নির্দেশাবলী#

C++ কমান্ডগুলো ডিভাইস বা বিষয় অনুসারে সাজানো থাকে। উদাহরণস্বরূপ, ড্রাইভট্রেন, মোশন, ব্রেইন, কন্ট্রোলার, স্মার্ট পোর্ট ডিভাইস, ৩-ওয়্যার ডিভাইস, কনসোল, লজিক এবং VEXlink-এর কমান্ডগুলোকে তাদের নিজস্ব উপবিভাগে ভাগ করা হয়েছে।