Basic input/output function

Basic In/Out Function

• 표준 입·출력 장치에 문자를 입·출력 하는 함수
• 문자열을 입력 받는 함수
• 문자열을 출력하는 함수
• ASCII Code 영문 소문자를 대문자로 변환 함수
• 부호 없는 정수를 입력 받는 함수
• 부호 있는 정수를 입력 받는 함수
• 부호 없는 정수를 출력하는 함수
• 부호 있는 정수를 출력하는 함수
• 16진 수를 입력 받는 함수
• 정수를 16진 수로 변환하여 출력하는 함수
• Null 문자로 끝나는 문자열을 전달 받아 대 문자로 변환하여 되돌려 주는 함수

---

Basic In/Out Function Code 예: gnu_sciutil.c

표준 입·출력 장치에 문자를 입·출력 하는 함수

하나의 문자를 표준 입출력 장치로 입출력 하는 함수(SCI_OutChar, SCI_InChar)로 표준 입출력 장치가 변경되면(예: UART, Keypad, LCD 등) 이 함수만 변경 하면 다른 기본 입출력 함수는 변경 없이 사용 할 수 있다.

• 표준 입력 장치에서 문자를 입력 받는 함수
• 이 예는 UART를 표준 입력 장치로 사용 하는 예 이다.
// 문자(ASCII)를 표준 입력 장치로 부터 입력 하는 함수 unsigned short SCI_InChar(){ // 이 예는 UART를 표준 입력 장치로 사용 하는 예 이다. // 아래 함수를 다른 장치로 문자를 입력 하는 함수로 바꾸면 // 다른 장치를 표준 입력 장치로 사용 할 수 있다. return rx0_char(); }


• 표준 출력 장치에 문자를 출력 하는 함수
• 이 예는 UART를 표준 출력 장치로 사용 하는 예 이다.
// 하나의 문자를 표준 출력 장치에 출력 하는 함수 void SCI_OutChar(char letter){ // 이 예는 UART를 표준 출력 장치로 사용 하는 예 이다. // 아래 함수를 다른 장치로 문자를 출력 하는 함수로 바꾸면 // 다른 장치를 표준 출력 장치로 사용 할 수 있다. tx0_char(letter); }

문자열을 입력 받는 함수

• 이 함수는 표준 입력 장치로 부터 문자열을 입력 받는 함수이다.
• 문자열 입력은 carriage return 문자가 입력 될 때 종료 된다.
• 최대 입력 받을 수 있는 문자의 수는 max 인수에 의하여 전달 받는다.
• 입력 받은 문자는 표준 출력 장치로 출력(echo) 된다.
• Backspace 문자가 입력 되면 입력 받은 문자열에서 하나의 문자가 삭제 된다.
• 문지열은 Null character(0x00)에 의하여 Terminate 된다.
void SCI_InString(char *string, unsigned int max) { unsigned int length=0; unsigned char character; while((character = SCI_InChar()) != CR){ if(character == BS){ if(length){ string--; length--; SCI_OutChar(BS); } } else if(length < max){ *string++ = character; length++; SCI_OutChar(character); } } *string = 0; // 문자열의 끝에 Null code 삽입함. }

문자열을 출력하는 함수

• 이 함수는 표준 출력 장치로 문자열을 출력 하는 함수이다.
• 문자열은 문자열 Pointer(*pt)를 이용 하여 전달 받는다.
void SCI_OutString(char *pt){ char letter; while((letter = *pt++)){ SCI_OutChar(letter); } }

ASCII Code 영문 소문자를 대문자로 변환 함수

• ASCII Code 영문 소문자를 대문자로 변환 함수
• 하나의 문자를 전달 받아 대문자로 변환 하여 되 돌려 주는 함수이다.
char SCI_UpCase(char character){ // ASCII Code 에서 소문자와 대문자의 차이는 0x20 이다. return ((character >= 'a') && (character <= 'z'))? character - 0x20 : character; }


• Null 문자로 끝나는 ASCII Code 문자열을 전달 받아 대 문자로 변환하여 되돌려 주는 함수
• 문자열을 전달 받아 모두 대문자로 변환 하여 되 돌려 주는 함수이다.
void SCI_upCaseString(char *inString){ char *pt = inString; // ASCII Code 에서 소문자와 대문자의 차이는 0x20 이다. // 예: 'a' = 0x61 와 'A' = 0x41 의 차이는 0x20 이다. while(*pt){ // c 언어에서 문자열의 끝 문자는 NULL Code 이다. if((*pt >= 'a') && (*pt <= 'z')) *pt -= 0x20; pt++; } }

부호 없는 정수를 입력 받는 함수

• 부호 없는 정수를 입력 받는 함수
• 이 함수는 부호 없는 정수를 입력 받는 함수 이다.
• 정수는 표준 입력 장치로 부터 숫자열이 입력 된다.
• 표준 입력 장치로 부터 입력 받은 숫자열은 2진수로 변환되어 Unsigned short integer로 반환 된다.
• 입력 받을 수 있는 최대 값은 65535이고 이보다 큰 수는 Error 메세지 없이 Truncate 된다.
• Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 된다.
unsigned short SCI_InUDec(void){ unsigned short number = 0, length = 0; unsigned char character; // Carriage return code가 입력 될 때 까지 문자열을 입력 받는다. while((character = SCI_InChar()) != CR){ // 입력 받은 문자가 숫자('0' - '9')이면 숫자열을 정수로 변환 한다. // 입력 받은 문자가 숫자가 아니면 무시 한다. if((character >= '0') && (character <= '9')) { // 만약 입력 받은 숫자가 65535 보다 크면 Overflow 가 발생 한다. // Overflow 발생시 Error 메세지 없이 Truncate 된다. number = 10 * number + (character - '0'); length++; SCI_OutChar(character); } // Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 한다. else if((character == BS) && length){ number /= 10; length--; SCI_OutChar(character); } } return number; }


• 부호 없는 정수와 연산자를 입력 받는 함수
• 이 함수는 부호 없는 정수와 연산자를 입력 받는 함수 이다.
• 정수는 표준 입력 장치로 부터 숫자열로 입력 된다.
• 표준 입력 장치로 부터 입력 받은 숫자열은 2진수로 변환되어 Unsigned short integer로 반환 된다.
• 입력 받을 수 있는 최대 값은 65535이고 이보다 큰 수는 Error 메세지 없이 Truncate 된다.
• Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 된다.
• 연산자(+,-,*,/ 등) 또는 CR Code가 char pointer를 이용 하여 전달 된다.
unsigned short SCI_InUDec_OP_code(char *op_code){ unsigned short number = 0, length = 0; unsigned char character; character=SCI_InChar(); while(((character >= '0') && (character <= '9')) || ((character == BS) && (length >= 0))){ // 입력 받은 문자가 숫자('0' - '9')이면 숫자열을 정수로 변환 한다. if((character >= '0') && (character <= '9')) { // 만약 입력 받은 숫자가 65535 보다 크면 Overflow 가 발생 한다. // Overflow 발생시 Error 메세지 없이 Truncate 된다. number = 10 * number + (character-'0'); length++; SCI_OutChar(character); } // Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 한다. else if((character == BS) && length){ number /= 10; length--; if(length <= 0) length = 0; SCI_OutChar(character); } character = SCI_InChar(); } // 마지막에 입력된 문자(숫자가 아닌 문자, 대부분의 경우 연산자)가 *op_code에 저장 된다. *op_code = character; return number; }

부호 있는 정수를 입력 받는 함수

• 부호 있는 정수를 입력 받는 함수
• 이 함수는 부호 있는 정수를 입력 받는 함수 이다.
• 정수는 표준 입력 장치로 부터 숫자열로 입력 된다.
• 표준 입력 장치로 부터 입력 받은 숫자열은 2진수로 변환되어 Signed short integer로 반환 된다.
• 입력 받을 수 있는 수의 범위는 최대 값이 32767 이고 최소 값이 -32767 이다.
• 이 수 보다 크거나 작은 수는 Error 메세지 없이 Truncate 된다.
• Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 된다.
short SCI_InSDec(void){ short number = 0, sign = 1; // sign flag 1 = positive, 0 = negative unsigned int length = 0; unsigned char character; // Carriage return code가 입력 될 때 까지 문자열을 입력 받는다. while ((character = SCI_InChar()) != CR){ // 첫 문자가 입력된 경우 + 또는 - 문자 인지 검사 한다. if(!length) { // 첫 문자가 - 인 경우 음수로 처리 한다. if(character == '-'){ sign = -1; length++; SCI_OutChar('-'); } // 첫 문자가 + 인 경우 양수로 처리 한다. else if(character == '+'){ length++; SCI_OutChar('+'); } } // 입력 받은 문자가 숫자('0' - '9')이면 숫자열을 정수로 변환 한다. if((character >= '0') && (character <= '9')){ // 만약 입력 받은 숫자가 32767 보다 크면 Overflow 가 발생 한다. // Overflow 발생시 Error 메세지는 출력되지 않는다. number = number * 10 + (character - '0'); length++; SCI_OutChar(character); } // Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 한다. else if((character == BS) && length){ number /= 10; length--; if(!length){ sign = 1; } SCI_OutChar(BS); } } return sign * number; }


• 부호 있는 정수와 연산자를 입력 받는 함수
• 이 함수는 부호 있는 정수를 입력 받는 함수 이다.
• 정수는 표준 입력 장치로 부터 숫자열로 입력 된다.
• 표준 입력 장치로 부터 입력 받은 숫자열은 2진수로 변환되어 Signed short integer로 반환 된다.
• 입력 받을 수 있는 수의 범위는 최대 값이 32767 이고 최소 값이 -32767 이다.
• 이 수 보다 크거나 작은 수는 Error 메세지 없이 Truncate 된다.
• Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 된다.
• 연산자(+,-,*,/ 등) 또는 CR Code가 char pointer를 이용 하여 전달 된다.
short SCI_InSDec_OP_code(char *pt_op){ short number = 0, sign = 1; // sign flag 1 = positive, 0 = negative unsigned int length = 0; unsigned char character; character=SCI_InChar(); while (((character >= '0') && (character <= '9')) || (!length && (character == '+')) || (!length && (character == '-')) || ((character == BS) && (length >= 0))){ // 첫 문자가 입력된 경우 + 또는 - 문자 인지 검사 한다. if(!length) { // 첫 문자가 - 인 경우 음수로 처리 한다. if(character=='-'){ sign = -1; length++; SCI_OutChar('-'); } // 첫 문자가 + 인 경우 양수로 처리 한다. else if(character=='+'){ length++; SCI_OutChar('+'); } } // 입력 받은 문자가 숫자('0' - '9')이면 숫자열을 정수로 변환 한다. if((character >= '0') && (character <= '9')){ // 만약 입력 받은 숫자가 32767 보다 크면 Overflow 가 발생 한다. // Overflow 발생시 Error 메세지는 출력되지 않는다. number = number * 10 + (character - '0'); length++; SCI_OutChar(character); } // Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 한다. else if((character == BS) && length){ number /= 10; length--; if(length <= 0) length = 0; if(!length){ sign = 1; } SCI_OutChar(BS); } character = SCI_InChar(); } *pt_op = character; return sign * number; }

부호 없는 정수를 출력하는 함수

• Unsigned short integer를 문자열로 변환 하여 표준 출력 장치로 출력 한다.
• 출력 되는 문자열은 1 - 5 자리 이다.
void SCI_OutUDec(unsigned short n){ if(n >= 10){ SCI_OutUDec(n / 10); // Recursive Operation n = n % 10; } SCI_OutChar(n + '0'); // n(0-9)을 문자('0' - '9')로 변환 한다. }

부호 있는 정수를 출력하는 함수

• Signed short integer를 문자열로 변환 하여 표준 출력 장치로 출력 한다.
• 출력 되는 문자열은 숫자 1 - 5 자리와 음수인 경우 - 부호가 포함 된다.
• 양수인 경우 + 부호는 출력 되지 않는다.
void SCI_OutSDec(short number){ if(number < 0){ number = -number; SCI_OutChar('-'); } SCI_OutUDec(number); }

16진 수를 입력 받는 함수

• 표준 입력 장치로 부터 Unsigned hexadecimal (base 16) format의 문자열을 입력 받아
• unsigned short integer로 변환 한다.
• 16진수 입력시 '$' 나 '0x' 는 사용 하지 않고 바로 1 자리에서 4 4자리 hex digits 만 입력 한다.
• 입력 받을 수 있는 최대 값은 FFFF 이고 이보다 큰 수는 Error 메세지 없이 Truncate 된다.
• Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 된다.
unsigned short SCI_InUHex(void){ unsigned short number = 0, digit, length = 0; unsigned char character; while((character = SCI_UpCase(SCI_InChar())) != CR){ // 잘못된 입력을 검출 하기 위하여 digit의 초기값을 0x0F(최대 입력 값) 보다 큰 값으로 설정 digit = 0x10; // '0' - '9' 사이 문자가 입력 되면 digit 값은 0 - 9 사이 수가 된다. if((character >= '0') && (character <= '9')){ digit = character - '0'; } // 'A' - 'F' 사이 문자가 입력 되면 digit 값은 10 - 15 사이 수가 된다. else if((character >= 'A') && (character <= 'F')){ digit = (character - 'A') + 0xA; } // 입력된 문자가 0-9 또는 A-F 사이 문자이면 2진수로 변환 되고, // 입력된 문자가 0-9 또는 A-F 사이 문자가 아니면 무시 한다. if(digit <= 0xF ){ number = number * 0x10 + digit; length++; SCI_OutChar(character); } // Backspace 문자가 입력 되면 바로 직전에 입력 받은 문자가 제거 한다. else if(character == BS && length){ number /= 0x10; length--; SCI_OutChar(character); } } return number; }

정수를 16진 수로 변환하여 출력하는 함수

• Unsigned short integer를 16진수 문자열로 변환 하여 표준 출력 장치로 출력 한다.
• 출력 되는 문자열은 1 - 4 자리 이다.
void SCI_OutUHex(unsigned short number){ if(number >= 0x10) { SCI_OutUHex(number / 0x10); SCI_OutUHex(number % 0x10); } else if(number < 0xA){ SCI_OutChar(number + '0'); } else{ SCI_OutChar((number - 0x0A) + 'A'); } }