Serial.readString() فنکشن کو سمجھنا
Serial.readString() فنکشن Arduino سیریل لائبریری کا ایک حصہ ہے، جو مائیکرو کنٹرولر اور کمپیوٹر یا دیگر بیرونی آلات کے درمیان رابطے کو قابل بناتا ہے۔
یہ فنکشن مائیکرو کنٹرولر کو سیریل کنکشن سے بھیجے گئے حروف کی تار کو پڑھنے کی اجازت دیتا ہے۔ فنکشن سیریل بفر سے ڈیٹا پڑھتا ہے اور ڈیٹا کو String آبجیکٹ کی شکل میں واپس کرتا ہے۔
یہ فنکشن سٹریم کلاس سے وراثت میں ملا ہے۔
نحو
اس فنکشن کا نحو درج ذیل ہے:
سیریل readString ( )
پیرامیٹرز
یہ فنکشن کوئی پیرامیٹرز نہیں لیتا ہے۔ یہ صرف سیریل پورٹ آبجیکٹ کو پڑھتا ہے۔
واپسی
سیریل پورٹ کے ذریعے موصول ہونے والے حروف پر مشتمل ایک سٹرنگ لوٹاتا ہے۔ سٹرنگ موصول ہونے والے آخری کریکٹر کے ساتھ ختم ہوتی ہے، جو اکثر ایک نئی لائن کریکٹر (\n) ہوتا ہے۔ اگر سیریل بفر میں کوئی حرف دستیاب نہیں ہے تو، فنکشن ایک خالی سٹرنگ ('') لوٹاتا ہے۔
نوٹ: اگر ڈیٹا میں اینڈ لائن کریکٹر دستیاب ہے تو فنکشن جلد ختم نہیں ہوگا۔ واپس کی گئی اسٹرنگ میں کیریج ریٹرن کریکٹرز شامل ہو سکتے ہیں۔
مثال کا کوڈ
نیچے کا کوڈ Arduino پروگرامنگ میں Serial.readString() فنکشن کے استعمال کو ظاہر کرتا ہے:
نیچے کا کوڈ Arduino پروگرامنگ میں Serial.readString() فنکشن کے استعمال کو ظاہر کرتا ہے:
باطل سیٹ اپ ( ) {سیریل شروع ( 9600 ) ;
}
باطل لوپ ( ) {
سیریل پرنٹ ایل این ( 'ڈیٹا درج کریں:' ) ;
جبکہ ( سیریل دستیاب ( ) == 0 ) { } // دستیاب ڈیٹا کا انتظار کریں۔
سٹرنگ ٹیسٹسٹر = سیریل readString ( ) ; // ٹائم آؤٹ تک پڑھیں
teststr. تراشنا ( ) ; // سٹرنگ اینڈ سے کوئی بھی \r \n وائٹ اسپیس ہٹا دیں۔
سیریل پرنٹ کریں ( 'ڈیٹا ان پٹ:' ) ;
سیریل پرنٹ ایل این ( teststr ) ;
اگر ( teststr == 'ہیلو' ) {
سیریل پرنٹ ایل این ( 'آپ کو بھی سلام!' ) ;
} اور {
سیریل پرنٹ ایل این ( 'میں معافی چاہتا ہوں، میں آپ کے ان پٹ کو نہیں سمجھا۔' ) ;
}
}
میں سیٹ اپ() فنکشن سیریل کمیونیکیشن کو 9600 کی بوڈ ریٹ کا استعمال کرتے ہوئے فعال کیا گیا ہے۔
میں لوپ() فنکشن، کوڈ صارف کو سیریل مانیٹر پر 'Enter data:' پرنٹ کرکے ڈیٹا داخل کرنے کا اشارہ کرتا ہے۔ اس کے بعد یہ جانچ کر کے ڈیٹا کے دستیاب ہونے کا انتظار کرتا ہے کہ آیا Serial.available() فنکشن کا استعمال کرتے ہوئے سیریل بفر خالی ہے یا نہیں۔
ڈیٹا دستیاب ہونے کے بعد، کوڈ Serial.readString() فنکشن کا استعمال کرتے ہوئے ڈیٹا کو سٹرنگ کے طور پر پڑھتا ہے اور trim() فنکشن کا استعمال کرتے ہوئے اسٹرنگ کے آخر میں کسی بھی وائٹ اسپیس حروف کو ہٹا دیتا ہے۔
کوڈ پھر ان پٹ سٹرنگ کا سٹرنگ 'ہیلو' سے موازنہ کرتا ہے۔ اگر ان پٹ سٹرنگ ہے۔ 'ہیلو' ، کوڈ پرنٹنگ کے ذریعہ جواب دیتا ہے۔ ’’آپ کو بھی سلام!‘‘ سیریل مانیٹر پر۔ بصورت دیگر، یہ پرنٹ کرتا ہے 'مجھے افسوس ہے، میں آپ کے ان پٹ کو نہیں سمجھا۔' سیریل مانیٹر پر۔ لوپ() فنکشن پھر دہراتا ہے، صارف کو مزید ان پٹ کے لیے اشارہ کرتا ہے۔
آؤٹ پٹ
آؤٹ پٹ میں ہم مختلف سٹرنگز دیکھ سکتے ہیں جو کوڈ صارف سے پڑھتا ہے اور اسے 'ہیلو' سٹرنگ سے ملاتا ہے۔
نتیجہ
Arduino میں Serial.readString() فنکشن کمپیوٹر یا دیگر آلات سے بورڈ کو بھیجے گئے سیریل ڈیٹا کو پڑھتا ہے۔ اس فنکشن کا استعمال کرتے ہوئے، ہم ان پٹ سیریل سٹرنگ ڈیٹا کو پڑھ اور موازنہ کر سکتے ہیں تاکہ آؤٹ پٹ جوابات جیسے کہ کنٹرولنگ سینسرز اور ہارڈ ویئر ڈیوائسز پیدا کر سکیں۔