conio 1.0 → 1.1.0

data/lib/conio.rb

@@ -1,14 +1,12 @@
 #!/usr/bin/env ruby
 
-# Library Console I/O for Ruby
-
 # *******************************************************
 # *                        Conio                        *
 # *******************************************************
 # *            Library Console I/O for Ruby             *
 # *******************************************************
 # * Title: Conio                                        *
-# * Version: 1.0                                        *
+# * Version: 1.1.0                                      *
 # * Language: Ruby                                      *
 # * Source: conio.rb                                    *
 # *******************************************************
@@ -20,560 +18,547 @@
 # *         Copyright (C) 2010 RAGNETTO Software        *
 # *******************************************************
 
+# Library Console I/O for Ruby 1.9
+
 # Require Dynamic Library [libconio.so]
 require "libconio"
 
-# Include Object Libconio
+# Initialize object Libconio
 include Libconio
 
-# ****************
-# * Conio Module *
-# ****************
-
+# Module Conio
 module Conio
-
-  # ******************
-  # * Conio Costants *
-  # ******************
-
+  
   # Costant Color Value
-  BLACK = 0
+  COLOR_BLACK = 0
   
   # Costant Color Value
-  BLUE = 1
+  COLOR_BLUE = 1
   
   # Costant Color Value
-  GREEN = 2
+  COLOR_GREEN = 2
   
   # Costant Color Value
-  CYAN = 3
+  COLOR_CYAN = 3
   
   # Costant Color Value
-  RED = 4
+  COLOR_RED = 4
   
   # Costant Color Value
-  MAGENTA = 5
+  COLOR_MAGENTA = 5
   
   # Costant Color Value
-  BROWN = 6
+  COLOR_BROWN = 6
   
   # Costant Color Value
-  LIGHTGRAY = 7
+  COLOR_LIGHTGRAY = 7
   
   # Costant Color Value
-  DARKGRAY = 8
+  COLOR_DARKGRAY = 8
   
   # Costant Color Value
-  LIGHTBLUE = 9
+  COLOR_LIGHTBLUE = 9
   
   # Costant Color Value
-  LIGHTGREEN = 10
+  COLOR_LIGHTGREEN = 10
   
   # Costant Color Value
-  LIGHTCYAN = 11
+  COLOR_LIGHTCYAN = 11
   
   # Costant Color Value
-  LIGHTRED = 12
+  COLOR_LIGHTRED = 12
   
   # Costant Color Value
-  LIGHTMAGENTA = 13
+  COLOR_LIGHTMAGENTA = 13
   
   # Costant Color Value
-  YELLOW = 14
+  COLOR_YELLOW = 14
   
   # Costant Color Value
-  WHITE = 15
+  COLOR_WHITE = 15
   
   # Costant Info Value
-  ATTR = 0
+  INFO_ATTR = 0
   
   # Costant Info Value
-  CX = 1
+  INFO_CX = 1
   
   # Costant Info Value
-  CY = 2
+  INFO_CY = 2
   
   # Costant Info Value
-  TOP = 3
+  INFO_TOP = 3
   
   # Costant Info Value
-  LEFT = 4
+  INFO_LEFT = 4
   
   # Costant Info Value
-  RIGHT = 5
+  INFO_RIGHT = 5
   
   # Costant Info Value
-  BOTTOM = 6
+  INFO_BOTTOM = 6
   
   # Costant Info Value
-  WIDTH = 7
+  INFO_WIDTH = 7
   
   # Costant Info Value
-  HEIGHT = 8
+  INFO_HEIGHT = 8
   
   # Costant Info Value
-  MAXWIDTH = 9
+  INFO_MAXWIDTH = 9
   
   # Costant Info Value
-  MAXHEIGHT = 10
+  INFO_MAXHEIGHT = 10
   
   # Costant Info Value
-  TOTALWIDTH = 11
+  INFO_TOTALWIDTH = 11
   
   # Costant Info Value
-  TOTALHEIGHT = 12
+  INFO_TOTALHEIGHT = 12
   
   # Costant Text Info Value
-  ATTRIBUTE = 0
+  TEXTINFO_ATTRIBUTE = 0
   
   # Costant Text Info Value
-  NORMATTR = 1
+  TEXTINFO_NORMATTR = 1
   
   # Costant Text Info Value
-  CURRMODE = 2
+  TEXTINFO_CURRMODE = 2
   
   # Costant Text Info Value
-  CURX = 3
+  TEXTINFO_CURX = 3
   
   # Costant Text Info Value
-  CURY = 4
+  TEXTINFO_CURY = 4
   
   # Costant Text Info Value
-  SCREENWIDTH = 5
+  TEXTINFO_SCREENWIDTH = 5
   
   # Costant Text Info Value
-  SCREENHEIGHT = 6
+  TEXTINFO_SCREENHEIGHT = 6
   
   # Costant Text Info Value
-  WINLEFT = 7
+  TEXTINFO_WINLEFT = 7
   
   # Costant Text Info Value
-  WINTOP = 8
+  TEXTINFO_WINTOP = 8
   
   # Costant Text Info Value
-  WINRIGHT = 9
+  TEXTINFO_WINRIGHT = 9
   
   # Costant Text Info Value
-  WINBOTTOM = 10
+  TEXTINFO_WINBOTTOM = 10
   
   # Costant Cursor Value
-  HIDE = 0
+  CURSOR_HIDE = 0
   
   # Costant Cursor Value
-  NORMAL = 25
+  CURSOR_NORMAL = 25
   
   # Costant Cursor Value
-  SOLID = 100
+  CURSOR_SOLID = 100
   
-  # ***************************
-  # * Conio Library Functions *
-  # ***************************
+  # Costant Key Value
+  KEY_F1 = 59
   
-  # Reads a string of characters from the console and stores the string, and the string length, in the location string.
-  def cgets(lenght)
-    # Ruby Function cgets()
-    value = Libconio.ruby_cgets(lenght)
-    
-    # Return value
-    return value
-  end
+  # Costant Key Value
+  KEY_F2 = 60
   
-  # Clears all characters from the cursor position to the end of the line within the string length, in the location string.
-  def clreol()
-    # Ruby Function clreol()
-    Libconio.ruby_clreol()
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F3 = 61
   
-  # Clears the current text window and places the cursor in the upper left hand corner.
-  def clrscr()
-    # Ruby Function clrscr()
-    Libconio.ruby_clrscr()
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F4 = 62
   
-  # Writes the null-terminated string text to the current text window. It does not append a newline character.
-  def cputs(text)
-    # Ruby Function cputs()
-    value = Libconio.ruby_cputs(text)
-    
-    # Return text value
-    return value
-  end
+  # Costant Key Value
+  KEY_F5 = 63
   
-  # Crop the window console buffer size.
-  def crop()
-    # Ruby Function crop()
-    Libconio.ruby_crop()
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F6 = 64
   
-  # The time interval for which execution is to be suspended, in milliseconds.
-  def delay(milliseconds)
-    # Ruby Function delay()
-    Libconio.ruby_delay(milliseconds)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F7 = 65
   
-  # Deletes the line containing the cursor and moves all lines below it a line up.
-  def delline()
-    # Ruby Function delline()
-    Libconio.ruby_delline()
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F8 = 66
   
-  # Write the specified number of consecutive characters, beginning at X and Y coordinates, with the value specified attribute.
-  def fill(character,forecolor, backcolor, number, x, y)
-    # Ruby Function fill()
-    Libconio.ruby_fill(character, forecolor, backcolor, number, x, y)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F9 = 67
   
-  # Fills the specified number of consecutive attributes, beginning at X and Y coordinates, with the value specified attribute.
-  def fillattr(forecolor, backcolor, number, x, y)
-    # Ruby Function fillattr()
-    Libconio.ruby_fillattr(forecolor, backcolor, number, x, y)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F10 = 68
   
-  # Write the specified number of consecutive characters, beginning at X and Y coordinates.
-  def fillchar(character, number, x, y)
-    # Ruby Function fillchar()
-    Libconio.ruby_fillchar(character, number, x, y)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F11 = 133
   
-  # Write the specified number of consecutive characters, beginning at X and Y coordinates.
-  def fillcr(character, number, x, y)
-    # Ruby Function fillcr()
-    Libconio.ruby_fillcr(character, number, x, y)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_F12 = 134
   
-  # Get the contents with attributes of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def get(left, top, right, bottom, buffer)
-    # Ruby Function get()
-    Libconio.ruby_get(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_SHIFT_F1 = 84
   
-  # Get the attributes of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def getattrs(left, top, right, bottom, buffer)
-    # Ruby Function getattrs()
-    Libconio.ruby_getattrs(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_SHIFT_F2 = 85
   
-  # Reads a single character directly from the keyboard, without echoing to the screen.
-  def getch()
-    # Ruby Function getch()
-    value = Libconio.ruby_getch()
-    
-    # Return character value
-    return value
-  end
+  # Costant Key Value
+  KEY_SHIFT_F3 = 86
   
-  # Get the contents of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def getchars(left, top, right, bottom, buffer)
-    # Ruby Function getchars()
-    Libconio.ruby_getchars(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_SHIFT_F4 = 87
   
-  # Reads a single character from the keyboard and echoes it to the current text windows.
-  def getche()
-    # Ruby Function getche()
-    value = Libconio.ruby_getche()
-    
-    # Return value
-    return value
-  end
+  # Costant Key Value
+  KEY_SHIFT_F5 = 88
   
-  # Gets video information.
-  def getinfo()
-    # Ruby Function getinfo()
-    value = Libconio.ruby_getinfo()
-    
-    # Return value
-    return value
-  end
+  # Costant Key Value
+  KEY_SHIFT_F6 = 89
   
-  # Get the text of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def gettext(left, top, right, bottom, buffer)
-    # Ruby Function gettext()
-    Libconio.ruby_gettext(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_SHIFT_F7 = 90
   
-  # Gets text mode video information.
-  def gettextinfo()
-    # Ruby Function gettextinfo()
-    value = Libconio.ruby_gettextinfo()
+  # Costant Key Value
+  KEY_SHIFT_F8 = 91
   
-    # Return value
-    return value
-  end
+  # Costant Key Value
+  KEY_SHIFT_F9 = 92
   
-  # Moves the cursor to the given position in the current text window.
-  def gotoxy(x, y)
-    # Ruby Function gotoxy()
-    Libconio.ruby_gotoxy(x, y)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_SHIFT_F10 = 93
   
-  # Inserts an empty line in the text window at the cursor position using the current text background color.
-  def insline()
-    # Ruby Function insline()
-    Libconio.ruby_insline()
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_SHIFT_F11 = 135
   
-  # Checks to see if a keystroke is currently available.
-  def kbhit()
-    # Ruby Function kbhit()
-    value = Libconio.ruby_kbhit()
-    
-    # Return value
-    return value
-  end
+  # Costant Key Value
+  KEY_SHIFT_F12 = 136
   
-  # Copies the contents of the onscreen rectangle defined by left, top, right, and bottom to a new rectangle of the same dimensions.
-  def movetext(left, top, right, bottom, newleft, newtop)
-    # Ruby Function movetext()
-    Libconio.ruby_movetext(left, top, right, bottom, newleft, newtop)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F1 = 94
   
-  # Put the contents with attributes of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def put(left, top, right, bottom, buffer)
-    # Ruby Function put()
-    Libconio.ruby_put(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F2 = 95
   
-  # Put the attributes of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def putattrs(left, top, right, bottom, buffer)
-    # Ruby Function putattrs()
-    Libconio.ruby_putattrs(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F3 = 96
   
-  # Outputs the character to the current text window. It is a text-mode function that performs direct video output to the console.
-  def putch(character)
-    # Ruby Function putch()
-    value = Libconio.ruby_putch(character)
-    
-    # Return value
-    return value
-  end
+  # Costant Key Value
+  KEY_CTRL_F4 = 97
   
-  # Put the contents of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def putchars(left, top, right, bottom, buffer)
-    # Ruby Function putchars()
-    Libconio.ruby_putchars(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F5 = 98
   
-  # Put the text of the memory area source out to the onscreen rectangle defined by left, top, right and bottom.
-  def puttext(left, top, right, bottom, buffer)
-    # Ruby Function puttext()
-    Libconio.ruby_puttext(left, top, right, bottom, buffer)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F6 = 99
   
-  # Resize buffer and window size.
-  def resize(width, height)
-    # Ruby Function resize()
-    Libconio.ruby_resize(width, height)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F7 = 100
   
-  # The console window displays a portion of the active screen buffer.
-  def scroll(left, top, right, bottom, newleft, newtop)
-    # Ruby Function scroll()
-    Libconio.ruby_scroll(left, top, right, bottom, newleft, newtop)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F8 = 101
   
-  # Scroll up the text in current window text.
-  def scrollup(left, top, right, bottom)
-    # Ruby Function scrollup()
-    Libconio.ruby_scrollup(left, top, right, bottom)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F9 = 102
   
-  # Scroll down the text in current window text.
-  def scrolldown(left, top, right, bottom)
-    # Ruby Function scrolldown()
-    Libconio.ruby_scrolldown(left, top, right, bottom)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F10 = 103
   
-  # Scroll left the text in current window text.
-  def scrollleft(left, top, right, bottom)
-    # Ruby Function scrollleft()
-    Libconio.ruby_scrollleft(left, top, right, bottom)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F11 = 137
   
-  # Scroll right the text in current window text.
-  def scrollright(left, top, right, bottom)
-    # Ruby Function scrollright()
-    Libconio.ruby_scrollright(left, top, right, bottom)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_CTRL_F12 = 138
+
+  # Costant Key Value
+  KEY_ALT_F1 = 104
   
-  # Define a window buffer size.
-  def setbuffer(width, height)
-    # Ruby Function setbuffer()
-    Libconio.ruby_setbuffer(width, height)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_ALT_F2 = 105
   
-  # Sets the cursor type in range 0 (hide cursor) to 100 (solid block cursor).
-  def setcursortype(cursor)
-    # Ruby Function setcursortype()
-    Libconio.ruby_setcursortype(cursor)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_ALT_F3 = 106
   
-  # Change the console window title.
-  def settitle(title)
-    # Ruby Function settitle()
-    Libconio.ruby_settitle(title)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_ALT_F4 = 107
   
-  # Defines a text window onscreen. If the coordinates are in any way invalid, the call to window is ignored.
-  def setwindow(left, top, right, bottom)
-    # Ruby Function setwindow()
-    Libconio.ruby_setwindow(left, top, right, bottom)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_ALT_F5 = 108
   
-  # The time interval for which execution is to be suspended, in seconds.
-  def sleep(seconds)
-    # Ruby Function sleep()
-    Libconio.ruby_sleep(seconds)
-    
-    # Return nil
-    return nil
-  end
+  # Costant Key Value
+  KEY_ALT_F6 = 109
+  
+  # Costant Key Value
+  KEY_ALT_F7 = 110
+  
+  # Costant Key Value
+  KEY_ALT_F8 = 111
+  
+  # Costant Key Value
+  KEY_ALT_F9 = 112
+  
+  # Costant Key Value
+  KEY_ALT_F10 = 113
+  
+  # Costant Key Value
+  KEY_ALT_F11 = 139
+  
+  # Costant Key Value
+  KEY_ALT_F12 = 140
+  
+  # Costant Key Value
+  KEY_INS = 82
+  
+  # Costant Key Value
+  KEY_DEL = 83
+  
+  # Costant Key Value
+  KEY_STAMP = 71
+  
+  # Costant Key Value
+  KEY_END = 79
+  
+  # Costant Key Value
+  KEY_UP = 72
+  
+  # Costant Key Value
+  KEY_DOWN = 80
+  
+  # Costant Key Value
+  KEY_LEFT = 75
   
-  # Selects the background character color.
-  def textbackground(color)
-    # Ruby Function textbackground()
-    Libconio.ruby_textbackground(color)
+  # Costant Key Value
+  KEY_RIGHT = 77
+  
+  # Costant Key Value
+  KEY_PAGEUP = 73
+  
+  # Costant Key Value
+  KEY_PAGDOWN = 81
+  
+  # Costant Key Value
+  KEY_CTRL_INS = 146
+  
+  # Costant Key Value
+  KEY_CTRL_DEL = 147
+  
+  # Costant Key Value
+  KEY_CTRL_STAMP = 119
+  
+  # Costant Key Value
+  KEY_CTRL_END = 117
+  
+  # Costant Key Value
+  KEY_CTRL_UP = 141
+  
+  # Costant Key Value
+  KEY_CTRL_DOWN = 145
+  
+  # Costant Key Value
+  KEY_CTRL_LEFT = 115
+  
+  # Costant Key Value
+  KEY_CTRL_RIGHT = 116
+  
+  # Costant Key Value
+  KEY_CTRL_PAGEUP = 134
+  
+  # Costant Key Value
+  KEY_CTRL_PAGDOWN = 118
+  
+  # Costant Key Value
+  KEY_ALT_INS = 162
+  
+  # Costant Key Value
+  KEY_ALT_DEL = 163
+  
+  # Costant Key Value
+  KEY_ALT_STAMP = 151
+  
+  # Costant Key Value
+  KEY_ALT_END = 159
+  
+  # Costant Key Value
+  KEY_ALT_UP = 152
+  
+  # Costant Key Value
+  KEY_ALT_DOWN = 160
+  
+  # Costant Key Value
+  KEY_ALT_LEFT = 155
+  
+  # Costant Key Value
+  KEY_ALT_RIGHT = 157
+  
+  # Costant Key Value
+  KEY_ALT_PAGEUP = 153
+  
+  # Costant Key Value
+  KEY_ALT_PAGDOWN = 161
+  
+  # :call-seq:
+  #   beep()  -> nil
+  #
+  # Execute bells sound in time interval.
+  def self.beep(number, milliseconds)
+    # Variable service
+    index = 0
+    
+    # Verify equal value of index and number
+    while index != number do
+      # Put character sound
+      putch(7)
+        
+      # Put time interval
+      delay(milliseconds)
+      
+      # Increment index value by one
+      index = index + 1
+    end
     
-    # Return nil
+    # Return nil value
     return nil
   end
+
+  # :call-seq:
+  #   cgets(length)  -> string
+  #
+  # Reads a string of characters from the console and stores the 
+  # string, and the string length, in the location string.
+  def self.cgets(length)
+    # Declare variable text
+    text = gets()
+
+    # Set text value
+    text = text[0, length]
+
+    # Return text value
+    return text
+  end
   
-  # Selects the foreground character color.
-  def textcolor(color)
-    # Ruby Function textcolor()
-    Libconio.ruby_textcolor(color)
-    
-    # Return nil
-    return nil
+  # :call-seq:
+  #   getkey()  -> number
+  #
+  # Reads a double character directly from the keyboard for special key.
+  def self.getkey()
+    # Conio function getch()
+    character = getch()
+
+    # Verify key pressed
+    while character != 0 and character != 224
+      # Conio function getch()
+      character = getch()
+    end
+
+    # Conio function getch()
+    character = getch()
+
+    # Return value character
+    return character
   end
   
-  # Pushes the character ch back to the console, causing ch to be the next character read.
-  def ungetch(character)
-    # Ruby Function ungetch()
-    value = Libconio.ruby_ungetch(character)
+  # :call-seq:
+  #   getlimit(length)  -> string
+  #
+  # Puts a string of characters and limit the string length in the location string.
+  def self.getlimit(length)
+    # Declare and initalize variable text
+    text = ""
+    
+    # Conio function getch()
+    character = getch()
+
+    # Verify character code
+    while character != 13 do
+      # Verify character code
+      while character == 0 or character == 224
+        # Conio function getch()
+        character = getch()
+        character = getch()
+      end
+        
+      # Declare and initalize variable dimension
+      dimension = text.length
+        
+      # Verify character code value and variable dimension
+      if character == 8 and dimension > 0 then
+        # Conio function putch()
+        putch(8)
+        putch(32)
+        putch(8)
+            
+        # Set text value
+        text = text[0, dimension - 1]
+      elsif character == 13 then
+        # Exit from cicle while
+        break 
+      # Verify character code value and variable dimension
+      elsif character != 8 and character != 9 and character != 27 and dimension < length then
+        # Enable only characters alphanumeric
+        if character > 47 and character < 58 or character > 64 and character < 91 or character > 96 and character < 123 or character == 32 then
+          # Conio function putch()
+          putch(character)
+          
+          # Set format for character code
+          character = character.chr
+            
+          # Set variable texe
+          text = text + character
+        end  
+      else
+        # Nil 
+      end
+        
+      # Conio function getch()
+      character = getch()
+    end
     
-    # Return value
-    return value
+    # Return text value
+    return text
   end
   
-  # Returns the X coordinate of the current cursor position (within the current text window).
-  def wherex()
-    # Ruby Function wherex()
-    value = Libconio.ruby_wherex()
+  # :call-seq:
+  #   version()  -> nil
+  #
+  # Puts the current version of Ruby Conio in text window.
+  def self.version()
+    # Put Ruby Conio version
+    cputs("Ruby Conio 1.1.0")
     
-    # Return value
-    return value
+    # Return nil value
+    return nil
   end
   
-  # Copies the value of x coordinate and y coordinate of the cursor location to the variables whose address is specified in the arguments column and row.
-  def wherexy(x, y)
-    # Ruby Function wherex()
-    Libconio.ruby_wherexy(x, y)
+  # :call-seq:
+  #   wherexy(x, y)  -> boolean
+  #
+  # Verify if x and y are equals to current cursor position.
+  def self.wherexy(x, y)
+    # Declare and initialize variables cursorx and cursory
+    cursorx = wherex()
+    cursory = wherey()
     
-    # Return nil
-    return nil
+    # Verify cursor position
+    if x == cursorx and y == cursory then
+      # Return value true
+      return true
+    else
+      # Return value false
+      return false  
+    end
   end
   
-  # Returns the Y coordinate of the current cursor position (within the current text window).
-  def wherey()
-    # Ruby Function wherey()
-    value = Libconio.ruby_wherey()
+  # :call-seq:
+  #   write(text, x, y)  -> string
+  #
+  # Writes the null-terminated string text to the current text window and positioning in the coordinates x and y.
+  def self.write(text, x, y)
+    # Set cursor position
+    gotoxy(x, y)
+    
+    # Print text
+    cputs(text)
     
-    # Return value
-    return value
+    # Return text value
+    return text
   end
-
 end
 
+
 # End of file