NAME

       glShaderSource - Replaces the source code in a shader object

C SPECIFICATION

       void glShaderSource(GLuint shader, GLsizei count, const GLchar **string,
                           const GLint *length);

PARAMETERS

       shader
           Specifies the handle of the shader object whose source code is to be replaced.

       count
           Specifies the number of elements in the string and length arrays.

       string
           Specifies an array of pointers to strings containing the source code to be loaded into
           the shader.

       length
           Specifies an array of string lengths.

DESCRIPTION

       glShaderSource sets the source code in shader to the source code in the array of strings
       specified by string. Any source code previously stored in the shader object is completely
       replaced. The number of strings in the array is specified by count. If length is NULL,
       each string is assumed to be null terminated. If length is a value other than NULL, it
       points to an array containing a string length for each of the corresponding elements of
       string. Each element in the length array may contain the length of the corresponding
       string (the null character is not counted as part of the string length) or a value less
       than 0 to indicate that the string is null terminated. The source code strings are not
       scanned or parsed at this time; they are simply copied into the specified shader object.

NOTES

       OpenGL copies the shader source code strings when glShaderSource is called, so an
       application may free its copy of the source code strings immediately after the function
       returns.

ERRORS

       GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

       GL_INVALID_OPERATION is generated if shader is not a shader object.

       GL_INVALID_VALUE is generated if count is less than 0.

ASSOCIATED GETS

       glGetShader() with arguments shader and GL_SHADER_SOURCE_LENGTH

       glGetShaderSource() with argument shader

       glIsShader()

VERSION SUPPORT

       ┌───────────────┬───────────────────────────────────────────────────────────────────────┐
       │               │                OpenGL Version                                         │
       ├───────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
       │Function       │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
       │/              │     │     │     │     │     │     │     │     │     │     │     │     │
       │Feature        │     │     │     │     │     │     │     │     │     │     │     │     │
       │Name           │     │     │     │     │     │     │     │     │     │     │     │     │
       ├───────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │glShaderSource │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
       └───────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘

SEE ALSO

       glCompileShader(), glCreateShader(), glDeleteShader()

COPYRIGHT

       Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010-2014 Khronos Group. This material
       may be distributed subject to the terms and conditions set forth in the Open Publication
       License, v 1.0, 8 June 1999.  http://opencontent.org/openpub/.

COPYRIGHT

       Copyright © 2003-2005 3Dlabs Inc. Ltd.
       Copyright © 2010-2014 Khronos Group

[FIXME: source]                             01/03/2018                         GLSHADERSOURCE(3G)